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

Check generation result

POST
/api/video-generations/check-result
Fetch by taskId in real time and write back to the database.

Request

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

Example
{
    "taskId": "task_1234567890"
}

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 --location --request POST '/api/video-generations/check-result' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "taskId": "task_1234567890"
}'

Responses

🟒200
application/json
Success response with task status.
Body

Example
{
    "code": 0,
    "message": "Success",
    "data": {
        "status": "running",
        "progress": 35,
        "result_url": "https://your-domain.com/storage/videos/xxx.mp4",
        "result_urls": [
            "https://your-domain.com/storage/videos/xxx.mp4"
        ],
        "failure_reason": "",
        "error_message": null,
        "credits_refunded": false,
        "refund_trans_no": null,
        "result_pid": "s_xxx",
        "result_pids": [
            "s_xxx"
        ],
        "metadata": {
            "remixTargetId": "s_prev",
            "characters": [
                {
                    "url": "https://.../hero.mp4",
                    "timestamps": "0,3"
                }
            ]
        }
    }
}
🟠400
🟠401
🟠403
🟠404
πŸ”΄500
Modified atΒ 2025-12-22 14:03:25
Previous
Generate video
Next
Get credits and VIP status
Built with