视频模型调用 · 文档

视频模型没有同步接口 —— 提交任务拿 task_id，轮询到出片。协议跟图片那条完全一样，区别只在参数和计费方式。

提交任务

curl https://api.lk888.ai/v1/media/generate \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq3",
    "prompt": "阳光洒在湖面上，一只白鹭贴着水面缓缓滑过",
    "params": {
      "aspect_ratio": "16:9",
      "duration": "4",
      "resolution": "1080p"
    }
  }'

{ "code": 200, "data": { "task_id": 12345 }, "msg": "Task created successfully" }

轮询结果

curl "https://api.lk888.ai/v1/skills/task-status?task_id=12345" \
  -H "Authorization: Bearer $OPENAI_API_KEY"

间隔 5 秒，is_final = true 停。成品在 result_url（.mp4），result_type 是 video，cost 是这次结算的金额。视频生成比图片慢，轮询的耐心给够。

params 怎么填

每个模型的参数名都不一样 —— aspect_ratio / ratio、resolution、duration、model_variant（turbo / standard）、off_peak 等等都有。先查再用：

curl https://api.lk888.ai/v1/skills/models/viduq3 \
  -H "Authorization: Bearer $OPENAI_API_KEY"

params 数组里逐个写了参数名、类型、是否必填、可选值。select 的值必须从 options 里挑。

支持的模型

75 个，9 家厂商。协议一样，参数各不同：

字节跳动 —— Seedance 2.5 与 2.0 全系：文生视频 / 参考生 / 全能参考 / 首尾帧 / 满血版，每个形态都有「按次」和「按秒」两档

阿里巴巴 —— Wan 3.0 全系（文生视频 / 参考生 / 全能参考 / 首尾帧）、Wanxiang 2.6 与 2.7（参考生 / 首帧 / 首尾帧 / 视频续写）、HappyHorse 1.1 与 1.0（文生视频 / 首帧 / 参考生 / 视频编辑）、Wanxiang-Video 换脸

快手 —— Kling-V3 视频、Kling-Omni（参考生 / 首尾帧 / 视频参考）、Kling 动作控制（V3）、Kling 数字人

MiniMax —— Hailuo H3 与 H3 Max（文生视频 / 参考生 / 首尾帧 / 全能参考）、Hailuo H3 超分到 2K

vidu —— Vidu Q2 / Q3 / Q3 Turbo / Q4 Preview（文生视频 / 参考生）、Vidu Q3 短剧、VIDU 漫剧、VIDU 音乐 MV

Google —— Omni Flash（10 秒 / 首尾帧）、Omni 1.1、omni-flash、VO3.1

xAI —— Grok-video-3 / 3.5

PixVerse —— Pix V5.6 与 V6（首尾帧 / 参考生）、Pix C1（参考生 / 首尾帧）

星河智云 —— 视频超分

特别注意

视频文件必须用公网直链 URL，不支持内联 base64（图片和音频才支持）。参考图、首尾帧也一样走 URL
按次还是按秒，模型名里就写着 —— 「按秒」的按实际时长扣费，「按次」的一次一个价。时长取值各模型不同：4/6/8/10 秒、1–15 秒、3–10 秒、30 秒长视频都有
分辨率和比例也是模型自己定 —— 480p / 540p / 720p / 1080p / 2K / 4K、16:9 / 9:16 / 1:1 / 4:3 / 3:4 都有，但具体给哪些值看 options
提交前查余额 —— GET /v1/skills/balance。按秒计费的模型余额不够会直接拒
一个请求建一个任务，没有 count 参数
失败看 error_code：内容违规 / 参数不对 / 余额不足 / 超额 / 密钥配置 —— 重发还是失败；线路没了 / 上游抽风 / 服务端错误 —— 等一下可以重试
分组路由由密钥的调度策略决定，请求体里的 channel_group 和请求头 X-Channel-Group 都不改路由

方舟兼容格式

视频另有一套火山方舟（Ark）兼容格式，端点路径和参数名都不同，用官方方舟 SDK 更省事，见创建文本视频任务。