Skip to main content
本页只覆盖 国内版 Doubao Seedance 2.0。海外 BytePlus Dreamina Seedance 2.0 使用独立模型、独立价格和独立素材能力，见 BytePlus Dreamina Seedance 2.0。 kapon 对外提供火山方舟原生任务接口兼容。任务创建、查询和素材库请求字段尽可能保持官方原生形态；任务列表、取消/删除、素材库访问会限制在当前 kapon 租户可见范围内。

​
1. 前置条件

export BASE_URL="https://models.kapon.cloud"
export TOKEN="oh-xxxxxxxxxxxxxxxx"
统一请求头： 
Authorization: Bearer <TOKEN>
Content-Type: application/json
调用方只需要使用 kapon 发放的 API Token。火山方舟 API Key、AK/SK、ProjectName 和 Endpoint 由平台渠道配置托管。

​
2. 模型

对外模型官方版本别名说明
doubao-seedance-2-0doubao-seedance-2-0-260128国内标准模型，支持 480p / 720p / 1080p
doubao-seedance-2-0-fastdoubao-seedance-2-0-fast-260128国内快速模型，支持 480p / 720p
请求中的 model 建议使用左侧稳定模型名。平台也接受右侧官方版本别名，并按标准模型或 fast 模型归一计费。 seedance-2-0、seedance-2-0-260128、seedance-2-0-fast、seedance-2-0-fast-260128 不作为对外 API model 参数兼容。国内版也不提供 filter-off 派生模型名。 查询和列表响应中的 model 回显创建请求中的 kapon 对外模型，避免向调用方暴露内部 endpoint、计费 SKU 或内部映射名。 如需锁定官方具体模型版本，请联系平台配置官方版本映射，例如 doubao-seedance-2-0 -> doubao-seedance-2-0-260128。

​
3. 国内价格

国内版默认价按官方人民币 tokens 单价配置，并按平台美元汇率换算为 kapon Rate。
SKU官方价格
doubao-seedance-2-0-480p-novideo¥46/M tokens
doubao-seedance-2-0-480p-video¥28/M tokens
doubao-seedance-2-0-720p-novideo¥46/M tokens
doubao-seedance-2-0-720p-video¥28/M tokens
doubao-seedance-2-0-1080p-novideo¥51/M tokens
doubao-seedance-2-0-1080p-video¥31/M tokens
doubao-seedance-2-0-fast-novideo¥37/M tokens
doubao-seedance-2-0-fast-video¥22/M tokens
video 表示请求包含视频参考输入；novideo 表示不包含视频参考输入。平台只对成功出片任务结算，失败任务不会按成功出片计费。

​
4. 任务接口

功能路径
创建任务POST /volcark/api/v3/contents/generations/tasks
查询任务GET /volcark/api/v3/contents/generations/tasks/{task_id}
查询租户任务列表GET /volcark/api/v3/contents/generations/tasks
取消或删除任务DELETE /volcark/api/v3/contents/generations/tasks/{task_id}
国内版主接入口径是火山方舟原生 task API。/v1/videos 仅作为历史兼容路径，不作为本模型主文档路径。

​
5. 创建任务

curl -X POST "https://models.kapon.cloud/volcark/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0",
    "content": [
      {
        "type": "text",
        "text": "一艘纸船漂浮在清晨平静的水面上，电影感镜头，柔和自然光。"
      }
    ],
    "duration": 4,
    "ratio": "16:9",
    "resolution": "720p",
    "generate_audio": false,
    "watermark": true,
    "return_last_frame": true,
    "execution_expires_after": 3600,
    "priority": 0,
    "safety_identifier": "user-hash-001",
    "callback_url": "https://example.com/volcark/callback"
  }'
典型响应： 
{
  "id": "cgt-20260611204121-462cw"
}
常用字段：
字段说明
content[]官方多模态输入数组，至少包含 prompt 文本或参考素材
duration视频时长，按官方模型能力校验
ratioadaptive、16:9、9:16、1:1、4:3、3:4、21:9
resolution480p、720p、1080p；fast 模型不支持 1080p
generate_audio是否生成音频
watermark是否保留水印
return_last_frame成功任务中返回 content.last_frame_url
execution_expires_after任务执行过期时间
priority队列优先级 0-9
safety_identifier终端用户稳定标识，建议传哈希后的用户 ID
callback_url火山方舟原生任务状态回调地址，必须是非空 HTTPS 公网 URL
CallbackURL兼容别名；平台会规范化为 callback_url 后再转发给上游

​
原生回调

POST /volcark/api/v3/contents/generations/tasks 支持在顶层传入 callback_url。平台会先校验 URL，再把字段透传给火山方舟上游，并在任务审计快照中记录为 properties.upstream_request.callback_url。当渠道路由到 ZLHub Seedance 2.0 适配分支时，同一字段会转发到 ZLHub /v1/task/create；ZLHub 渠道请使用 doubao-seedance-2.0 或 doubao-seedance-2.0-fast 模型名。 校验规则：
  • 必须是字符串，且去除首尾空白后不能为空。
  • 必须使用 https。
  • 域名必须解析到公网可路由地址；本地、私网、链路本地、多播、CGNAT 等地址会被拒绝。
  • 校验失败时，平台会在调用上游前返回 HTTP 400，错误码为 invalid_request。
兼容字段 CallbackURL 会被规范化为 callback_url，不会继续把 CallbackURL 原字段发给上游。如果两个字段同时存在，以 callback_url 为准。 这是火山方舟/ZLHub 原生回调透传能力，不是 kapon 平台 webhook broker。回调投递、重试、签名和回调体结构均以对应上游原生能力为准；/v1/videos 当前不支持客户侧 callback_url，也不会把平台 video_... 任务 ID 转发给客户回调服务。

​
6. 查询任务

curl "https://models.kapon.cloud/volcark/api/v3/contents/generations/tasks/cgt-20260611204121-462cw" \
  -H "Authorization: Bearer $TOKEN"
成功响应示例： 
{
  "id": "cgt-20260611204121-462cw",
  "model": "doubao-seedance-2-0",
  "status": "succeeded",
  "content": {
    "video_url": "https://...",
    "last_frame_url": "https://..."
  },
  "usage": {
    "completion_tokens": 130500,
    "total_tokens": 130500
  },
  "created_at": 1781181681,
  "updated_at": 1781181802,
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 4,
  "framespersecond": 24,
  "service_tier": "default",
  "execution_expires_after": 3600,
  "generate_audio": false,
  "safety_identifier": "user-hash-001",
  "priority": 0
}
常见状态：
  • queued
  • running
  • succeeded
  • failed
  • expired
  • cancelled

​
7. 查询租户任务列表

curl "https://models.kapon.cloud/volcark/api/v3/contents/generations/tasks?page_num=1&page_size=20&filter.status=succeeded&filter.model=doubao-seedance-2-0" \
  -H "Authorization: Bearer $TOKEN"
列表接口是 当前 kapon 租户作用域内 的官方兼容列表，不返回其他租户或账号级全量任务。

​
8. 取消或删除任务

curl -X DELETE "https://models.kapon.cloud/volcark/api/v3/contents/generations/tasks/cgt-20260611204121-462cw" \
  -H "Authorization: Bearer $TOKEN"
删除或取消只允许操作当前租户自己的任务。kapon 会保留本地任务审计和计费记录。

​
9. 素材库工作流

素材库能力随国内 Doubao Seedance 2.0 提供，用于完成：
  1. 创建素材组
  2. 上传图片、视频或音频素材
  3. 等待素材变为 Active
  4. 在生成任务中使用 asset://<Asset_Id>
所有 Asset API 挂载在： 
POST /volcark/?Action={ActionName}&Version=2024-01-01
支持的 Action：
功能Action
创建素材组CreateAssetGroup
创建素材CreateAsset
查询素材组列表ListAssetGroups
查询素材列表ListAssets
查询单个素材组GetAssetGroup
查询单个素材GetAsset

​
9.1 创建素材组

curl -X POST "https://models.kapon.cloud/volcark/?Action=CreateAssetGroup&Version=2024-01-01" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0",
    "Name": "campaign-product-shots",
    "GroupType": "AIGC",
    "Description": "Assets for product videos"
  }'

​
9.2 创建素材

curl -X POST "https://models.kapon.cloud/volcark/?Action=CreateAsset&Version=2024-01-01" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0",
    "GroupId": "group-20260611210000-abcd1",
    "URL": "https://example.com/product.png",
    "AssetType": "Image",
    "Name": "product-front.png"
  }'
只有 Status=Active 的素材才能用于视频生成。素材 URL 必须公网可下载，不能依赖 Cookie、登录态或一次性链接。

​
9.3 使用素材生成视频

curl -X POST "https://models.kapon.cloud/volcark/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0",
    "content": [
      {
        "type": "text",
        "text": "以素材图片作为首帧，镜头缓慢推进。"
      },
      {
        "type": "image_url",
        "role": "reference_image",
        "image_url": {
          "url": "asset://asset-20260611210100-efgh2"
        }
      }
    ],
    "duration": 4,
    "ratio": "16:9",
    "resolution": "720p",
    "generate_audio": false
  }'
平台也接受 Asset://...，并会在转发前规范化为 asset://...。

​
10. 多租户和渠道边界

能力kapon 行为
任务查询只能查询当前租户创建的任务
任务列表只返回当前租户任务
取消/删除只能操作当前租户任务
素材组/素材只允许访问当前租户拥有的资源
素材引用asset:// 绑定到创建素材的资源域，避免国内、海外或跨资源域互通
计费按最终分辨率、是否含视频输入和成功任务 usage tokens 结算

​
11. 常见错误

HTTPcode场景
400invalid_request请求体不是合法 JSON，或缺少必填字段
400invalid_durationduration 超出模型允许范围
400moderation_skip_not_allowed素材库请求尝试使用 Moderation.Strategy=Skip
403forbidden_action请求了未开放的 Asset Update* / Delete*
404task_not_found任务不存在或不属于当前租户
404asset_not_found素材或素材组不存在、不属于当前租户，或刚创建后暂不可见
409InvalidAction.RunningTaskDeletion正在运行的任务暂不支持删除
502upstream_error模型服务返回异常
503channel_not_available当前账号暂未开通国内 Doubao Seedance 2.0 或素材库能力