| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
model | string | ✅ Yes | sora-2 | sora-2sora-2-pro | The video generation model to use. |
prompt | string | ✅ Yes | - | - | The positive prompt for the generation. |
images | string[] | ✅ Yes | - | - | Images parameter |
size | string | ✅ Yes | small | smalllarge | Video size quality. Options: small, large. Only sora-2-pro supports high-definition (large) |
orientation | string | ❌ No | portrait | portraitlandscape | Video orientation, does not support specific size control. Options: portrait, landscape |
duration | integer | ❌ No | 10 | For sora-2:10、15For sora-2-pro: 10、15、25 | The duration of the generated video in seconds. For sora-2: 10, 15. For sora-2-pro: 10, 15, 25 |
character_url | string | ❌ No | - | - | Non-human IP video URL. |
| Error Code | Error Name | Description |
|---|---|---|
| 401 | Unauthorized | API key is missing or invalid |
| 403 | Forbidden | Your API key doesn’t have permission to access this resource, or insufficient balance for the requested operation |
| 429 | Too Many Requests | You’ve exceeded your rate limit |
| 500 | Internal server error | An internal server error occurred |
| 503 | Content policy violation | Content blocked due to safety concerns (actual status code is 400) |