APIVideo Generation
Sora 2
Configurable fields and supported values for sora-2.
Model ID
sora-2
Capabilities
| Capability | Supported value |
|---|---|
| Text-to-video | Yes |
| Image-to-video | Yes |
| Multi-image / reference video | No |
| Start/end frames | No |
| Motion transfer | No |
| Audio input | No |
| Generated audio | Yes; synchronized with the video |
| Resolution | 720p |
| Aspect ratio | 16:9, 9:16 |
Duration (seconds) | 4, 8, 12, 16, or 20 |
Configurable fields
| Field | Required | Notes |
|---|---|---|
model | Yes | Must be sora-2. |
prompt | Yes | Video description or transformation instruction. |
seconds | No | Must use the supported range or fixed values above. |
input_reference | Conditional | Single reference image URL; provide for image-to-video and omit for text-to-video. |
size | No | Legacy pixel dimensions. Prefer extra_body.resolution and extra_body.aspect_ratio. |
extra_body.resolution | No | Select one supported resolution above. |
extra_body.aspect_ratio | No | Select one supported ratio above; omit when the ratio follows the reference image. |
Generated videos can be passed to POST /v1/videos/edits. The legacy Remix endpoint is deprecated. No other model-specific creation fields are supported.
Do not send unsupported audio, frame, reference, or private provider fields. Account availability is determined by the model list API.
Example
{
"model": "sora-2",
"prompt": "A cinematic tracking shot through a coastal city",
"seconds": 4,
"extra_body": {
"resolution": "720p",
"aspect_ratio": "16:9"
}
}Last updated on