Generate Videos and Manage Assets
Generate videos with Kling v4 and Seedance models, and reference authorized assets.
Submit video generation tasks and manage authorized media assets through native video endpoints.
POST
/v1/videosRequest Body
| Field | Type | Required | Description |
|---|---|---|---|
prompt | string | Yes | Text description of the desired video scene and motion. |
model | string | No | Video model identifier, such as kling-v4 or doubao-seedance-2-0-260128. |
duration_seconds | number | No | Video duration in seconds (positive number up to 300, or alias duration). |
| Additional fields | object | No | Video parameters such as resolution, aspect_ratio, first_frame_url, and last_frame_url pass through intact. |
Seedance Authorized Assets
POST
/v1/seedance/assetsGET
/v1/seedance/assets/{asset_id}- Asset registration: Send
POST /v1/seedance/assets(operationId: seedance_assets.create) with JSON containing requiredsourceUrlandassetType(imageorvideo), and optionaldisplayName. - URI references: Reference registered media directly using
asset://{asset_id}in frame URLs or parameters. - Tenant isolation: Assets are isolated to the tenant's current asset library and verified against upstream stores.
Task Status and Download
GET
/v1/videos/{task_id}- Status polling: Query task status via
GET /v1/videos/{task_id}(operationId: legacy_media.video.get), supporting statusesqueued,submitting,submitted,running,ingesting_artifacts,cancel_requested,completed,failed, andcancelled. - Artifact download: Download completed video files via
GET /v1/videos/{task_id}/content. - Kling v4 support: Supports text-to-video, first-frame image-to-video, and last-frame transitions.
Compatibility Aliases
- Legacy media alias:
POST /openai/v1/videosis a legacy alias ofPOST /v1/videos(legacy_media.video.create.alias), sharing the same request format. - Legacy generation task route:
POST /v1/videos/generationsacceptsCreateVideoGenerationRequestpayloads. - Unified async pipeline:
POST /v1/async-tasks/video-generationsprovides the standard async task contract.