OpenAI
sora-2
OpenAI’s flagship video and audio generation model built on a diffusion transformer architecture, featuring realistic physics simulation, synchronized audio-visual generation, and multi-shot controllability for cinematic content creation.
| Provider | OpenAI |
| Tasks | text-to-video · image-to-video |
| Starting from | 0.3400 USD / call · Pricing details |
POST
sora-2
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Must be one of: sora-2.
Available options:
sora-2 Length must be between 1 and 2000.
Required string length:
1 - 2000Must be one of: 1280x720, 720x1280. Defaults to 1280x720.
Available options:
1280x720, 720x1280 Must be one of: 4, 8, 12. Defaults to 4. Value is in s.
Available options:
4, 8, 12 Must be one of: 720P. Defaults to 720P.
Available options:
720P Previous
Query video taskPoll the status and result of a video generation task created via `POST /v1/video-generation`.
Call this endpoint periodically with the `task_id` returned from task creation. When `status` is `Success`, `file_url` contains the generated video URL.
**Note:** this endpoint's envelope uses `message`, not `msg` as the create task endpoint does. Plan both field names when parsing.
### Recommended polling schedule
Video generation averages 2+ minutes. Use this schedule to balance responsiveness and request cost:
| Phase | Elapsed | Interval |
| --- | --- | --- |
| Initial wait | 0 – 30s | — (no requests) |
| Medium | 30s – 2 min | every 5s |
| Dense | 2 – 4 min | every 3s (peak) |
| Slow | 4 – 8 min | every 8s |
| Idle | 8 – 15 min | every 15s |
| Timeout | > 15 min | stop, report error |
Stop polling when `status` is `Success`, `Failed`, or `Cancelled`.
Next
sora-2