使用帮助

使用 OpenAI Videos 协议调用本站已配置的视频模型。model 填本站模型 code。

端点

方法	路径	用途
POST	`/v1/videos`	创建异步视频任务
GET	`/v1/videos/{video_id}`	查询本地任务状态
GET	`/v1/videos/{video_id}/content`	流式下载已完成的视频

三个接口均使用 Authorization: Bearer <本站 API Key>。查询和下载必须使用创建任务的同一把 Key。

创建任务

curl https://51kik.com/v1/videos \
  -H 'Authorization: Bearer sk-xxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{"model":"doubao-seedance-1-0-pro-250528","prompt":"一只金毛犬在草地上奔跑","seconds":"8","size":"1280x720"}'

必填 model、prompt；seconds 默认 "4"，size 默认 "720x1280"。时长必须为正整数，尺寸格式为 宽x高；实际支持的时长、尺寸由所选模型决定。

JSON 图生视频使用 input_reference: {"image_url":"https://example.com/frame.png"}，也可传图片 Data URL。multipart 请求可通过 -F 'input_reference=@frame.png' 上传一张 PNG、JPEG 或 WebP，最大 20 MiB。原生视频驱动不支持 file_id，不会静默忽略该参数。upstream_options 可传驱动私有参数，但其中的 duration 必须与 seconds 一致。

响应为 OpenAI 风格 video 对象，id 是本站不透明任务标识，状态为 queued、in_progress、completed 或 failed。原生驱动未提供真实进度时，进行中的 progress 为 0，完成后为 100。

curl https://51kik.com/v1/videos/VIDEO_ID \
  -H 'Authorization: Bearer sk-xxxxxxxx'

curl https://51kik.com/v1/videos/VIDEO_ID/content \
  -H 'Authorization: Bearer sk-xxxxxxxx' --output video.mp4

选路与计费

先走本站 video 专用选路，命中后复用 Seedance、百炼、MiniMax 和同程序供应商驱动及其现有计费。只有模型不存在或普通选路没有候选时，才进入通用模型选路，按 OpenAI Videos 协议访问配置的上游。鉴权、余额、模型白名单、严格分组和渠道绑定错误不会触发回退；原生驱动执行失败也不会跨分支回退。异步创建一旦提交就不再尝试其它候选；收到 5xx 或断线也不自动重建任务。已提交后的失败响应包含 x-should-retry: false，防止 OpenAI SDK 自动重放创建请求。

通用回退沿用通用模型消费链路，只记录上游实际返回的 token usage。没有 token usage 时不把秒数推算为 token，也不凭空产生按秒费用。缓存读取和推理 token 明细按既有通用公式分别计价；上游提供非法计量时任务会失败并保留原始响应，避免错误收费。需要按视频时长或模态 token 计费的模型应配置在 video 专用驱动中。

创建成功后后台持续轮询并落消费 Outbox，不依赖客户端继续查询；查询和下载不会重新生成或重复计费。通用任务固定创建时的上游地址和密钥来源，原密钥删除或更换后会报错，不切换其它凭证。

能力边界

本入口实现创建、查询、视频下载。原生驱动下载仅支持 variant=video；通用上游可按其能力支持 thumbnail 和 spritesheet。下载允许已配置上游的同源地址，其他结果地址及跨源跳转必须解析为公网地址。列表、删除、编辑、延长、角色和 Batch 不属于本入口当前支持范围。视频文件的可下载期限仍受供应商限制。