Seedance 2.5

Seedance 2.5 同时提供国内 Doubao 和海外 BytePlus Dreamina 版本。两者共用 Kapon 的任务接口和请求结构，但模型名、价格与联网搜索能力不同。需要使用经过本人认证的真人素材时，先按真人素材库 API 完成对应地域的 H5 认证和素材入库，再使用 asset://<AssetId> 创建任务。

1. 模型与价格

区域	Kapon 稳定模型名	官方版本 ID	无视频输入	含视频输入
国内	`doubao-seedance-2-5`	`doubao-seedance-2-5-260628`	¥70/M tokens	¥42/M tokens
海外	`dreamina-seedance-2-5`	`dreamina-seedance-2-5-260628`	$10.70/M tokens	$6.40/M tokens

建议在请求中使用稳定模型名。平台也接受对应的官方版本 ID，并自动映射到稳定模型；查询和列表响应仍回显稳定模型名。 video 档表示 content[] 中包含 video_url，否则使用 novideo 档。上表为 480p／720p 的参考价格；1080p 使用单独价格档，当前价格及优惠以控制台为准。只对成功生成的视频结算，实际视频用量以查询响应中的 usage.completion_tokens 为准。国内模型还支持纯文本任务使用 tools: [{"type":"web_search"}]。联网搜索按响应中的 usage.tool_usage.web_search 实际次数独立结算；海外模型不支持该工具，具体客户价格以 Kapon 控制台为准。

2. 接口

export BASE_URL="https://models.kapon.cloud"
export TOKEN="oh-xxxxxxxxxxxxxxxx"

功能	路径
创建任务	`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}`

所有请求使用 Kapon API Token：

Authorization: Bearer <TOKEN>
Content-Type: application/json

3. 创建任务

国内文生视频示例：

curl -X POST "$BASE_URL/volcark/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-5",
    "content": [
      {
        "type": "text",
        "text": "一段 5 秒的电影感产品短片，柔和自然光，镜头缓慢向前推进。"
      }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": true,
    "output_format": "mp4",
    "watermark": false
  }'

海外调用只需把 model 改为 dreamina-seedance-2-5；接口地址仍使用 Kapon 的 BASE_URL。创建成功返回任务 ID：

{
  "id": "cgt-202608130001-example",
  "model": "doubao-seedance-2-5"
}

多模态参考

content[] 支持以下输入：

类型	`role`	数量上限
`image_url`	`reference_image`、`first_frame`、`last_frame`	30
`video_url`	`reference_video`	10
`audio_url`	`reference_audio`	10

图片、视频和音频合计最多 50 个。Kapon 托管素材可使用 asset://<Asset_Id>；素材需先完成上传和处理，再提交生成任务。

{
  "model": "doubao-seedance-2-5",
  "content": [
    {
      "type": "text",
      "text": "保持参考视频的镜头运动，使用参考图片的产品外观和参考音频的节奏。"
    },
    {
      "type": "video_url",
      "role": "reference_video",
      "video_url": {"url": "asset://video-asset-id"}
    },
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {"url": "asset://image-asset-id"}
    },
    {
      "type": "audio_url",
      "role": "reference_audio",
      "audio_url": {"url": "asset://audio-asset-id"}
    }
  ],
  "resolution": "720p",
  "ratio": "adaptive",
  "duration": -1
}

首帧/尾帧任务必须使用 ratio=adaptive，last_frame 必须与 first_frame 同时出现，且首尾帧不能和 reference_* 素材混用。

参考生成、编辑与延长

在全模态参考任务中，可传入 omni_reference_task_type：auto（默认）、reference、edit 或 extend。该字段引导任务类型，平台保留原值；实际模型判断仍可能产生异步错误，应继续查询任务状态。

类型	输入与参数
`auto`	按输入和提示词判断；涉及编辑或延长时，建议使用 `ratio=adaptive`、`duration=-1`
`reference`	至少一份参考图片、视频或音频
`edit`	必须有 `reference_video`，待编辑视频 4–30 秒；`ratio=adaptive`、`duration=-1`
`extend`	必须有 `reference_video`；`ratio=adaptive`，`duration` 为 `-1` 或 4–30 秒

省略编辑／延长的宽高比、时长时沿用官方默认值。输入可使用对应模型允许的公网 URL、图片 Base64 或已获授权的 asset://；真人素材继续遵循认证与素材入库要求。

国内联网搜索

联网搜索只支持国内 doubao-seedance-2-5，且 content[] 必须只有文本：

{
  "model": "doubao-seedance-2-5",
  "content": [
    {
      "type": "text",
      "text": "结合近期公开信息生成一段科技新闻风格短片。"
    }
  ],
  "resolution": "720p",
  "duration": 5,
  "tools": [
    {"type": "web_search"}
  ]
}

4. 参数边界

字段	Seedance 2.5 约束
`resolution`	`480p`、`720p`、`1080p`，不支持 `4k`
`duration`	`4-30` 的整数，或 `-1` 由模型选择
`ratio`	`adaptive`、`21:9`、`16:9`、`4:3`、`1:1`、`3:4`、`9:16`
`output_format`	`mp4`、`mov`
`omni_reference_task_type`	`auto`、`reference`、`edit`、`extend`，适用于全模态参考任务
`generate_audio`	布尔值；默认生成同步音频
`return_last_frame`	布尔值；成功响应可返回尾帧 URL
`priority`	`0-9`
`execution_expires_after`	`3600-259200` 秒
`service_tier`	仅支持 `default`
`draft`	原生接口支持 `true`（样片仅 `480p`）；省略或 `false` 为普通视频

seed、frames、frames_per_second、frame_rate、fps、camera_fixed 不适用于 Seedance 2.5，传入时会在请求模型服务前返回 HTTP 400。

原生样片与成片

在原生创建请求中设置 draft: true、resolution: "480p"，其他输入字段沿用上面的普通视频规则。查询响应会保留 draft、状态、视频结果与用量；上游暂不支持样片时会返回失败，不会改为普通视频。确认本人样片成功后，用其返回的任务 ID 创建成片：

{
  "model": "doubao-seedance-2-5",
  "content": [{"type": "draft_task", "draft_task": {"id": "<本人成功样片任务 ID>"}}],
  "resolution": "1080p"
}

海外使用 dreamina-seedance-2-5，公开模型名与对应官方版本名可互换。无需额外提供 origin_task_id。只能引用本人在平台创建且成功的同模型样片；平台拒绝外部 ID、普通视频、未成功、已删除或模型不一致的任务。样片 ID 是否仍有效，由原签发上游判断。OneHub 对已接入该引用协议的火山、BytePlus 和第三方适配器共用这一处理，不再按本地记录的年龄、固定 7／14 天或缺失 created_at 提前拒绝。各上游期限及错误规则独立，以对应服务文档为准（火山方舟、BytePlus）；这不新增渠道的 Draft 能力，也不改变普通视频的上游查询有效期。上游可在提交时返回过期或不存在错误，也可在任务查询中返回失败。引用样片时，若上游以 4xx（不含 404）明确返回样片过期，平台返回 draft_task_expired，提示“样片已过期，请换一个样片”，不返回上游密钥或渠道信息。创建前可能先预占额度；同步提交失败释放该预占，已创建成片异步失败按现有终态流程退款，重复终态不会重复结算。错误经平台脱敏返回，不跨渠道重试或补生成。第三方上游自身的失败费用仍以其合同为准；以上描述平台现有额度处理，不承诺所有上游失败都没有费用。历史记录仍须满足归属、成功状态、模型及原渠道、计价信息等校验，缺创建时间本身不再成为拒绝理由，不回填历史时间。成片固定原渠道，原渠道不可用时直接失败。成片不能重复提交提示词、图片、视频、音频、duration、ratio、seed、generate_audio 或 omni_reference_task_type，这些值由模型复用样片；return_last_frame、output_format、watermark 等允许字段可以重新设置，省略时使用模型默认值，仍受所选渠道能力限制。样片按现有 480p 价格、成片按现有 1080p 价格独立结算；成片沿用样片是否含输入视频的计价分类，不把样片视频本身当作新增输入视频。成片失败不退还已成功样片费用。样片闭环只开放原生接口，不扩展 /v1/videos、1.5 Pro 或 2.0 系列。

5. 查询结果

curl "$BASE_URL/volcark/api/v3/contents/generations/tasks/cgt-202608130001-example" \
  -H "Authorization: Bearer $TOKEN"

任务状态包括 queued、running、succeeded、failed 和 expired。成功任务会返回 content.video_url、实际规格与 usage：

{
  "id": "cgt-202608130001-example",
  "model": "doubao-seedance-2-5",
  "status": "succeeded",
  "content": {
    "video_url": "https://example.com/generated-video.mp4"
  },
  "usage": {
    "completion_tokens": 108000
  }
}

成功视频 URL 通常有效 24 小时，且存在下载次数限制，请及时转存；失败任务应读取响应中的结构化 error。

6. OpenAI 风格接口

Seedance 2.5 也可通过 POST /v1/videos 创建任务：

curl -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-5",
    "prompt": "一艘纸船漂浮在清晨的水面上",
    "seconds": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": true
  }'

OpenAI 风格接口适合基础文生视频和参考素材调用。需要 content[].role、output_format、tools.web_search 等完整原生能力时，请使用 /volcark/api/v3/contents/generations/tasks。

概述与使用

图片生成

视频生成

素材库

语音合成