提交视频生成任务

POST

/v1/videos

统一异步提交，无需 async。HTTP 200 返回平台 id 后，使用查询接口查看结果。

本期可直接采用的字段组合： Seedance 兼容渠道使用 duration + resolution + aspect_ratio。OpenAI 风格的 seconds + size 仅在服务方明确该模型/渠道支持时使用。平台不替客户转换这两组请求字段，也不要同时传两个时长或分辨率字段。

请显式传入时长和分辨率。图片/视频/音频参考素材为可选能力，必须确认模型开放且对应价格项已配置。下面“参考视频”示例是字段格式，不代表所有渠道都支持。

可复制示例（本期 Seedance 兼容渠道）

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json必填

示例

Seedance 兼容渠道：文生视频（720p / 4 秒）兼容渠道：参考视频（需开放对应能力及价格项）兼容渠道首尾帧输入（须确认渠道支持）

{
    "model": "dreamina-seedance-2.5",
    "prompt": "A quiet lake at sunrise, gentle ripples, static camera.",
    "duration": 4,
    "resolution": "720p",
    "aspect_ratio": "16:9"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL（JSON，含鉴权）

Seedance 兼容渠道：文生视频（720p / 4 秒）兼容渠道：参考视频（需开放对应能力及价格项）兼容渠道首尾帧输入（须确认渠道支持）

BASE_URL=https://api.starcore.cloud
API_KEY='<YOUR_API_KEY>'
curl --fail-with-body --request POST "$BASE_URL/v1/videos" \
  --header "Authorization: Bearer $API_KEY" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data-raw '{
  "model": "dreamina-seedance-2.5",
  "prompt": "A quiet lake at sunrise, gentle ripples, static camera.",
  "duration": 4,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}'

返回响应

🟢200

application/json

任务已受理

Bodyapplication/json

示例

{
    "id": "task_example_01",
    "object": "video",
    "model": "dreamina-seedance-2.5",
    "status": "queued",
    "progress": 0,
    "created_at": 1792454400
}

🟠400

🟠401

🟠403

🟠404

🟠429

🔴502

🔴503

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

查询图片编辑任务

查询视频生成任务

提交视频生成任务

可复制示例（本期 Seedance 兼容渠道）#

请求参数

请求示例代码

返回响应

可复制示例（本期 Seedance 兼容渠道）