视频

提交视频生成请求

提交异步的视频生成任务。立即返回 202 与任务 id(vjob_ 开头);之后以 GET /api/v1/videos/{id} 轮询直到 status 为 completed,再从 unsigned_urls 下载。计费:提交时按 duration × resolution 预留额度,完成时按实际交付秒数结算(轮询响应的 usage.cost)。

POST/api/v1/videos

验证

Authorization必填

string · header

在 Authorization 标头以 Bearer token 传入 API 密钥。

Body

model必填

string

视频生成模型 ID(供应商前缀格式)。

Example: "alibaba/wan2.7-t2v"

prompt必填

string

描述视频内容的文本提示。

duration

integer

视频长度(秒)。默认 2。各模型有自己的上下限——例如参考图生视频(r2v)限 2–10 秒;超出范围在扣款前就返回 400。

1–600 (per-model bounds are tighter; reference-to-video: 2–10)

Example: 5

resolution

string

输出画质档位,默认 "720p"。各模型支持的档位不同;发送不支持的档位会在扣款前返回 400,错误消息会列出该模型支持的档位。

480p720p1080p

Example: "720p"

aspect_ratio

string

长宽比。常见值:"16:9"、"9:16"、"1:1"、"4:3"、"3:4";实际可用集合依模型而定(部分模型另支持 "21:9" 等宽幅)。不支持的组合在扣款前返回 400;有输入画格的模式以画格为准而忽略此字段。

16:99:161:14:33:43:22:321:99:21

Example: "16:9"

frame_images

array

首/尾关键画格图片(image-to-video、keyframe-to-video)。接受纯 URL 字符串,或对象 { type: "image", image_url: { url }, frame_type: "first" | "last" }。

input_references

object[] | string[]

参考素材(reference-to-video):引导生成的参考项,建议用对象形式 { type: "image", image_url: { url } }(也接受纯 URL 字符串,视为图片参考)。图片参考支持面最广;音频/视频参考对象会原样转发,仅在支持它们的模型上生效,其他模型只取图片参考。仅具 r2v 能力的模型支持此字段。

input_video

string | object

来源视频(视频编辑模型专用,BazaarLink 扩充字段)。接受 URL 字符串、{ video_url: { url } } 或 { url }。非视频编辑模型会忽略。编辑计费按「来源秒数 + 输出秒数」。

generate_audio

boolean

是否同时生成音频。仅支持音频的模型有效;含音频的秒数费率较高。

watermark

boolean

是否在输出加上水印。默认 false——BazaarLink 会主动关闭上游的默认水印,除非你明确传 true。

seed

number

采样种子。是否保证可重现依模型而定。

callback_url

string

任务终态时调用的 webhook 网址,免除轮询。仅接受 HTTPS,且会做 SSRF 安全检查(禁止内网/私有地址),不合格在扣款前就返回 400。只会在赢得该任务终态判定的那次调用触发,恰好一次;失败会重试(2 次,间隔 2 秒/8 秒),全部失败也不影响计费或任务本身状态。v1 没有签名——回调只是提示,收到后请带你的 API 密钥调用 GET /v1/videos/{id} 回查确认状态与金额再采取行动。⚠️ webhook payload 里的 unsigned_urls 是绝对网址,跟轮询响应里的相对路径不同。

https:// only, ≤2048 chars

深度指南 →

POST /api/v1/videos

1
2
3
4
5
6
7
8
9
10
curl https://bazaarlink.ai/api/v1/videos \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan2.7-t2v",
    "prompt": "a corgi surfing a wave at sunset",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

响应示例

任务已受理(异步)。用返回的 polling_url(即 GET /api/v1/videos/{id})轮询状态,建议间隔 ≥5 秒。

1
2
3
4
5
{
  "id": "vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk",
  "status": "pending",
  "polling_url": "/api/v1/videos/vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk"
}