OpenAI's most advanced synced-audio video generation model. The premium tier of Sora 2 with higher fidelity, up to 1024p resolution, and image-to-video via an input reference frame.
Test this model instantly in the Console Playground โ no code required
Copy usage instructions for Claude, ChatGPT, or other AI
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "openai/sora-2-pro",
"input": {
"prompt": "Scottish Highland coo with ginger fur getting a parking ticket from a Glaswegian police officer speaking in a thick accent, parked on a double yellow line in a small Scottish town",
"seconds": 4,
"resolution": "standard",
"aspect_ratio": "portrait"
}
}'| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | Yes | - | A text description of the video to generate |
seconds | integer | No | 4 | Duration of the video in seconds 4812 |
resolution | string | No | standard | Resolution quality. Standard is 720p (1280x720 landscape, 720x1280 portrait). High is 1024p (1792x1024 landscape, 1024x1792 portrait) standardhigh |
aspect_ratio | string | No | portrait | Aspect ratio of the video portraitlandscape |
input_reference | string | No | - | An optional image to use as the first frame of the video. Must match the video's aspect ratio |
openai_api_key | string | No | - | Optional: your own OpenAI API key (you would then be charged directly by OpenAI). Platform billing here is unchanged either way |
There are 3 ways to provide files for the input_reference parameter:
Attach files directly to POST /v1/predictions/upload. No separate upload step needed.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=openai/sora-2-pro" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:input_reference=@your_file.png"Pass a publicly accessible URL directly. You can also use file_url from the Storage API.
{
"model": "openai/sora-2-pro",
"input": {
"prompt": "your prompt here",
"input_reference": "https://example.com/image.jpg"
}
}Common parameters used when calling POST /v1/predictions.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
model | string | Yes | - | Model identifier |
input | object | Yes | - | Object containing the model-specific parameters from the table above |
output_folder | string | No | - | Folder path for output files (max 256 chars, '..' not allowed) |
webhook_url | string | No | - | Webhook URL to call on completion |
is_public | boolean | No | false | If true, output files are also available via permanent public URLs |
A standard-tier portrait clip with natively generated speech and ambience
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "openai/sora-2-pro",
"input": {
"prompt": "Scottish Highland coo with ginger fur getting a parking ticket from a Glaswegian police officer speaking in a thick accent, parked on a double yellow line in a small Scottish town",
"seconds": 4,
"resolution": "standard",
"aspect_ratio": "portrait"
}
}'A 1024p landscape render at the high tier for final delivery
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "openai/sora-2-pro",
"input": {
"prompt": "Cinematic drone shot gliding over a mist-covered alpine lake at sunrise, golden light breaking through pine forests, gentle wind and distant birdsong",
"seconds": 8,
"resolution": "high",
"aspect_ratio": "landscape"
}
}'POST /v1/predictions