漫小白API 文档
下载完整 .md ↓

Seedance Mini / Fast:视频 Token 计费

本页适用于当前“视频分组”中的 Mini 和 Fast。核对日期:2026-10-29。二者通过 POST /v1/videos 创建任务,支持多模态参考,按实际视频 Token 用量计费。

按秒计费的 SD-2.0-MZ1 请看专门章节,不要复制本页的 480p、4 秒、视频参考或关闭音频参数。

型号与当前规格

型号 完整 model 分辨率 普通生成时长
Mini dreamina-seedance-2-0-mini-260615 480p、720p 4–15 秒整数
Fast dreamina-seedance-2-0-fast-260128 480p、720p 4–15 秒整数

旧文档中的 dreamina-seedance-2-0-260128 和 dreamina-seedance-2-5-260628 已从当前新任务目录移除。旧任务仍按原 ID 查询,本页不再提供它们的新建请求或报价。

Mini/Fast 不支持 1080p、2K、4K。公开价格元数据中的分辨率枚举可能由多个型号共享,不能把其中所有值当作当前型号实际可提交的能力。

最小文生视频请求

下载 seedance-mini-text.json:

json
{
  "model": "dreamina-seedance-2-0-mini-260615",
  "prompt": "清晨湖面上的蓝色纸船缓缓漂动,柔和光线,镜头平稳推进",
  "seconds": "4",
  "resolution": "480p",
  "ratio": "16:9",
  "generate_audio": false,
  "watermark": false
}
bash
curl --fail-with-body --max-time 120 \
  https://openpix.cc/v1/videos \
  -H "Authorization: Bearer $MXB_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @seedance-mini-text.json

将 model 换成 Fast 的完整 ID 即可使用 Fast。成功受理后立即保存本站 id;查询和下载流程见视频任务与下载。

完整参数表

参数 类型 默认 / 取值 说明
model string,必填 上表完整 ID Key 必须有对应模型权限
prompt string 1–6000 个 Unicode 字符 与 content 中的唯一 text 项二选一
seconds string 或 integer 默认 5;4–15 整数 推荐普通生成使用此字段
duration integer,可选 seconds 的别名 JSON 中为整数;-1 仅用于下述单视频编辑
resolution string 默认 480p;480p / 720p 大小写会归一,但推荐小写
ratio string 默认 16:9 16:9、9:16、1:1、4:3、3:4、21:9、adaptive
generate_audio boolean,可选 建议显式 true 或 false 是否请求生成声音;省略时不在本手册承诺默认结果
watermark boolean,可选 建议显式 true 或 false 水印请求参数,不保证所有输出无可见标记
seed integer,可选 -1 至 4294967295 相同种子不保证跨次输出逐帧一致
return_last_frame boolean,可选 true / false 请求末帧;仅实际返回末帧时才有对应制品
content / metadata.content array,可选 1–13 项 一个 text 与最多 12 个素材,二选一
images string[],可选 最多 9 张 HTTPS 图片 普通参考图简写;不是首尾帧
input_reference / image string,可选 HTTPS 图片 普通参考图简写,避免多个别名同时填写
metadata.first_frame_image string,可选 HTTPS 图片 必须同时提供 last_frame_image
metadata.last_frame_image string,可选 HTTPS 图片 必须同时提供 first_frame_image
size string,可选 480p / 720p resolution 别名,不是像素宽高或比例
omni_reference_task_type string,可选 仅 edit 只用于下述单视频编辑

metadata 允许 content、first_frame_image、last_frame_image,以及 duration、resolution、ratio、generate_audio、watermark、seed、return_last_frame、omni_reference_task_type。同一参数顶层和 metadata 若都出现,值必须相同,建议只传一处。

ratio:"adaptive" 需要图片或视频视觉输入。纯文本、纯音频参考不能使用 adaptive。普通文本生成建议使用固定比例。

参考素材规则

素材 type role 数量上限
图片 image_url reference_image 9
视频 video_url reference_video 3
音频 audio_url reference_audio 3
所有参考素材合计 — — 12

text 不计入 12 个媒体素材,但整个 content 数组最多 13 项。必须恰好一项 text;如果已有顶层 prompt,不要再放 text 项。

URL 必须是无需登录即可访问的有效 HTTPS 地址,生成期间保持可访问。不能发送本地文件路径、浏览器 blob URL、私网地址或带本站 API Key 的 URL。此型号的 /v1/videos 不接受直接二进制附件;先使用自己的素材存储或创作台获取有效链接。

完整混合参考示例:

json
{
  "model": "dreamina-seedance-2-0-mini-260615",
  "seconds": "5",
  "resolution": "480p",
  "ratio": "16:9",
  "generate_audio": true,
  "metadata": {
    "content": [
      {"type": "text", "text": "参考@图片1的主体,结合@视频1的运镜和@音频1的节奏制作短片"},
      {"type": "image_url", "image_url": {"url": "https://media.example.com/character.png"}, "role": "reference_image"},
      {"type": "video_url", "video_url": {"url": "https://media.example.com/movement.mp4"}, "role": "reference_video"},
      {"type": "audio_url", "audio_url": {"url": "https://media.example.com/music.wav"}, "role": "reference_audio"}
    ]
  }
}

将 example.com 示例地址全部换成自己的真实素材。图片、视频、音频按各自类型的出现顺序编号;提示词可明确写 @图片1、@视频1、@音频1。

只用普通参考图片时可简写为 prompt 与 images:[HTTPS地址]。不能再同时传 content、image、input_reference 或关键帧字段。更多文件准备说明见视频参考素材。

首尾帧

Mini/Fast 的首尾帧必须 成对提供,各一张。不能只给首帧或只给尾帧,不能与普通参考图、视频、音频混用。

json
{
  "model": "dreamina-seedance-2-0-fast-260128",
  "prompt": "自然衔接首帧与尾帧,保持主体造型和运动连贯",
  "seconds": "5",
  "resolution": "720p",
  "ratio": "16:9",
  "generate_audio": false,
  "metadata": {
    "first_frame_image": "https://media.example.com/first.png",
    "last_frame_image": "https://media.example.com/last.png"
  }
}

等价的 content 写法是两个 image_url 项,角色分别为 first_frame 和 last_frame。二者仅改变素材表达形式,不改变必须成对提供的规则。

需要单首帧功能时,不要删除本例尾帧碰运气,应选择明确支持单首帧的 H3 或 Grok。

单视频编辑

高级编辑需要 恰好一个参考视频,不能再加入图片、音频或关键帧:

json
{
  "model": "dreamina-seedance-2-0-mini-260615",
  "duration": -1,
  "resolution": "480p",
  "ratio": "adaptive",
  "omni_reference_task_type": "edit",
  "metadata": {
    "content": [
      {"type": "text", "text": "保留运镜与主体动作,将环境改为柔和的黄昏光线"},
      {"type": "video_url", "video_url": {"url": "https://media.example.com/clip.mp4"}, "role": "reference_video"}
    ]
  }
}

duration=-1 仅在该编辑模式中用于跟随参考视频时长,不代表普通生成可以使用任意时长。不要同时传 seconds 与冲突的 duration。此组合经过请求契约核对,使用自己的素材前仍应做小规模实际效果验证。

视频 Token 计费

以下为核对时视频分组倍率为 1 的基础单价,单位 ¤ / 百万视频 Token:

模型 没有参考视频 有参考视频
Mini 12.65 7.7
Fast 26.455 15.73

仅图片或音频参考仍属于“没有参考视频”。480p 和 720p 当前单价相同,不代表总费用相同;分辨率、输出时长、参考视频及实际用量会影响最终金额。

估算公式为:视频 Token 数 ÷ 1,000,000 × 适用单价 × 实际适用倍率。网页已展示折算后的最终单价时,不要再重复乘倍率。

例如 Mini、没有参考视频、倍率 1,若完成用量为 40,594,则费用约为 40594 / 1000000 × 12.65 = ¤0.5135141,账单按站内精度结算。这只是用量计算例子,不是 4 秒固定价。

提交会先预留估算额度,成功后依据有效的视频用量结算,多退少补。正常结果中可见 usage.completion_tokens / total_tokens,但不能因为缺少 usage 就自行推定免费。明确失败的任务核对退款记录;客户端超时或停止轮询不会自动取消任务。

末帧、任务状态与排查

return_last_frame=true 不会让主下载入口变成图片。主视频仍从 /v1/videos/{id}/content 下载;完成后可通过 /v1/tasks/{id}/artifacts 查看是否实际存在 last_frame 制品。仅在列表有该制品时读取其返回的本站链接。

常见失败原因包括:1080p/4K 参数、4–15 范围外的普通时长、重复 text、首尾帧缺一、关键帧与参考素材混用、素材链接无法读取。按原任务返回的安全错误说明修正,不要自动重复创建。完整状态与错误处理见 视频任务与下载。

漫小白 API 接入文档 · 2026-11-02 更新 · 当前目录与接口契约核对
模型权限与费用以当前模型广场及账单为准。

复制 Markdown

浏览器未允许自动复制,内容已选中,可按 Ctrl+C / ⌘C 复制。