开桥原生 API: 视频生成 ​

提交生成请求： ​

POST https://openqiao.com/api/v1/videos

轮询任务状态： ​

GET https://openqiao.com/api/v1/videos/{jobId}

该接口以原生（原厂）协议生成视频，请求体直接采用供应商原生的 content 数组结构，无需 SDK，使用标准 Authorization: Bearer 鉴权。如果你希望通过 Google Vertex AI 协议调用同一批模型，请参考 Generate Videos（Vertex AI 协议）。

支持的模型 ​

鉴权参数 ​

Authorization string * ​

请求头，格式为 Bearer $OPENQIAO_API_KEY，使用开桥 API 密钥进行身份鉴权。

提交请求体参数 ​

model string * ​

用于视频生成的模型 slug，格式为 {provider}/{model}，例如 bytedance/doubao-seedance-2.0。

content array * ​

内容项数组，每一项通过 type 区分类型，可包含文本提示词与多种参考媒体。

type string * ​

内容项类型，可选值：text | image_url | video_url | audio_url。

text string ​

当 type 为 text 时使用，作为视频内容的文本提示词。若传入多个 text 项，会按顺序拼接。

role string ​

媒体项的角色，按 type 取值：

• image_url：first_frame（首帧，省略 role 时的默认值）、last_frame（尾帧）、reference_image（参考图）。
• video_url：reference_video（参考视频）。
• audio_url：reference_audio（参考音频，部分模型支持）。

image_url / video_url / audio_url object ​

对应媒体的容器对象，包含单个字段 url：

• url string：媒体地址，支持 http(s) URL，或 data:<mime>;base64,<data> 形式的 Data URI。

resolution string 可选 ​

视频分辨率，例如 480p、720p、1080p。

ratio string 可选 ​

视频宽高比，例如 16:9、9:16、adaptive。

duration integer 可选 ​

视频时长（秒），例如 5。

seed integer 可选 ​

随机种子，-1 表示随机。

generate_audio boolean 可选 ​

是否同时生成音频轨道。

callback_url string 可选 ​

任务完成时回调通知的 URL。

return_last_frame boolean 可选 ​

是否在结果中返回视频的尾帧（content.last_frame_url）。

tools array 可选 ​

原生工具/能力开关，透传给供应商。

frames integer 可选 ​

生成的帧数（部分模型/模式支持）。

watermark boolean 可选 ​

是否为生成的视频添加水印。

Path 参数（轮询） ​

jobId string * ​

提交请求返回的任务 id。

Response ​

提交请求响应 ​

{
  "id": "fff8799f449e4ada8ceebe0079f7c01c",
  "status": "queued",
  "model": "bytedance/doubao-seedance-2.0"
}

id string ​

任务标识符，用于后续轮询。

status string ​

任务状态。提交后通常为 queued。

model string ​

本次任务使用的模型 slug。

轮询响应 ​

status 取值为 queued | running | succeeded | failed。

生成中（queued / running）：

{
  "id": "fff8799f449e4ada8ceebe0079f7c01c",
  "status": "running",
  "model": "bytedance/doubao-seedance-2.0"
}

生成成功（succeeded）：

{
  "id": "fff8799f449e4ada8ceebe0079f7c01c",
  "status": "succeeded",
  "model": "bytedance/doubao-seedance-2.0",
  "content": {
    "video_url": "https://.../result.mp4",
    "last_frame_url": "https://.../last_frame.jpg"
  }
}

• content.video_url string：生成视频的下载 URL。
• content.last_frame_url string：视频尾帧的下载 URL（当请求设置了 return_last_frame 时返回）。
• content 为原样透传的原生结果，除上述字段外还可能包含其它原生字段。

生成失败（failed）：

{
  "id": "fff8799f449e4ada8ceebe0079f7c01c",
  "status": "failed",
  "model": "bytedance/doubao-seedance-2.0",
  "error": {
    "code": "generation_failed",
    "message": "<失败原因>"
  }
}

任务不存在（HTTP 404）：

{
  "error": {
    "code": "404",
    "type": "not_found",
    "message": "Video task '<jobId>' not found"
  }
}

# Step 1: 提交视频生成请求
curl -X POST "https://openqiao.com/api/v1/videos" \
  -H "Authorization: Bearer $OPENQIAO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/doubao-seedance-2.0",
    "content": [
      { "type": "text", "text": "a cat reading a book under soft morning light" }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "seed": -1,
    "generate_audio": true
  }'

# 响应中包含任务 id，用于轮询
# {"id": "fff8799f449e4ada8ceebe0079f7c01c", "status": "queued", "model": "bytedance/doubao-seedance-2.0"}

# Step 2: 轮询任务状态（每 15 秒一次）
curl "https://openqiao.com/api/v1/videos/fff8799f449e4ada8ceebe0079f7c01c" \
  -H "Authorization: Bearer $OPENQIAO_API_KEY"

# 通过 content 数组传入首帧图、参考视频或参考音频
curl -X POST "https://openqiao.com/api/v1/videos" \
  -H "Authorization: Bearer $OPENQIAO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/doubao-seedance-2.0",
    "content": [
      { "type": "text", "text": "The singer performs on stage in sync with the music" },
      { "type": "image_url", "role": "first_frame", "image_url": { "url": "https://example.com/first.png" } },
      { "type": "audio_url", "role": "reference_audio", "audio_url": { "url": "https://example.com/ref.mp3" } }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": true
  }'

// 提交请求后返回（生成中）
{
  "id": "fff8799f449e4ada8ceebe0079f7c01c",
  "status": "queued",
  "model": "bytedance/doubao-seedance-2.0"
}

// 轮询完成后返回
{
  "id": "fff8799f449e4ada8ceebe0079f7c01c",
  "status": "succeeded",
  "model": "bytedance/doubao-seedance-2.0",
  "content": {
    "video_url": "https://.../result.mp4",
    "last_frame_url": "https://.../last_frame.jpg"
  }
}