# OpenAI Sora 2 Pro

> OpenAI's Most advanced synced-audio video generation

- **Provider**: replicate
- **Model ID**: openai/sora-2-pro
- **Category**: video_generation
- **Credits**: 2790 per request
- **Pricing Type**: input_based

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `openai_api_key` (string, optional): Optional: Your OpenAI API key. If you use your own OpenAI API key, you will be charged directly by OpenAI.
- `input_reference` (string, optional): An optional image to use as the first frame of the video. The image must be the same aspect ratio as the video.
- `prompt` (string, **required**): A text description of the video to generate
- `seconds` (integer, optional): Duration of the video in seconds (Default: `4`; Options: `4`, `8`, `12`)
- `aspect_ratio` (string, optional): Aspect ratio of the video (Default: `portrait`; Options: `portrait`, `landscape`)
- `resolution` (string, optional): Resolution quality. Standard is 720p (1280x720 landscape, 720x1280 portrait). High is 1024p (1792x1024 landscape, 1024x1792 portrait). (Default: `standard`; Options: `standard`, `high`)

## Example Request

```json
{
  "model": "openai/sora-2-pro",
  "input": {
    "aspect_ratio": "portrait",
    "seconds": 4,
    "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",
    "resolution": "standard"
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

url

## Tags

openai, sora, video-generation, text-to-video, image-to-video, audio, premium, flagship

## Documentation

https://replicate.com/openai/sora-2-pro