提交视频生成任务

POST

/api/v3/contents/generations/tasks

使用 JSON 提交，返回平台任务 id，随后调用查询接口。无需传 async。

素材规则： content 中放文本及素材对象。首帧用 role=first_frame，首尾帧使用两个 image_url 对象分别指定 first_frame/last_frame。全能参考图/视频/音频使用 reference_image/reference_video/reference_audio，不要和首尾帧模式混用。URL 必须能由上游访问；示例素材地址需要替换为实际文件。

只传本模型支持的字段。不要把旧协议的 prompt、size、aspect_ratio 当成本接口的对应字段；本接口使用 content、resolution、ratio。

可复制示例

首尾帧完整请求见示例 firstAndLastFrames。return_last_frame 为可选：需要从结果中拿到最后一帧图片时设置 true。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json必填

示例

文生视频（720p / 4 秒）首帧图生视频（需渠道支持）参考视频生成（需开放该价格项）首尾帧图生视频，并返回生成结果最后一帧

{
    "model": "dreamina-seedance-2.5",
    "content": [
        {
            "type": "text",
            "text": "A quiet lake at sunrise, gentle ripples, static camera."
        }
    ],
    "duration": 4,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": true,
    "watermark": false
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL（JSON，含鉴权）

文生视频（720p / 4 秒）首帧图生视频（需渠道支持）参考视频生成（需开放该价格项）首尾帧图生视频，并返回生成结果最后一帧

BASE_URL=https://api.starcore.cloud
API_KEY='<YOUR_API_KEY>'
curl --fail-with-body --request POST "$BASE_URL/api/v3/contents/generations/tasks" \
  --header "Authorization: Bearer $API_KEY" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data-raw '{
  "model": "dreamina-seedance-2.5",
  "content": [
    {
      "type": "text",
      "text": "A quiet lake at sunrise, gentle ripples, static camera."
    }
  ],
  "duration": 4,
  "resolution": "720p",
  "ratio": "16:9",
  "generate_audio": true,
  "watermark": false
}'

返回响应

🟢200

application/json

任务已受理

Bodyapplication/json

示例

{
    "id": "task_example_01"
}

🟠400

🟠401

🟠403

🟠404

🟠429

🔴502

🔴503

修改于 2026-10-20 11:59:42

查询视频生成任务

提交视频生成任务

可复制示例#

请求参数

请求示例代码

返回响应

可复制示例