Submit a video generation task (OpenAI Video alias)

POST

/v1/videos

Alias of POST /v1/video/generations, provided for clients that follow the
OpenAI Video API path layout. Request and response bodies are identical.

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

Authorization: ********************

Body 参数

application/json

必填

示例

{
    "model": "doubao-seedance-2-5-260628",
    "prompt": "An astronaut walks slowly across the lunar surface",
    "image": "https://example.com/reference-image.jpg",
    "seconds": "-1",
    "metadata": {
        "ratio": "16:9",
        "resolution": "480p",
        "seed": 42,
        "watermark": false,
        "camera_fixed": false,
        "content": [
            {
                "type": "text",
                "text": "The astronaut stands up and looks back at Earth",
                "image_url": {
                    "url": "https://example.com/reference-photo.jpg"
                },
                "video_url": {
                    "url": "https://example.com/input-video-clip.mp4"
                },
                "audio_url": {
                    "url": "https://example.com/background-music.mp3"
                },
                "role": "first_frame"
            }
        ],
        "return_last_frame": false,
        "generate_audio": false,
        "draft": false,
        "omni_reference_task_type": "reference",
        "output_format": "mp4",
        "service_tier": "default",
        "callback_url": "https://your-server.com/webhook/video-callback"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/videos' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "doubao-seedance-2-5-260628",
    "prompt": "An astronaut walks slowly across the lunar surface",
    "image": "https://example.com/reference-image.jpg",
    "seconds": "-1",
    "metadata": {
        "ratio": "16:9",
        "resolution": "480p",
        "seed": 42,
        "watermark": false,
        "camera_fixed": false,
        "content": [
            {
                "type": "text",
                "text": "The astronaut stands up and looks back at Earth",
                "image_url": {
                    "url": "https://example.com/reference-photo.jpg"
                },
                "video_url": {
                    "url": "https://example.com/input-video-clip.mp4"
                },
                "audio_url": {
                    "url": "https://example.com/background-music.mp3"
                },
                "role": "first_frame"
            }
        ],
        "return_last_frame": false,
        "generate_audio": false,
        "draft": false,
        "omni_reference_task_type": "reference",
        "output_format": "mp4",
        "service_tier": "default",
        "callback_url": "https://your-server.com/webhook/video-callback"
    }
}'

返回响应

🟢200

application/json

Task accepted.

Bodyapplication/json

示例

{
    "id": "task_abc123def456",
    "task_id": "task_abc123def456",
    "object": "video",
    "model": "doubao-seedance-2-0-260128",
    "status": "queued",
    "progress": 100,
    "created_at": 1712345678,
    "completed_at": 1712345900,
    "expires_at": 1712432300,
    "metadata": {
        "url": "https://cdn.volcengineapi.com/videos/output-abc123.mp4"
    },
    "error": {
        "code": "content_policy_violation",
        "message": "The request violated the content safety policy."
    },
    "remixed_from_video_id": "task_origin789ghi012"
}

🟠400BadRequest

🟠401Unauthorized

🟠402InsufficientQuota

修改于 2026-10-27 14:29:06

Retrieve a video generation task

Retrieve a video generation task (OpenAI Video alias)