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

​
1. 前置条件

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

​
2. 模型

对外模型BytePlus 官方模型说明
dreamina-seedance-2-0dreamina-seedance-2-0-260128海外标准模型，支持 480p / 720p / 1080p
dreamina-seedance-2-0-fastdreamina-seedance-2-0-fast-260128海外快速模型，支持 480p / 720p
dreamina-seedance-2-0-filter-offBytePlus Filter-Off 模型海外标准 Filter-Off 模型，价格同 dreamina-seedance-2-0
dreamina-seedance-2-0-fast-filter-offBytePlus Filter-Off 模型海外快速 Filter-Off 模型，价格同 dreamina-seedance-2-0-fast
请求中的 model 建议使用左侧稳定模型名。为兼容 BytePlus 官方版本号，平台也接受以下官方版本名，并在任务查询、任务列表、素材库响应和计费审计中统一归一为左侧稳定模型名：
  • dreamina-seedance-2-0-260128 -> dreamina-seedance-2-0
  • dreamina-seedance-2-0-fast-260128 -> dreamina-seedance-2-0-fast
seedance-2-0、seedance-2-0-260128、seedance-2-0-fast、seedance-2-0-fast-260128 属于控制台或资源页短 ID，不作为对外 API model 参数兼容。dreamina-seedance-2-0-filter-off-260128、dreamina-seedance-2-0-260128-filter-off、dreamina-seedance-2-0-fast-filter-off-260128、dreamina-seedance-2-0-fast-260128-filter-off 不是 BytePlus 官方模型名，平台也不做兼容映射。 查询和列表响应中的 model 回显创建请求中的 kapon 对外模型，避免向调用方暴露内部 endpoint、计费 SKU 或内部映射名。计费和权限以创建请求中的 kapon 对外模型、最终分辨率和参考输入类型为准。 如需锁定官方具体模型版本，请联系平台配置官方版本映射，例如 dreamina-seedance-2-0 -> dreamina-seedance-2-0-260128。Filter-Off 模型需要完成精确版本映射，避免静默降级到普通模型。

​
3. 海外价格

SKU价格
dreamina-seedance-2-0-480p-novideo$7.0/M tokens
dreamina-seedance-2-0-480p-video$4.3/M tokens
dreamina-seedance-2-0-720p-novideo$7.0/M tokens
dreamina-seedance-2-0-720p-video$4.3/M tokens
dreamina-seedance-2-0-1080p-novideo$7.7/M tokens
dreamina-seedance-2-0-1080p-video$4.7/M tokens
dreamina-seedance-2-0-fast-novideo$5.6/M tokens
dreamina-seedance-2-0-fast-video$3.3/M tokens
video 表示请求包含视频参考输入；novideo 表示不包含视频参考输入。平台只对成功出片任务结算，失败任务不会按成功出片计费。 dreamina-seedance-2-0-filter-off 复用 dreamina-seedance-2-0 的全部 SKU 价格；dreamina-seedance-2-0-fast-filter-off 复用 dreamina-seedance-2-0-fast 的全部 SKU 价格。日志和任务审计仍保留创建请求中的 Filter-Off 对外模型名。

​
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}
本模型不以 /v1/videos 作为主接入口径。需要 BytePlus 原生字段和响应的客户应使用本页的 /volcark/api/v3/... 路径。

​
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": "dreamina-seedance-2-0-fast",
    "content": [
      {
        "type": "text",
        "text": "A quiet cinematic shot of a paper boat floating on calm water, soft morning light."
      }
    ],
    "duration": 4,
    "ratio": "16:9",
    "resolution": "480p",
    "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"
  }'
Filter-Off 调用只需要替换 model，其他请求字段与普通海外 Dreamina 2.0 保持一致： 
{
  "model": "dreamina-seedance-2-0-filter-off",
  "content": [
    {
      "type": "text",
      "text": "A cinematic product shot with clean studio lighting."
    }
  ],
  "duration": 4,
  "ratio": "16:9",
  "resolution": "720p"
}
典型响应： 
{
  "id": "cgt-20260611204121-462cw"
}
kapon native 响应默认不追加 platform_id，以保持 BytePlus 原生响应形态。 常用字段：
字段说明
content[]BytePlus 多模态输入数组，至少包含 prompt 文本或参考素材
duration4-15 秒，也可按 BytePlus 官方能力传 -1 交给模型服务自动选择
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任务执行过期时间，官方范围通常为 3600-259200 秒
priority队列优先级 0-9
safety_identifier终端用户稳定标识，建议传哈希后的用户 ID
callback_urlBytePlus 原生任务状态回调地址，必须是非空 HTTPS 公网 URL
CallbackURL兼容别名；平台会规范化为 callback_url 后再转发给上游

​
原生回调

POST /volcark/api/v3/contents/generations/tasks 支持在顶层传入 callback_url。平台会先校验 URL，再把字段透传给 BytePlus 上游，并在任务审计快照中记录为 properties.upstream_request.callback_url。 校验规则：
  • 必须是字符串，且去除首尾空白后不能为空。
  • 必须使用 https。
  • 域名必须解析到公网可路由地址；本地、私网、链路本地、多播、CGNAT 等地址会被拒绝。
  • 校验失败时，平台会在调用上游前返回 HTTP 400，错误码为 invalid_request。
兼容字段 CallbackURL 会被规范化为 callback_url，不会继续把 CallbackURL 原字段发给上游。如果两个字段同时存在，以 callback_url 为准。 这是 BytePlus 原生回调透传能力，不是 kapon 平台 webhook broker。回调投递、重试、签名和回调体结构均以 BytePlus 原生能力为准；/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": "dreamina-seedance-2-0-fast",
  "status": "succeeded",
  "content": {
    "video_url": "https://...",
    "last_frame_url": "https://..."
  },
  "usage": {
    "completion_tokens": 40594,
    "total_tokens": 40594
  },
  "created_at": 1781181681,
  "updated_at": 1781181802,
  "seed": 74719,
  "resolution": "480p",
  "ratio": "16:9",
  "duration": 4,
  "framespersecond": 24,
  "service_tier": "default",
  "execution_expires_after": 3600,
  "generate_audio": false,
  "draft": false,
  "safety_identifier": "user-hash-001",
  "priority": 0
}
常见状态：
  • queued
  • running
  • succeeded
  • failed
  • expired
  • cancelled
结果 URL 通常约 24 小时有效，请及时转存。若请求了 return_last_frame=true，成功结果可能包含 content.last_frame_url。

​
7. 查询租户任务列表

curl "https://models.kapon.cloud/volcark/api/v3/contents/generations/tasks?page_num=1&page_size=20&filter.status=succeeded&filter.model=dreamina-seedance-2-0-fast" \
  -H "Authorization: Bearer $TOKEN"
响应形态： 
{
  "items": [
    {
      "id": "cgt-20260611204121-462cw",
      "status": "succeeded",
      "model": "dreamina-seedance-2-0-fast",
      "execution_expires_after": 3600,
      "service_tier": "default",
      "safety_identifier": "user-hash-001"
    }
  ],
  "total": 1
}
支持的查询参数：
参数说明
page_num页码，从 1 开始
page_size每页数量
filter.statusqueued、running、succeeded、failed、expired、cancelled
filter.model创建请求中的 kapon 对外模型
filter.task_ids逗号分隔的 BytePlus 原生任务 ID
列表接口是 当前 kapon 租户作用域内 的 BytePlus 兼容列表，不返回其他租户或账号级全量任务。

​
8. 取消或删除任务

curl -X DELETE "https://models.kapon.cloud/volcark/api/v3/contents/generations/tasks/cgt-20260611204121-462cw" \
  -H "Authorization: Bearer $TOKEN"
正在运行的任务可能返回 409： 
{
  "error": {
    "code": "InvalidAction.RunningTaskDeletion",
    "message": "Cannot delete task because it is currently running.",
    "param": "",
    "type": "Conflict"
  }
}
kapon 会保留本地任务审计和计费记录。对不支持运行中删除的任务，终态任务删除会在 kapon 租户内本地隐藏，运行中任务返回 409。删除或取消只允许操作当前租户自己的任务。

​
9. 素材库工作流

素材库能力随海外 Dreamina 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
不开放 Update*、Delete* 和 Moderation.Strategy=Skip。

​
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": "dreamina-seedance-2-0-fast",
    "Name": "campaign-product-shots",
    "GroupType": "AIGC",
    "Description": "Assets for product videos"
  }'
典型响应： 
{
  "ResponseMetadata": {
    "Action": "CreateAssetGroup",
    "Region": "ap-southeast-1",
    "Service": "ark",
    "Version": "2024-01-01"
  },
  "Result": {
    "Id": "group-20260611210000-abcd1"
  }
}

​
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": "dreamina-seedance-2-0-fast",
    "GroupId": "group-20260611210000-abcd1",
    "URL": "https://example.com/product.png",
    "AssetType": "Image",
    "Name": "product-front.png"
  }'
说明：
  • AssetType 支持 Image、Video、Audio
  • 推荐使用 URL 字段，平台也兼容 Url / url
  • ProjectName 由平台自动补充
  • 素材 URL 必须公网可下载，不能依赖 Cookie、登录态或一次性链接
  • 只有 Status=Active 的素材才能用于视频生成

​
9.3 查询素材

curl -X POST "https://models.kapon.cloud/volcark/?Action=GetAsset&Version=2024-01-01" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0-fast",
    "Id": "asset-20260611210100-efgh2"
  }'
常见状态：
  • Pending
  • Processing
  • Active
  • Failed
刚创建后可能存在短暂不可见窗口。若 GetAsset 短暂返回 404，请按 2、5、10、20 秒退避重试。

​
9.4 查询素材列表

curl -X POST "https://models.kapon.cloud/volcark/?Action=ListAssets&Version=2024-01-01" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0-fast",
    "GroupId": "group-20260611210000-abcd1",
    "Filter": {
      "GroupType": "AIGC",
      "GroupId": "group-20260611210000-abcd1"
    },
    "PageNumber": 1,
    "PageSize": 20
  }'
ListAssets 和 ListAssetGroups 只返回当前 kapon 租户可见的素材。平台会在缺省时自动补齐 Filter.GroupType=AIGC。

​
10. 在生成任务中使用素材

素材进入 Active 后，用 asset://<Asset_Id> 作为 BytePlus content 输入： 
curl -X POST "https://models.kapon.cloud/volcark/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0-fast",
    "content": [
      {
        "type": "text",
        "text": "Use Image 1 as the opening frame, then slowly move the camera forward."
      },
      {
        "type": "image_url",
        "role": "reference_image",
        "image_url": {
          "url": "asset://asset-20260611210100-efgh2"
        }
      }
    ],
    "duration": 4,
    "ratio": "16:9",
    "resolution": "480p",
    "generate_audio": false
  }'
平台也接受 Asset://...，并会在转发前规范化为 asset://...。

​
11. 多租户边界

能力kapon 行为
任务创建请求参数尽量保持 BytePlus 原生形态，内部适配差异由 kapon 处理
任务查询只能查询当前租户创建的任务，响应字段按 BytePlus 兼容层归一
任务列表只返回当前租户任务，不返回 BytePlus 账号级全量任务
取消/删除只能操作当前租户任务，并保留平台审计记录
素材组/素材只允许访问当前租户拥有的资源
素材引用asset:// 会绑定到创建素材的资源域，避免跨资源域或跨租户误用

​
12. 常见错误

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当前账号暂未开通海外 Dreamina 2.0 或素材库能力
503model_mapping_requiredFilter-Off 模型未完成精确官方版本映射，或映射到了普通 Dreamina 模型