Seedance 2.5 草稿模式

先生成 480p 草稿视频，再引用草稿公共任务 ID 创建 1080p 正式片，包含参数继承、有效期与计费规则。

可用性： 网关已部署草稿模式支持，实际可用性取决于所选渠道、上游账号和模型。尚未完成真实付费样片及正式片生成验证。

草稿模式（官方称“样片 / Draft 模式”）分为两个独立任务：先用 draft: true 生成 480p 预览，检查构图、镜头和主体动作；满意后引用草稿公共任务 ID 创建 1080p 正式片，正式片会返回新的任务 ID。正式片自动复用草稿的创作输入，不能在第二步修改提示词或参考素材。规则依据官方 Seedance 2.5 教程。

本页使用官方格式入口；统一视频协议的请求写法见通用视频格式中的草稿模式。其他任务类型见请求与返回参数。

使用前确认

示例模型为 doubao-seedance-2-5-260628。渠道别名和 Max 模型只有在所选上游支持草稿能力时才可使用；第二步必须填写与草稿相同的 model。
必须先等待草稿成功完成。7 天有效期从草稿的 created_at 创建时间计算，排队和生成耗时也包含在内。
草稿必须由当前用户在同一网关创建。网关会校验归属并绑定原任务的渠道与账号；原渠道或账号不可用时，正式片不能切换到另一个上游账号生成。
创建草稿和复用草稿均使用 Content-Type: application/json。

第一步：创建 480p 草稿

先设置网关地址和令牌。MODELSELL_BASE_URL 不包含 /v1，末尾不要带 /。

export MODELSELL_BASE_URL="https://api.modelsell.com"
export MODELSELL_API_KEY="你的网关令牌"

curl -X POST "$MODELSELL_BASE_URL/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer $MODELSELL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-5-260628",
    "content": [
      {"type": "text", "text": "一只橘猫在阳光下的花园里追逐蝴蝶，镜头平稳跟随"}
    ],
    "draft": true,
    "resolution": "480p",
    "duration": 5,
    "ratio": "16:9",
    "generate_audio": true
  }'

draft: true 仅允许 resolution: "480p"，不能使用 720p 或 1080p。首帧、首尾帧、视频编辑等输入仍需满足该任务类型的限制，例如首帧任务的 ratio 必须为 adaptive。创建接口参数给出了各字段的取值限制。

保存创建响应中的网关公共任务 ID，例如 task_…。下面用 $DRAFT_TASK_ID 表示该值：

export DRAFT_TASK_ID="task_替换为草稿创建响应中的公共任务ID"

curl "$MODELSELL_BASE_URL/api/v3/contents/generations/tasks/$DRAFT_TASK_ID" \
  -H "Authorization: Bearer $MODELSELL_API_KEY"

建议间隔 10 秒查询一次，成功后先播放或下载草稿确认效果。支持本页功能的新版本网关会将 Seedance 原生查询统一为方舟格式：成功为 status: "succeeded"，视频在 content.video_url；失败或超时后应停止轮询并读取错误。旧版网关或直接调用第三方接口时，可能看到 task.status: "completed" 和 task.outputs[]，这些包装仅供兼容识别。若改用网关规范化查询 GET /v1/videos/{task_id}，则读取 status: "completed" 和 video_url。

第二步：引用草稿生成 1080p 正式片

确认草稿成功且仍在有效期内后，提交以下请求。content 必须只包含一个 draft_task 对象：

curl -X POST "$MODELSELL_BASE_URL/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer $MODELSELL_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"doubao-seedance-2-5-260628\",
    \"content\": [
      {\"type\": \"draft_task\", \"draft_task\": {\"id\": \"$DRAFT_TASK_ID\"}}
    ],
    \"resolution\": \"1080p\",
    \"draft\": false,
    \"return_last_frame\": true
  }"

正式片返回一个新的公共任务 ID，保存为 $FINAL_TASK_ID，使用同一个查询接口等待完成：

export FINAL_TASK_ID="task_替换为正式片创建响应中的公共任务ID"

curl "$MODELSELL_BASE_URL/api/v3/contents/generations/tasks/$FINAL_TASK_ID" \
  -H "Authorization: Bearer $MODELSELL_API_KEY"

官方格式成功后读取 content.video_url；请求尾帧且上游实际返回时，读取 content.last_frame_url。两个任务分别有自己的状态、视频地址与 usage。响应字段说明见请求与返回参数。

第二步的参数规则

类别	参数与要求
必须一致	`model` 与创建草稿时完全相同。
固定值	`resolution` 默认且仅支持 `1080p`；`draft` 可省略或为 `false`。
唯一输入	`content` 仅包含一个 `{"type":"draft_task","draft_task":{"id":"task_…"}}`，不要混入文本或图片、视频、音频。
自动复用，禁止再次传入	提示词、参考图片/视频/音频、`duration`、`ratio`、`seed`、`generate_audio`、`omni_reference_task_type`。即使值与草稿相同，也不能重复填写。
可重新设置	`return_last_frame`、`output_format`、`watermark`、`service_tier`、`execution_expires_after`、`priority`、`callback_url`、`safety_identifier`。省略时采用模型默认值，不继承草稿的实际取值。

“可重新设置”仍受模型枚举和范围限制，例如 Seedance 2.5 不支持 service_tier: "flex"。通用视频协议中的 seconds、prompt、image、images 等快捷字段同样不能在第二步重复传入；高级字段放在 metadata，详见通用视频格式。

任务 ID、有效期与计费

调用 ModelSell 时始终使用网关返回的 task_…。 直接调用火山官方会获得 cgt-…；部分第三方创建任务会返回 mvt-…，并在查询结果中另带 cgt-…。这些是上游协议细节。第二步不要自行提取或传入上游 ID，网关会从保存的任务记录中完成转换。未经过当前网关创建的原始 cgt-… 或 mvt-… 无法用于此流程。

草稿可复用 7 天，从 created_at 起算，且必须先成功完成。视频下载链接通常仅保留 24 小时，请及时下载或转存；下载链接有效期与草稿可复用期限不同。

两个任务独立计费：草稿按 480p，正式片按 1080p。正式片是否属于含输入视频的计费类别、以及输入视频时长，沿用第一步的原始输入；草稿产物本身不额外计入输入视频时长。各任务最终用量以其上游 usage 和适用计费规则为准，不存在统一固定总价。官方计费规则见模型价格，ModelSell 实际费用以所选模型、分组和渠道价格为准。