v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01600974.4 KB
Avatar Videos

Generate avatar video from audio or text

Start an asynchronous task to generate a video of an avatar speaking. Provide speech with type: "audio" (audio file) or type: "text" (text script for TTS). Poll GET /v1/tasks/:id to check progress and retrieve the output video URL once complete.

post/v1/avatar_videos

Headers

X-Runway-Version'2024-11-06' required

The version of the RunwayML API being used. You can read more about versioning here.

Request body

model'gwm1_avatars' required

The model to use for avatar video generation.

Example request

{
  "speech": {
    "audio": "https://example.com/audio.mp3"
  }
}

Response

Success

idstring uuid required

The ID of the avatar video task. Use GET /v1/tasks/:id to poll for status and output.