Seedance 海外版

通过 UniAll 视频 API 调用下列完整模型名称。-global 是模型名称的一部分。海外版支持文生视频、图生视频、首尾帧生成和多模态参考。

支持模型

模型	分辨率	输出时长
seedance2.0-global	480p、720p、1080p、4k	4–15 秒
seedance2.0-fast-global	480p、720p	4–15 秒
seedance2.0-mini-global	480p、720p	4–15 秒
seedance2.5-global	480p、720p、1080p	4–30 秒

接口与鉴权

API 地址为 https://api.uniall.ai。

POST /v1/videos
GET  /v1/videos/{task_id}
GET  /v1/videos/{task_id}/content

每个请求都使用自己的 UniAll API Key：

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

请求参数

参数	类型	必填	说明
model	string	是	上述四个完整模型名称之一。
prompt	string	是	视频指令，也可改为在 content 中提供 type=text 项。
resolution	string	是	所选模型支持的分辨率。
duration	integer	是	所选模型范围内的输出时长，不支持自动时长。
aspect_ratio	string	否	auto、21:9、16:9、4:3、1:1、3:4 或 9:16。
image	string	否	首帧图片 URL。单独使用时为图生视频，与 last_image 一起使用时为首尾帧生成。
last_image	string	否	尾帧图片 URL，需同时提供首帧图片。
images	string[]	否	多模态生成的参考图片 URL。
videos	string[]	否	多模态生成的参考视频 URL。
audios	string[]	否	多模态生成的参考音频 URL。
content	object[]	否	结构化文本和参考媒体，见下方示例。
generate_audio	boolean	否	是否生成音频，默认为 true；显式 false 会保留。
seed	integer	否	随机种子。
return_last_frame	boolean	否	仅 seedance2.5-global 支持，尽力返回生成视频的尾帧。2.0 系列请省略此字段。
output_format	string	否	仅支持 mp4，默认为 mp4。

参数放在顶层。size 是 resolution 的兼容别名；ratio 是 aspect_ratio 的别名，其中 adaptive 等价于 auto。别名与标准字段同时传入时，值必须一致。

海外版不支持 watermark、Draft、视频编辑或延长、联网搜索及国内版的高级控制。不支持的字段即使值为 false 也应省略。

文生视频示例

curl -X POST "https://api.uniall.ai/v1/videos" \
  -H "Authorization: Bearer <UNIAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-global",
    "prompt": "A small sailboat crosses a calm lake at sunrise, with a slow cinematic camera movement.",
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9",
    "generate_audio": true
  }'

图片与多模态参考

使用可公开访问的 HTTP(S) 媒体 URL。首尾帧请求可将以下请求体发送到 POST /v1/videos：

{
  "model": "seedance2.0-fast-global",
  "prompt": "Move smoothly from the first frame to the last frame while preserving the product appearance.",
  "resolution": "720p",
  "duration": 5,
  "image": "https://example.com/first.png",
  "last_image": "https://example.com/last.png",
  "generate_audio": false
}

多模态参考可使用 images、videos、audios，也可使用带明确媒体角色的结构化 content：

{
  "model": "seedance2.5-global",
  "resolution": "720p",
  "duration": 6,
  "content": [
    {
      "type": "text",
      "text": "Animate the reference product using the camera movement in the reference video."
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/product.png"
      },
      "role": "reference_image"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://example.com/motion.mp4"
      },
      "role": "reference_video"
    }
  ],
  "generate_audio": true
}

模型系列	图片上限	视频上限	音频上限
2.0 海外版、Fast 海外版、Mini 海外版	9	3	3
2.5 海外版	30	10	10

同一请求不能混用首尾帧输入与多模态参考。2.0 系列使用音频参考时，必须同时提供至少一张图片或一个视频。

响应与任务结果

创建成功后返回任务对象，请保存公共任务 ID：

{
  "id": "task_xxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxx",
  "object": "video.generation.job",
  "model": "seedance2.0-global",
  "status": "queued",
  "progress": 0
}

每隔 3–10 秒调用 GET /v1/videos/{task_id}，直到状态为 completed 或 failed。完整状态、结果字段和鉴权下载方式见视频生成概览。请及时下载返回的 video_url，结果链接可能过期。

超时或创建结果不确定时，不要自动重复提交。已返回任务 ID 时继续查询原任务，确认原请求结果后再决定是否重新创建。

海外素材库

独立的海外素材接口尚待上线。开通前请使用普通 HTTP(S) 参考地址；以下为准备好的调用约定。

操作	方法	接口
创建素材	POST	/v1/materials/global
按 ID 查询素材	GET	/v1/materials/global/{id}
删除素材	DELETE	/v1/materials/global/{id}

素材接口不传模型名称，不提供素材列表。创建时传入 URL、类型、可选名称和 Idempotency-Key 请求头：

curl -X POST "https://api.uniall.ai/v1/materials/global" \
  -H "Authorization: Bearer <UNIAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: global-reference-001" \
  -d '{
    "url": "https://example.com/product.png",
    "type": "image",
    "name": "product-reference"
  }'

type 支持 image、video、audio，name 最多保留 50 个字符。幂等键为 1–191 个不含空格的可见 ASCII 字符。重试保持相同键和请求体；上传结果不确定时不要换新键重新上传。

创建返回 HTTP 202 和 gmat-* ID。按 ID 查询，等 status=available 后，将返回的 uri 放入对应媒体字段：

{
  "id": "gmat-example",
  "object": "material",
  "type": "image",
  "name": "product-reference",
  "status": "available",
  "uri": "asset://gmat-example",
  "created_at": "2026-11-09T03:00:00+00:00"
}

{
  "model": "seedance2.0-global",
  "prompt": "Show the reference product turning slowly under soft studio lighting.",
  "resolution": "720p",
  "duration": 5,
  "image": "asset://gmat-example"
}

素材与视频请求使用同一个 UniAll 用户。国内素材 ID 不能用于海外版。四个海外模型间的素材复用以实际可用性为准，跨模型复用尚未验收；不承诺固定有效期。素材被生成任务引用时，需等任务结束后才能删除。

计费说明

以 UniAll 中所选模型的当前价格为准。分辨率、时长和参考视频输入可能影响费用，最终以用量记录为准。

常见错误

• 遗漏 -global，或将后缀放在错误位置。
• 缺少 resolution、duration，或传入 duration: "auto"。
• Fast/Mini 使用 1080p、4k，或 2.5 海外版使用 4k。
• 传入不支持的 watermark、draft 等字段。
• 混用首尾帧与多模态参考，或参考数量超限。
• 使用国内素材、其他用户的素材或尚未就绪的素材。