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	是	生成视频的描述词
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	否	portrait 竖屏 landscape 横屏 sora-2模式下，视频分辨率大体为 720 * 1280，横屏同理 sora-2-pro模式下，竖屏视频分辨率大体为 1024 *1792，横屏同理
duration	integer	否	视频时长，25s只在 sora-2-pro 模型下生效 支持范围 10 15 25 sora-2模型下默认10s sora-2-pro模型下默认15s
size	string	否	是否高清（只有sora-2-pro模式下支持，25s时长下只能选择标准清晰度） small：标准清晰度 large：HD清晰度 默认：small
character_url	string	否	创建角色需要的视频链接 注意视频中一定不能出现真实人物，否则失败
character_timestamps	string	否	视频角色出现的秒数范围，格式{start},{end}, 注意 end-start 的范围 1～3秒（结束时间减去开始时间范围为1到3秒）。 示例：1,3
private	boolean	否	生成视频是否设置隐私， true - 隐私访问 false - 公开访问 默认 true
hookUrl	string	否	回调地址，任务完成或失败将通过请地址进行通知，通知数据结构与fetch结构一致。如果未设置，则需要请求fetch接口进行查询。

Response

200

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

400

创建角色

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

创建角色用于生成视频

Headers

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

Query参数

参数	类型	是否必须	描述
timestamps	String	是	单位秒，例如 ‘1,2’ 是指视频的1～2秒中出现的角色，注意范围差值最大 3 秒最小 1 秒
url	String	是	视频中包含需要创建的角色
hookUrl	string	否	回调地址，任务完成或失败将通过请地址进行通知，通知数据结构与fetch结构一致。如果未设置，则需要请求fetch接口进行查询。

Response

200

{
    "status": "SUCCESS",
    "message": "success",
    "data": {
        "jobId": "35969151-9a1d-42d1-ba2d-53d5b8bf1f00"
    }
}

查询任务结果

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

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

Headers

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

Body

参数	类型	是否必须	描述
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
    }
}

200(创建角色)

异步回调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	实际消耗额度