> ## Documentation Index
> Fetch the complete documentation index at: https://docs.routerbase.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAI Sora 2 API

> Quickstart for OpenAI Sora 2 — text-to-video and image-to-video at 720p, with synchronized audio.

## Overview

**OpenAI Sora 2** is OpenAI's flagship video-generation model on
RouterBase. It produces short clips (4 / 8 / 12 seconds) at 720p with
synchronized audio and notably sharper realism than Sora 1. Both
**text-to-video** and **image-to-video** are supported.

|                     |                                   |
| ------------------- | --------------------------------- |
| **Provider**        | OpenAI                            |
| **Family**          | `sora-2`                          |
| **Modality**        | Video                             |
| **Supported tasks** | `text-to-video`, `image-to-video` |
| **Resolution**      | 720p                              |
| **Durations**       | 4s, 8s, 12s                       |

Need 1080p output? See the higher-fidelity
[Sora 2 Pro](/openai-sora-2-pro-api/quickstart) tier.

## Endpoint

```http theme={null}
POST https://routerbase.com/v1/videos/generations
```

This is an **async** endpoint. The POST returns immediately with
`{id, status: "pending"}`; poll `GET /v1/videos/generations/{id}`
until `status` is `success` (with `data: [{url}]`) or `failed`.

## Playground

Try Sora 2 live without writing code:

* [Sora 2 — Text-to-Video](https://routerbase.com/models/openai/sora-2/text-to-video)
* [Sora 2 — Image-to-Video](https://routerbase.com/models/openai/sora-2/image-to-video)

## Supported Tasks

* [`text-to-video`](/openai-sora-2-api/text-to-video) — generate a clip
  from a text prompt only. Reachable via `openai/sora-2-t2v`.
* [`image-to-video`](/openai-sora-2-api/image-to-video) — animate a
  reference image with a text prompt. Reachable via
  `openai/sora-2-i2v`.

## Pricing

720p only — `duration` is the sole price lever.

| Duration | Text-to-Video | Image-to-Video |
| -------- | ------------- | -------------- |
| 4s       | \$0.38        | \$0.38         |
| 8s       | \$0.76        | \$0.76         |
| 12s      | \$1.14        | \$1.14         |

## Authentication

All requests require a Bearer token — create one at
[routerbase.com/api-key](https://routerbase.com/api-key).

```bash theme={null}
curl https://routerbase.com/v1/videos/generations \
  -H "Authorization: Bearer $ROUTERBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "openai/sora-2-t2v", "prompt": "…"}'
```
