API Overview
Getting started with the Sora 2 Video API
Introduction
The Sora 2 Video API allows you to integrate AI video generation capabilities into your applications. With our API, you can programmatically create videos from text prompts or images, remove watermarks, and generate storyboards.
Text to Video
Generate videos from text descriptions using state-of-the-art AI models.
Image to Video
Transform static images into dynamic video content.
Pro Features
Access enhanced generation with longer durations and higher quality.
Storyboard
Create multi-shot video sequences from structured prompts.
Quick Start
1. Get Your API Key
Navigate to Settings → API Keys in your dashboard to create an API key.
Keep Your Key Safe
Your API key is shown only once when created. Store it securely and never expose it in client-side code.
2. Make Your First Request
curl -X POST https://soravideo.art/api/v1/sora2/text-to-video \
-H "Authorization: Bearer sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A golden retriever playing in a sunny park"
}'3. Check Task Status
curl https://soravideo.art/api/v1/tasks/task_abc123 \
-H "Authorization: Bearer sk_your_api_key"API Endpoints
| Endpoint | Description | Credits |
|---|---|---|
POST /api/v1/sora2/text-to-video | Generate video from text | 100 |
POST /api/v1/sora2/image-to-video | Generate video from image | 100 |
POST /api/v1/sora2-pro/text-to-video | Pro text to video | 200 |
POST /api/v1/sora2-pro/image-to-video | Pro image to video | 200 |
POST /api/v1/sora2/watermark-remove | Remove watermark | 50 |
POST /api/v1/sora2-pro/storyboard | Generate storyboard | 65-162* |
GET /api/v1/tasks/{taskId} | Get task status | 0 |
POST /api/v1/upload | Upload image | 0 |
GET /api/v1/credits | Get credit balance | 0 |
*Storyboard credits vary by duration: 10s = 65, 15s = 98, 25s = 162
Response Format
All API responses follow a consistent JSON structure:
{
"code": 200,
"msg": "success",
"data": {
"task_id": "task_abc123",
"status": "pending"
}
}{
"code": 401,
"error": "Invalid API key"
}Credit System
Each API call consumes credits based on the endpoint:
- Standard endpoints: 50-100 credits per request
- Pro endpoints: 200-300 credits per request
- Utility endpoints (tasks, upload, credits): Free
Purchase credit packages from the API Keys page:
| Package | Credits | Price |
|---|---|---|
| Basic | 100 | $9.9 |
| Standard | 200 | $14.9 |
| Premium | 500 | $39.9 |
| Enterprise | 1,000 | $69.9 |