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"
    }
}

视频去水印

POST https://api.ttapi.io/sora/no-watermark

去掉sora视频中的水印，转换为无水印的视频

Headers

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

Query参数

参数	类型	是否必须	描述
url	String	是	发布的视频 url 例如 ：https://sora.chatgpt.com/p/s_xxxx
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密钥

Params

参数	类型	是否必须	描述
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(创建角色)

200(去水印)

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	实际消耗额度

创建视频 - [合作商渠道]

合作商渠道prompt中不支持角色使用

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

生成视频接口，入参大体与官方接口保持一致

Headers

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

Body

参数	类型	是否必须	描述
prompt	string	是	生成视频的描述词，最大32000字符，最小1字符
input_reference	string	否	可选的图像参考url，用于指导生成。 注意：上传图片的尺寸要与size参数尺寸保持一致，如果size未设置，上传图片尺寸必须为720x1280
model	string	否	sora-2 sora-2-pro 默认：sora-2
seconds	integer	否	视频时长，支持 4 8 12 默认4
size	string	否	视频尺寸，支持 720x1280 1280x720 1024x1792 1792x1024 默认：720x1280

Response

200

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

查询任务结果 [合作商渠道]

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

合作商渠道获取任务结果

Headers

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

Params

参数	类型	是否必须	描述
job_id	string	是	生成视频接口返回的job_id

Response

200

{
  "status": "SUCCESS",
  "message": "success",
  "jobId": "c0cc8dad-0954-421f-be8d-02eb063b3263",
  "data": {
    "videoId": "video_sorab69aa4c3ccd83d072d3294a839e9935e94edb0da2",
    "model": "sora-2",
    "prompt": "Anime: a wolf running",
    "videoUrl": "https://cdn.ttapi.io/sora/2026-03-06/61651a39-0a6e-418a-862e-67a09f0792c7.mp4",
    "seconds": "4",
    "size": "1280x720",
    "quota": "40",
    "finishTime": "2026-03-06 03:40:22"
  }
}