sora2-api
  1. Video
sora2-api
  • Sora 2 API
    • Video
      • Generate video
        POST
      • Check generation result
        POST
    • Credits
      • Get credits and VIP status
    • Schemas
      • GenerateVideoRequest
      • CharacterItem
      • GenerateVideoResponse
      • CheckResultRequest
      • CheckResultResponse
      • CheckResultData
      • GetCreditsResponse
      • ErrorResponse
  1. Video

Generate video

POST
/api/v1/video/sora-video
Submit a text/image-to-video task, deduct credits, and return taskId.

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Body Params application/jsonRequired

Examples
{
    "model": "sora-2",
    "prompt": "A cinematic shot of a futuristic city at sunset, captured in 4K.",
    "aspectRatio": "9:16"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST '/api/v1/video/sora-video' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "sora-2",
    "prompt": "A cinematic shot of a futuristic city at sunset, captured in 4K.",
    "aspectRatio": "9:16"
}'

Responses

🟢200
application/json
Always returns HTTP 200 with code indicating success or failure.
Body

Examples
{
    "code": 0,
    "message": "ok",
    "data": {
        "id": "task_1234567890"
    }
}
Modified at 2025-12-22 14:03:25
Next
Check generation result
Built with