Seedance 原生 API

支持火山方舟 Ark 的异步视频任务协议，无需把 content[] 转换成 OpenAI messages 或 Grok prompt。

配置

创建 OpenAI 平台的 API Key 账号，填写 Ark API Key，Base URL 使用 https://ark.cn-beijing.volces.com/api/v3。兼容服务可填写自己的 /api/v3 或 /v3 Base URL。
在账号的端点能力中勾选 Seedance (Ark)。默认不启用，避免请求误调度到其他 OpenAI 账号。支持创建、编辑与批量编辑。
将账号加入 OpenAI 分组并启用分组的「允许图片生成」媒体权限；合成分组也可路由到这些账号。
配置模型映射，例如将公开模型名 seedance-video 映射到实际 doubao-seedance-* 模型或 ep-* 推理接入点。配置对应模型的输出 token 价格；本接口不使用 Grok 的按秒视频价格。

调用

curl "$SUB2API_BASE_URL/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer $SUB2API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "seedance-video",
    "content": [{"type": "text", "text": "海浪轻轻拍打沙滩"}],
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": true
  }'

# 使用创建响应中的原生 id 查询，直至 succeeded / failed / cancelled 等终态。
curl "$SUB2API_BASE_URL/api/v3/contents/generations/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SUB2API_KEY"

curl -X DELETE "$SUB2API_BASE_URL/api/v3/contents/generations/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SUB2API_KEY"

亦支持 /v3、/v1 和无版本前缀别名。Ark SDK 的 Base URL 可改为 $SUB2API_BASE_URL/api/v3。文本、图片、视频、音频内容、角色及扩展参数原样传递，仅按账号配置改写模型名；响应保持上游原生格式。

任务与计费

查询和删除只能访问同一用户、同一 API Key、同一分组创建的任务，并始终使用原提交账号；不会转到其他账号查询。
创建时不扣 token 用量。首次查询到 succeeded 后，根据上游 usage.completion_tokens 计费；重复查询由共享缓存声明和持久化用量去重共同保护。失败、排队及运行中的任务不计费。
Redis 保存任务绑定及创建时的模型快照，默认 24 小时。需保留 Redis 状态并在有效期内查询完成结果。当前不会后台轮询；只使用回调而不查询的任务不会自动结算。
不开放上游的任务列表接口，防止共享账号的任务泄露给其他用户。删除遵循上游语义，不自动退款。
异步创建的上游错误不自动重试，以免重复创建付费任务。

协议依据：火山官方 Go SDK、创建任务文档、查询任务文档。

2.9 KiB Raw Permalink Blame History Unescape Escape

Seedance 原生 API

配置

调用

任务与计费

2.9 KiB

Raw Permalink Blame History