GET /status — Check Generation Status by Task ID

GET /status reads the generation’s current state from estudjo’s own record — it does not call the AI provider live. The typical response time is instant. GET https://v1.api.estudjo.com/status?taskId=TASK_ID

string

required

Your estudjo API key.

Query parameters

string

required

The task_id returned by POST /generate.

Example request

curl 'https://v1.api.estudjo.com/status?taskId=6bfd652d4c31261ffb8ed3424ac2775e' \
  -H 'X-Api-Key: YOUR_API_KEY'

Response

The status field progresses through three possible states. The shape of data differs by state.

Pending
Completed
Failed

The generation is still running. Continue polling.

{
  "success": true,
  "data": {
    "status": "pending"
  }
}

The generation finished successfully. result_urls contains the output file(s).

{
  "success": true,
  "data": {
    "status": "completed",
    "result_urls": [
      "https://storage.estudjo.com/generations/6bfd652d4c31261ffb8ed3424ac2775e/88a2d6cd3219e08ee64ec9f60e5735ec.jpeg"
    ]
  }
}

The generation encountered an error. error_message describes the failure.

{
  "success": true,
  "data": {
    "status": "failed",
    "error_message": "..."
  }
}

boolean

true whenever the API call itself succeeded, regardless of generation outcome.

object

Show data

string

Current state of the generation: pending, completed, or failed.

string[]

Array of output file URLs. Present only when status is "completed". These are permanent, public-read storage URLs — not temporary provider URLs.

string

Human-readable description of what went wrong. Present only when status is "failed".

Poll every 5–10 seconds. Most generations complete in 10–100 seconds. result_urls point to permanent public-read storage, so you can serve them directly to end users without re-hosting.

Errors

Code	HTTP	Cause
`not_found`	404	The `taskId` is unknown or belongs to a different account

Health

API Keys

Wallet

Generations

Scenes

GET /status — Check Generation Status by Task ID

Query parameters

Example request

Response

Errors

​Query parameters

​Example request

​Response

​Errors

Query parameters

Example request

Response

Errors