Dreamina 视频生成 API(测试版)

接口的路径、请求体、响应体、状态、错误格式与 BytePlus ModelArk 官方「视频生成」API 一致, 已经按官方 SDK / 文档写好的代码,把地址换成 https://dreamina.ntokenx.com、Key 换成我们发的即可调用。

当前为测试阶段:不收费,每个 Key 有测试额度(见下文「测试额度」)。

鉴权

请求头 Authorization: Bearer <你的 Key>(Key 由我们发放)。

curl https://dreamina.ntokenx.com/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"model":"dreamina-seedance-2-0-mini-260615","content":[{"type":"text","text":"a cat walking on the beach at sunset"}]}'
# → {"id": "cgt-…"},再 GET /api/v3/contents/generations/tasks/{id} 轮询到 succeeded

接口

状态:queued → running → succeeded / failed / cancelled / expired。任务保留 7 天(Draft 任务 14 天)。

模型

请求体

{
  "model": "dreamina-seedance-2-0-mini-260615",
  "content": [
    {"type": "text", "text": "@Image1 的女孩在东京街头回头微笑"},
    {"type": "image_url", "image_url": {"url": "https://…/a.png"}, "role": "reference_image"}
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "generate_audio": true,
  "return_last_frame": false,
  "callback_url": "https://your.server/callback"
}

content[]:

素材 url 支持 http(s) 地址或 data: base64。

其它参数:

参数也可以写在提示词末尾:--rs 720p --rt 9:16 --dur 8 --cf true。

查询响应

{
  "id": "cgt-20261103170000-ab12c",
  "model": "dreamina-seedance-2-0-mini-260615",
  "status": "succeeded",
  "content": {"video_url": "https://dreamina.ntokenx.com/files/cgt-….mp4", "file_expires_at": 1793900000},
  "usage": {"completion_tokens": 86400, "total_tokens": 86400, "dreamina_credits": 28},
  "resolution": "720p", "ratio": "16:9", "duration": 5, "framespersecond": 24,
  "generate_audio": true, "service_tier": "default", "created_at": 1793600000, "updated_at": 1793600120, "error": null
}

video_url 有效期 7 天(到期时间见 file_expires_at),请及时下载保存。usage.dreamina_credits 为本次任务消耗的积分。

测试额度

每个 Key 有两项上限(具体数值随 Key 告知,需要调整请联系我们):

• 同时进行的任务数(排队中 + 生成中):超过返回 HTTP 429 QuotaExceeded,等已有任务结束再提交。
• 累计积分:成功的任务按 usage.dreamina_credits 累计,失败 / 取消的不计;用完返回 HTTP 429 SetLimitExceeded。

暂不支持

以下官方模型 / 参数暂不支持,传入会直接返回错误:

• 模型:Seedance 1.0 / 1.0 pro fast / 1.5 pro(ModelNotOpen)。
• 2.0 / 2.0 fast / 2.0 mini 的 480p、编辑、延长(编辑 / 延长请用 2.5)。
• 参数:seed、frames、watermark: true、output_format: mov、priority、tools、safety_identifier、 service_tier: flex;文生视频的 ratio: adaptive;duration: -1(编辑任务除外)。

错误

格式 {"error": {"code": "...", "message": "..."}}。常见: