Seedance 原生接口

OhMyToken 提供 Seedance v3 风格的异步任务接口。创建和查询均使用公开任务 ID，鉴权、分组路由、额度预留、最终结算和日志记录由网关统一处理。

兼容路径 /v1/video/tasks 提供相同的请求和响应能力；本文示例继续使用原有的 /api/v3/contents/generations/tasks。两种路径创建的任务都应使用与创建时相同的路径查询。

创建任务

POST https://ohmytoken.cn/api/v3/contents/generations/tasks

文生视频

curl --request POST 'https://ohmytoken.cn/api/v3/contents/generations/tasks' \
  --header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-2.0",
    "content": [
      {
        "type": "text",
        "text": "一只橘猫在阳光明媚的花园里奔跑，电影感镜头，柔和光线，高质量"
      }
    ],
    "duration": 5,
    "ratio": "16:9",
    "resolution": "480p"
  }'

创建成功后返回任务 ID，例如：

{
  "id": "task_example_id"
}

保存返回的 id。生成视频是异步操作，创建成功不代表视频已经完成。

图生视频

在 content 中增加一个 image_url 项。图片必须能由上游通过公网 HTTP 或 HTTPS 访问：

curl --request POST 'https://ohmytoken.cn/api/v3/contents/generations/tasks' \
  --header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-2.0",
    "content": [
      {
        "type": "text",
        "text": "让画面中的人物自然转头看向镜头，镜头缓慢推进"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://example.com/reference.webp"
        }
      }
    ],
    "duration": 5,
    "ratio": "16:9",
    "resolution": "480p"
  }'

查询任务

GET https://ohmytoken.cn/api/v3/contents/generations/tasks/{TASK_ID}

curl --request GET \
  "https://ohmytoken.cn/api/v3/contents/generations/tasks/TASK_ID" \
  --header "Authorization: Bearer ${OHMYTOKEN_API_KEY}"

任务成功时，响应中的 status 为 succeeded，视频地址位于 content.video_url：

{
  "id": "task_example_id",
  "model": "doubao-seedance-2.0",
  "status": "succeeded",
  "content": {
    "video_url": "https://example.com/generated-video.mp4"
  },
  "duration": 5,
  "resolution": "480p",
  "ratio": "16:9"
}

失败时 status 为 failed，错误原因位于 error.code 和 error.message。建议每 4 至 10 秒查询一次，不要高频轮询。

请求参数

字段	类型	必填	说明
`model`	string	是	使用模型列表中的完整名称
`content`	array	是	至少包含一条文本或媒体内容
`duration`	integer	否	视频秒数，需为正整数
`ratio`	string	否	例如 `16:9`、`9:16`、`1:1`
`resolution`	string	否	`480p`、`720p` 或 `1080p`
`frames`	integer	否	帧数；与时长同时提供时会影响预扣估算
`seed`	integer	否	随机种子
`camera_fixed`	boolean	否	是否固定相机
`watermark`	boolean	否	是否添加水印
`return_last_frame`	boolean	否	是否返回末帧

当前代理不接受非空 callback_url、非空 tools 或 draft: true。generate_audio 会透传给支持该能力的渠道；service_tier 仅在对应渠道允许时可用。请求体上限为 4 MB，JSON 中不能使用重复键或未支持的字段。

计费说明

提交任务时会按照模型价格、分组倍率、时长、分辨率和画幅预留额度。任务完成后以上游返回的实际用量结算，多余预留会退回；失败任务按照系统现行计费规则处理。账单与任务记录可在控制台日志中查看。