Sora API

TTAPI Sora API 接口服务，目前集成了市场上最为领先的视频大模型sora2。

创建视频 [非官转]

POST https://api.ttapi.io/sora/generations

通过文字&图片生成视频

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
model	string	是	sora-2 普通模式 sora-2-pro 高清模式
prompt	string	是	生成视频的描述词 最大支持4000字符
referImages	array	否	垫图数组，不可传递真实的带有头像的人物图像，或者任何存在的美国产品的Logo。OpanAI规定，会因为不过审导致任务失败。 示例： [ "https://cdn.ttapi.io/demo/2025-03-30/5d17dd5207daeeac86bcecd2d6405a0.jpg", "https://cdn.ttapi.io/demo/2025-03-30/5d17dd5207daeeac86bcecd2d6405a0.jpg" ]
orientation	string	否	视频比例，只在 sora-2-pro 模型下生效 portrait 竖屏 landscape 横屏 sora-2模式下，视频分辨率大体为 720 * 1280 sora-2-prp模式下，竖屏视频分辨率大体为 1024 *1792，横屏同理
duration	integer	否	视频时长，只在 sora-2-pro 模型下生效 支持范围 10 15 sora-2模型下默认10s sora-2-pro模型下默认15s
hookUrl	string	否	回调地址，任务完成或失败将通过请地址进行通知，通知数据结构与fetch结构一致。如果未设置，则需要请求fetch接口进行查询。

Response

200

{
  "status": "SUCCESS",
  "message": "",
  "data": {
    "jobId": "ed1a1b01-7d64-4c8a-acaa-71185d23a2f3"
  }
}

400

{
  "status": "FAILED",
  "message": "error message",
  "data": {}
}

查询视频结果

GET https://api.ttapi.io/sora/fetch

通过jobId查询当前视频生成结果

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Query参数

参数	类型	是否必须	描述
jobId	String	是	生成的视频的jobId

Response

200

{
    "status": "SUCCESS",
    "message": "success",
    "jobId": "2615bbab-7c9a-4699-87b3-9292c2012417",
    "data": {
        "model": "sora-2",
        "prompt": "风格：现代广告，现实主义，iPhone 摄影 场景：市中心的一家咖啡馆。 一个穿着浅色衬衫的男人打开笔记本电脑喝咖啡。 摄像机：特写，轻微变焦 灯光：来自窗户的柔和光线，桌子上的反射 动作：抬头 微笑 打字",
        "referImages": null,
        "videoUrl": "https://cdn.ttapi.io/other/2025-10-10/35f50ab8-6f98-493d-94c4-5587ca246bb3.mp4",
        "quota": "3",
        "finishTime": "2025-10-10 07:24:42",
        "hookUrl": null
    }
}

异步回调JSON结构 HookUrl JSON

异步回调josn结构与fetch接口查询返回结构一致

{
    "status": "SUCCESS",
    "message": "success",
    "jobId": "2615bbab-7c9a-4699-87b3-9292c2012417",
    "data": {
        "model": "sora-2",
        "prompt": "风格：现代广告，现实主义，iPhone 摄影 场景：市中心的一家咖啡馆。 一个穿着浅色衬衫的男人打开笔记本电脑喝咖啡。 摄像机：特写，轻微变焦 灯光：来自窗户的柔和光线，桌子上的反射 动作：抬头 微笑 打字",
        "referImages": null,
        "videoUrl": "https://cdn.ttapi.io/other/2025-10-10/35f50ab8-6f98-493d-94c4-5587ca246bb3.mp4",
        "quota": "3",
        "finishTime": "2025-10-10 07:24:42",
        "hookUrl": null
    }
}

结果参数详解

参数	详解
status	结果状态， ON_QUEUE：执行中 SUCCESS：成功 FAILED：失败
videoUrl	视频地址，国内可直接访问
quota	实际消耗额度