Sora Video Overview

Sora video is suitable for text-to-video, reference images video, role reuse and Remix scenes. MoonNexAI uses the unified video task process: submit task and return to task ID and then get the results by searching for API or Webhook.

Current Model

• sora-v3-fast
• sora-v3-pro

Capacity differences

Models	Recommended scene	duration	resolution	aspect ratio	media assets Reference
sora-v3-fast	Quick text-to-video, image-to-video, reference media assets video and Remix.	5, 10 sec	720P, 1080P	16:9, 9:16, 1:1	Official business uses the customer-owned public network URL; the connection can be used to test URLs with MoonNexAI OSS; mode=asset is not supported.
sora-v3-pro	Better quality video generation, reference media assets and Remix.	5, 10 sec	720P, 1080P	16:9, 9:16, 1:1	Official business uses the customer-owned public network URL; the connection can be used to test URLs with MoonNexAI OSS; mode=asset is not supported.

Current API Behaviour

Item	Current behaviour
Create task	Use POST /v1/videos.
Query task	Use GET /v1/tasks/{task_id} or GET /v1/videos/{task_id}.
media assets Input	Official business directly transmits the publicly owned image URL of the customer; mode=oss is used only for local file coordination.
media assets ID	sora-v3-fast, sora-v3-pro does not support mode=asset.

API Path

Methodology	Path	Purpose
POST	/v1/videos	Create Sora video task.
GET	/v1/tasks/{task_id}	Query task centre state.
GET	/v1/videos/{task_id}	Query video task results.

Common field

field	Annotations
prompt	Video description, suggesting that the subject, action, lens and style be written.
seconds / duration	Video duration.
video_config.aspect_ratio / aspect_ratio / ratio	Video aspect ratio.
video_config.resolution_name / resolution	resolution.
image / image_url	Single first-frame or reference image.
reference_image_url / reference_image_urls	One or more reference images.
first_frame_url / last_frame_url	first frame and last frame.
video / video_url	reference video or Remix-related video input.
content[]	Multimedia content arrays, suitable for combining pictures, videos or audio references.

Example request

curl https://moonnexai.com/v1/videos \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-v3-fast",
    "prompt": "A cinematic city street at night, slow camera movement, realistic lighting.",
    "seconds": "5",
    "video_config": {
      "aspect_ratio": "16:9",
      "resolution_name": "720p"
    }
  }'

task Processing

Phase	Treatment
Successful submission	Saves id or task_id, model name, prompt and media assets URL.
Generating	polling query API, or wait for callback notification.
Completed	Reads the video URL and saves the full query result.
Failed	Saves error information and original request body, which is easy to try again.

Relevant Pages

• Create Video Job
• Query Video Job
• Sora Guide
• Uploading and Media Asset Overview