视频、图片异步任务怎么接入？

以 Seedance 2.0 为例，选好线路和 Key，提交任务、查询状态，再下载生成结果。

异步任务：提交 → 用任务 ID 查询 → 完成后下载。 提交成功只代表已受理，还没有生成完。

直接返回图片的是同步接口；先返回任务 ID 的才按本篇操作。 参数以所选线路文档为准。

1. 选线路，为它准备 Key

进入 Seedance 2.0 模型页，选择 Seedance2.0 · 创境渠道T线路，点击 快速接入。

在右侧选择或新建这条线路的 Key，不能混用其他线路的 Key。操作见 快速创建 API Key。

示例模型 ID 为 seedance-2.0-pro，先生成 4 秒、1080p、16:9 的视频，再尝试参考素材。生成会计费，价格以线路页面为准。

2. 接入项目：任选一种

让 AI 帮你接入

选择 AI 接入 → 复制提示词，交给项目中的 AI 编码助手。它会按线路文档实现提交、查询和获取结果。

Key 从环境变量 ORBIS_API_KEY 读取，不写进源码，只交给你信任的工具。

仅填 Key、改模型名还不够，应用必须支持任务提交和查询。

自己写代码接入

选择 代码接入 获取完整示例。以下 cURL 适用于 macOS / Linux；Windows 可复制线路文档的 Python 或 Node.js 代码。

设置 Key，然后只提交一次：

export ORBIS_API_KEY='替换为这条线路的完整Key'
curl -X POST 'https://api.orbiorbi.com/v1/tasks' \
  -H "Authorization: Bearer $ORBIS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"seedance-2.0-pro","prompt":"一片绿叶在微风中轻轻摇动，固定镜头，自然光。","duration_sec":4,"resolution":"1080p","aspect_ratio":"16:9","enable_audio":true}'

响应如下，保存实际返回的 id，供后续查询：

{"id":"task_example","status":"queued","progress":0}

3. 查询到完成，再下载

把 TASK_ID 换成实际 id，用提交时的同一枚 Key 查询：

curl 'https://api.orbiorbi.com/v1/tasks/TASK_ID' \
  -H "Authorization: Bearer $ORBIS_API_KEY"

这条线路建议 每 20 秒查询一次，直到完成或失败：

完成后，这条线路的视频地址在 metadata.url：

{"id":"task_example","status":"completed","progress":100,"metadata":{"url":"https://example.com/result.mp4"}}

打开实际地址下载，或替换下面的地址后执行；无需向下载地址发送 Orbis Key：

curl -L '替换为metadata.url中的实际地址' -o result.mp4

超时不等于失败。 保留 ID 继续查，不要重复提交，以免创建多笔任务。提交超时且没拿到 ID 时，先核对任务记录或联系支持。

4. 图片任务或其他线路，怎么套用？

沿用上述流程，重新核对三项：

• 接口与字段：按目标线路文档填写，不能只改示例的模型名。
• 素材与规格：本例参考图用 input_images，填公网可下载的 URL；其他线路的字段、清晰度、时长及限制可能不同。
• 结果与状态：图片可能返回 URL 或 base64、单张或多张。是否查询、终态及结果字段按各自文档，不都用 metadata.url。

常见卡点

完整字段与自动轮询代码见 代码接入 或 本示例线路文档。本文依据 2026-10-20 的生产文档。