视频生成

与 OpenAI Videos 接口兼容。不走对话协议——它是独立的视频端点， 按秒计费，没有流式返回。

请求头

请求参数

application/json 与 multipart/form-data 两种请求体都认。 带参考图时用 multipart（input_reference 是文件字段），纯文生视频用 JSON。

响应

{
  "id": "video_9f2c1ab84d7e4c1fa0b3d5e7",
  "object": "video",
  "model": "your-video-model",
  "status": "completed",
  "progress": 100,
  "created_at": 1757462400,
  "completed_at": 1757462712,
  "expires_at": 1757548800,
  "seconds": "8",
  "size": "1280x720",
  "url": "https://.../generated-video.mp4"
}

取片、查询与删除

• 任务只对创建它的那把 Key 可见。换一把 Key 查同一个 id 返回 40402，与不存在同样对待。
• DELETE 只删平台侧的任务记录。上游的成品不归平台管，删不掉也不会因此退费。
• 未完成的任务取 /content 返回 409。

上游协议转换

你发出的永远是这一套请求体；各家上游的差异由网关抹平。 同一个 prompt + seconds + size + input_reference，网关会按目标模型 实际绑定的厂商协议，转成对方要的官方请求体、按对方的节奏轮询、 再把终态归一化成上面那个 video 对象。

与 /v1/chat/completions 的关系

视频模型也可以继续用 Chat Completions 端点调用， 请求体里带 prompt 与时长即可，返回的是 {"status":"done","video":{"url":…}}。 两条路走的是同一条上游链路、同一套计费，区别只在客户端表面：

• 用标准 SDK 的选 /v1/videos。client.videos.create() 直接能用。
• 已经接好 chat 端点的不必改。行为一字未变。

调用示例

# 视频要跑几分钟，关掉 curl 的超时
curl --max-time 0 https://www.apigoto.com/v1/videos \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $APIGOTO_API_KEY" \
  -d '{
    "model": "your-video-model",
    "prompt": "一只橘猫跳上窗台，阳光穿过纱帘",
    "seconds": "8",
    "size": "1280x720"
  }'

# 不要手写 Content-Type，让 curl 自己带 boundary
curl --max-time 0 https://www.apigoto.com/v1/videos \
  -H "Authorization: Bearer $APIGOTO_API_KEY" \
  -F "model=your-video-model" \
  -F "prompt=让这张照片里的猫动起来" \
  -F "seconds=8" \
  -F "input_reference=@cat.png"

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://www.apigoto.com/v1",
    api_key=os.environ["APIGOTO_API_KEY"],
    # 出片要几分钟，SDK 默认 10 分钟超时不一定够
    timeout=1800,
)

video = client.videos.create(
    model="your-video-model",
    prompt="一只橘猫跳上窗台，阳光穿过纱帘",
    seconds="8",
    size="1280x720",
)
print(video.status, video.id)

# 成品地址在扩展字段 url 上；也可以走 content 取字节
content = client.videos.download_content(video.id)
content.write_to_file("out.mp4")

限流与计费

• 视频有独立的限流维度。策略里的「视频数量」与请求次数、Token、图片各自独立计窗， 锚点也是独立的——见 限流、配额与并发。
• 超限返回 42902。视频维度没有专属错误码， message 是 rpm limit exceeded，别被误导。
• 按秒计价，不按 token。价格取 video_price 乘 seconds，倍率链与对话调用一致，见 计费、Credits与订阅。
• 计费按声明秒数，不按实际产出。调用日志里另记实际产出时长，两者可能不同。
• 断线不退费。任务一提交上游就开始消耗，客户端中途断开时网关会继续把它跑完并如实记账。

可能的错误

完整清单见 错误码总表。