> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linkmodel.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# sora-2
> OpenAI's flagship video and audio generation model built on a diffusion transformer architecture, featuring realistic physics simulation, synchronized audio-visual generation, and multi-shot controllability for cinematic content creation.
| | |
| --- | --- |
| **Provider** | OpenAI |
| **Tasks** | text-to-video · image-to-video |
| **Starting from** | 0.3400 USD / call · Pricing details |
## OpenAPI
````yaml /openapi/video/sora-2.yaml post /video-generation
openapi: 3.0.3
info:
title: sora-2
version: 1.0.0
description: >-
OpenAI's flagship video and audio generation model built on a diffusion
transformer architecture, featuring realistic physics simulation,
synchronized audio-visual generation, and multi-shot controllability for
cinematic content creation.
servers:
- url: https://api.linkmodel.ai/api/v1
description: Production
security:
- bearerAuth: []
tags:
- name: OpenAI
- name: video
paths:
/video-generation:
post:
tags:
- OpenAI
- video
summary: sora-2
description: >
OpenAI's flagship video and audio generation model built on a diffusion
transformer architecture, featuring realistic physics simulation,
synchronized audio-visual generation, and multi-shot controllability for
cinematic content creation.
| | |
| --- | --- |
| **Provider** | OpenAI |
| **Tasks** | text-to-video · image-to-video |
| **Starting from** | 0.3400 USD / call · Pricing details |
operationId: sora-2
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
model:
type: string
enum:
- sora-2
description: 'Must be one of: sora-2.'
prompt:
type: string
minLength: 1
maxLength: 2000
description: Length must be between 1 and 2000.
first_frame_image:
type: string
format: url
size:
type: string
enum:
- 1280x720
- 720x1280
default: 1280x720
description: 'Must be one of: 1280x720, 720x1280. Defaults to `1280x720`.'
duration:
type: integer
enum:
- 4
- 8
- 12
default: 4
description: 'Must be one of: 4, 8, 12. Defaults to `4`. Value is in s.'
resolution:
type: string
enum:
- 720P
default: 720P
description: 'Must be one of: 720P. Defaults to `720P`.'
responses:
'200':
description: Task accepted and queued for generation.
content:
application/json:
schema:
type: object
properties:
code:
type: integer
example: 0
data:
type: object
properties:
task_id:
type: string
format: uuid
description: Use this id to poll task status.
example: cb6111cf-e89f-4978-b8e3-aa59c21cceff
order_id:
type: string
format: uuid
description: Billing order id.
example: 019da9cf-d1db-78e1-ac23-526774d01193
status:
type: string
enum:
- processing
- succeeded
- failed
example: processing
price:
type: number
description: Charged amount in the model's pricing currency.
example: 0.074
msg:
type: string
example: success
request_id:
type: string
format: uuid
example: 250b66dd-e1fb-4bb6-b5f6-c668efadc35d
'400':
description: Bad request — invalid or missing parameter.
content:
application/json:
schema:
type: object
properties:
code:
type: integer
example: 400
msg:
type: string
example: task_id is required
request_id:
type: string
format: uuid
example: 96be7a7d-3e81-4916-a6b8-19b32773a693
'401':
description: Unauthorized — missing or invalid API key.
content:
application/json:
schema:
type: object
properties:
code:
type: integer
example: 401
data:
type: object
example: {}
msg:
type: string
example: invalid api key
request_id:
type: string
format: uuid
example: bff4c295-c7da-4507-9708-4627cb6373ba
'500':
description: Internal error — task creation failed (e.g. insufficient balance).
content:
application/json:
schema:
type: object
properties:
code:
type: integer
example: 500
msg:
type: string
example: >-
create task failed: billing: code=100601: insufficient
balance
request_id:
type: string
format: uuid
example: 3409f6fb-fa9a-4534-b530-195b5f6f4e32
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
````