开发指南
Seedance 2.0 V2 API:Mini/Fast 创建、查询与下载
提供九维 AI Seedance Mini/Fast V2 的公开接口、参考素材、音轨、时长、幂等请求、任务查询与结果下载说明。
API 根地址与鉴权#
国内站根地址为 https://9weisc.cn。使用九维 AI API Key,不使用上游供应商密钥、浏览器 Cookie 或网站登录会话。
| 操作 | 方法与地址 |
|---|---|
| 查看可用模型 | GET https://9weisc.cn/v1/models |
| 创建 Mini | POST https://9weisc.cn/api/v2/open/aigc/seedance2-0-mini-oversea |
| 创建 Fast | POST https://9weisc.cn/api/v2/open/aigc/seedance2-0-fast-oversea |
| 查询任务 | GET https://9weisc.cn/api/v2/open/aigc/{taskId} |
| 查询余额/请求记录 | GET https://9weisc.cn/api/v2/open/balance / GET https://9weisc.cn/api/v2/open/records |
所有请求使用 Authorization: Bearer $U9AI_API_KEY。GET /v1/models 只证明密钥认证和模型目录可读,不等于已完成视频生成。
创建视频任务#
Seedance V2 请求至少传入含提示词的 content 数组。Mini/Fast 支持 480p、720p,单任务时长为 4–15 秒整数;不支持单次 30 秒任务。常见比例包括 16:9、9:16、1:1、4:3、3:4、21:9 和 adaptive。
curl --fail-with-body -sS 'https://9weisc.cn/api/v2/open/aigc/seedance2-0-mini-oversea' \
-H "Authorization: Bearer $U9AI_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"content": [
{"type":"text","text":"以图片1为参考,生成自然镜头运动的竖屏短视频。"},
{"type":"image_url","image_url":{"url":"https://example.com/your-authorized-image.jpg"},"role":"reference_image"}
],
"ratio":"9:16",
"duration":5,
"resolution":"720p",
"generateAudio":true
}'Fast 任务只需将路径中的 mini 换为 fast。generateAudio 是驼峰字段:true 请求生成音轨,false 请求无声结果;它不保证逐字旁白、字幕或特定配乐。公开 API 不要求另外传 model 或 genType。九维 AI 根据路径及 content 中的输入类型选价;比例和 generateAudio 不改变每秒单价。创建前请以 /v1/models 和页面显示价格为准。
参考图片#
参考素材可使用上游可访问的完整 HTTPS URL,或完整 data:image/...;base64,... URI。data URI 支持 JPEG、PNG、WebP、GIF;每张解码后不得超过 5 MiB。支持 first_frame、last_frame、reference_image 等角色;上传顺序要与提示词中“图片1、图片2”的说明一致。
本地 data URI 由九维 AI 在调用创建任务前转为上游 HTTPS 素材 URL。无效 data URI 返回 invalid_reference,素材上传失败返回 reference_upload_failed;这两类错误发生在视频任务创建和余额冻结前。不要传本地文件路径、私网地址或需要登录态才能打开的链接。
查询、结果与费用#
创建成功必须包含非空 data.taskId。记录 taskId、U9 返回的 X-Request-ID 和提交时间。查询示例:
curl --fail-with-body -sS \
-H "Authorization: Bearer $U9AI_API_KEY" \
'https://9weisc.cn/api/v2/open/aigc/YOUR_TASK_ID'任务状态常见为 processing、success、failed。成功时检查 data.result 中的资源地址;失败时检查 data.errorMsg 和请求记录。下载结果域名不需要也不得携带 API Key。播放前确认下载响应成功、文件非空且音视频流可读取。
创建请求可用唯一 X-Request-ID 作为幂等标识。同一账户重复使用会返回 request_already_submitted(HTTP 409),避免重复创建。遇到超时、5xx、424 或结果未知时不要自动改用新 ID 重发;先检查请求记录、任务 ID 和实际账单。预估与最终费用以钱包流水及请求记录为准,计费方式按选定规格显示。
长视频和工单排查#
若需要超过 15 秒的成片,请分别生成多个短镜头后再剪辑;这不代表模型进行了一次连续的 30 秒推理。
工单中提供请求时间和时区、模型路径、分辨率、时长、U9 X-Request-ID、taskId、HTTP 状态和脱敏错误信息。不要发送 API Key、Authorization 请求头、Cookie、私有素材或支付凭证。创建超时不要通过反复提交来“找回”结果。
准备好开始了吗?
在控制台选择账户可用模型,先用一条简单请求验证配置。