Sora 2 Pro Video API Documentation

Overview

Generate Sora 2 Pro videos from text prompts or image references with configurable duration, orientation, and quality.

Primary Endpoint

POST/api/v1/soraVideo/start

Start Sora 2 Pro video generation (powered by Kling 3.0)

Request Parameters

Name	Type	Required	Description
name	string	No	Task name (optional)
model_type	enum: text-to-video \| image-to-video	No	Generation mode
prompt	string	Yes	Text prompt for video generation
image_urls	array<string>	No	Required when model_type=image-to-video
aspect_ratio	enum: portrait \| landscape	No	-
duration_seconds	enum: 5 \| 10 \| 15	No	-
quality	enum: standard \| high	No	-
webhook_url	string	No	HTTPS URL to receive task.completed / task.failed notifications. Best-effort delivery, single attempt, no retries; clients should treat the detail API as the source of truth.
webhook_token	string	No	Optional plaintext token returned in the X-A2e-Webhook-Token header so receivers can verify the request originated from a2e.

Request Example

curl -X POST "https://www.a2e.com.cn/api/v1/soraVideo/start" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My generation task",
  "model_type": "image-to-video",
  "prompt": "A cinematic scene with natural motion",
  "image_urls": "https://example.com/reference.jpg",
  "aspect_ratio": "landscape",
  "duration_seconds": "5",
  "quality": "standard",
  "webhook_url": "https://your-server.example.com/a2e/webhook",
  "webhook_token": "a-shared-secret"
}'

Related Endpoints

POST/api/v1/soraVideo/start

Start Sora 2 Pro video generation (powered by Kling 3.0)

GET/api/v1/soraVideo/allRecords

List Sora 2 Pro records

POST/api/v1/soraVideo/batchDetail

Batch get Sora 2 Pro video task details

GET/api/v1/soraVideo/{_id}

Get Sora 2 Pro record detail

DELETE/api/v1/soraVideo/{_id}

Delete Sora 2 Pro record

Responses

200

Task created successfully

401

Unauthorized - Invalid or missing bearer token