Get Async Job | API Docs

Applicable Endpoints

Seedance 2.0 and

Seedance 2.5 use POST https://api.requestbeam.com/v1/video/seedance, which returns data.jobId and requires GET https://api.requestbeam.com/v1/jobs/{id} to retrieve job status and results.

The current GPT-Image-2 Image Generation

endpoint returns results directly through JSON or SSE and does not use Jobs.

Use this endpoint only when a creation response explicitly contains data.jobId. The request must use an API Key belonging to the same account that created the job.

text

GET https://api.requestbeam.com/v1/jobs/{id}

Authentication

http

Authorization: Bearer YOUR_API_KEY

Path Parameter

idstringrequired

Numeric job ID returned as jobId when the job was created.

Request Example

bash

curl --request GET \
  --url https://api.requestbeam.com/v1/jobs/123456789012345678 \
  --header 'Authorization: Bearer YOUR_API_KEY'

Response

idstring

Job ID.

statusstring

PENDING, CONNECT, PROCESSING, COMPLETED, FAILED, or CANCELLED.

inputParamsobject

Input parameters submitted when the job was created.

outputResultunknown

Final output. Image and video models return different structures.

createdAtstring

ISO 8601 creation timestamp.

startedAtstring | null

ISO 8601 processing start time.

completedAtstring | null

ISO 8601 completion time.

Success Example

json

{
  "success": true,
  "data": {
    "id": "123456789012345678",
    "status": "COMPLETED",
    "inputParams": {
      "model": "seedance-2.5",
      "prompt": "Create an eight-second brand film"
    },
    "outputResult": [
      {
        "url": [
          "https://video.example.com/generated/result.mp4"
        ]
      }
    ],
    "createdAt": "2026-08-20T08:24:00.000Z",
    "startedAt": "2026-08-20T08:24:02.000Z",
    "completedAt": "2026-08-20T08:26:30.000Z"
  },
  "requestId": "req_..."
}

Polling Guidance

Poll every 5 to 10 seconds.
PENDING, CONNECT, and PROCESSING are non-terminal.
Read outputResult after COMPLETED.
Stop polling after FAILED or CANCELLED.
Result URLs may expire; save completed assets promptly.

Error Responses

See Error Codes and Troubleshooting for the full code reference, protocol differences, and diagnostic steps.

Job not found:

json

{
  "success": false,
  "error": {
    "code": 30000,
    "message": "Job 123456789012345678 not found"
  },
  "requestId": "req_..."
}

Accessing another account's job:

json

{
  "success": false,
  "error": {
    "code": 20001,
    "message": "Access denied"
  },
  "requestId": "req_..."
}