图生视频

Sora 图生视频接口，用于将上传图片生成短视频。

---

概览

• 请求方法：POST
• 请求路径：/v1/videos
• 内容类型：multipart/form-data
• 分类：视频模型（Video）/sora视频

认证方式

• Header：Authorization: Bearer <token>

---

请求参数

字段	类型	必填	描述
prompt	string	是	文本提示，描述要生成的视频内容
input_reference	file	是	上传的参考图，尺寸必须与 size 完全一致
model	string	否	模型名称，支持 sora-2、sora-2-pro，默认 sora-2
seconds	string	否	视频时长，字符串类型，支持 4、8、12，默认 4
size	string	否	视频尺寸，支持 720x1280、1280x720、1024x1792、1792x1024，1792 尺寸仅支持 sora-2-pro

---

请求示例

curl 示例

curl -X POST "https://api.gpt.ge/v1/videos" \
  -H "Authorization: Bearer $YOUR_TOKEN" \
  -F "prompt=一只凶猛的老虎破门闯入农家小院，土狗吓得跑开，猫咪跳出来击败吓跑老虎。" \
  -F "input_reference=@/path/to/image.png" \
  -F "model=sora-2" \
  -F "seconds=4" \
  -F "size=720x1280"

JavaScript (fetch) 示例

const formData = new FormData();
formData.append('prompt', '一只凶猛的老虎破门闯入农家小院，土狗吓得跑开，猫咪跳出来击败吓跑老虎。');
formData.append('input_reference', fileInput.files[0]);
formData.append('model', 'sora-2');
formData.append('seconds', '4');
formData.append('size', '720x1280');

fetch('https://api.gpt.ge/v1/videos', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN'
  },
  body: formData
})
  .then(res => res.json())
  .then(console.log);

Python 示例（requests）

import requests

with open('/path/to/image.png', 'rb') as f:
    files = {'input_reference': f}
    data = {
        'prompt': '一只凶猛的老虎破门闯入农家小院，土狗吓得跑开，猫咪跳出来击败吓跑老虎。',
        'model': 'sora-2',
        'seconds': '4',
        'size': '720x1280'
    }

    resp = requests.post(
        'https://api.gpt.ge/v1/videos',
        headers={'Authorization': 'Bearer YOUR_TOKEN'},
        files=files,
        data=data
    )

print(resp.json())

---

返回字段说明

字段	类型	描述
id	string	视频任务 ID
object	string	返回对象类型，一般为 video
created_at	integer	创建时间戳
status	string	任务状态
completed_at	null	完成时间，未完成时为 null
error	null	错误信息，成功时为 null
expires_at	null	过期时间，当前返回 null
model	string	使用的模型
progress	integer	任务进度
remixed_from_video_id	null	remix 源视频 ID，当前未使用时为 null
seconds	string	视频时长
size	string	视频尺寸

---

返回示例（200）

{
  "id": "video_68f082321ed08193a4eaf01376fa10bc0284bd663de64dc5",
  "object": "video",
  "created_at": 1760592434,
  "status": "queued",
  "completed_at": null,
  "error": null,
  "expires_at": null,
  "model": "sora-2",
  "progress": 0,
  "remixed_from_video_id": null,
  "seconds": "4",
  "size": "720x1280"
}