Sora API

TTAPI Sora API service(not office formate), Lower price and more faster, Currently the most advanced video model sora2.

Generate Video

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

Generate video use Sora2. Task results is async

Headers

Name	Type	Required	Description
TT-API-KEY	String	true	Your API Key in TT API used for request authorization

Request Body

Name	Type	Required	Description
model	String	true	The generate video model basic model `sora-2` HD model `sora-2-pro`
prompt	String	true	Generate a description for the video. Maximum length is 4000 characters.
referImages	array	false	Base the image then generate, images of people with avatars is not allow exp: `["https://cdn.ttapi.io/demo/2025-03-30/5d17dd5207daeeac86bcecd2d6405a0.jpg", "https://cdn.ttapi.io/demo/2025-03-30/5d17dd5207daeeac86bcecd2d6405a0.jpg"]`
orientation	String	false	Aspect Ratio Available options: `portrait` `landscape` In sora-2 mode, the video resolution is `720 * 1280` or `1280 * 720`. In sora-2-pro mode, the video resolution is `1024 * 1792` or `1792 * 1024`.
duration	Integer	false	Video duration, only support in sora-2-pro model Available options: `10` `15`
hookUrl	String	false	Send a request to the address for task completion or failed notification. If not set you need to request fetch endpoint to get response

Example Response

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

Fetch Sora Result

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

Get the sora generate video task result, the returned json data is same with the return in hookUrl

Headers

Name	Type	Description
TT-API-KEY*	String	Your API Key in TT API used for request authorization

Request Body / Query param

Name	Type	Required	Description
jobId	String	true	ed1a1b01-7d64-4c8a-acaa-71185d23a2f3

Async callback & fetch json

{
    "status": "SUCCESS",
    "message": "success",
    "jobId": "2615bbab-7c9a-4699-87b3-9292c2012417",
    "data": {
        "model": "sora-2",
        "prompt": "Style: Modern advertising, realism, iPhone photography Scene: A cafe in the city center. A man in a light-colored shirt opens his laptop and drinks coffee. Camera: Close-up, slight zoom Lighting: Soft light from the window, reflections on the table Action: Looking up, smiling, typing",
        "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
    }
}

Producer API Recraft API