GET
/
gpt-image-1
/
status
/
{task_id}
Check Status
curl --request GET \
  --url https://api.unifically.com/gpt-image-1/status/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "data": {
    "status": "completed",
    "task_id": "4926fe1a-b7fb-4da4-b726-8f5de4a33767",
    "output": {
      "image_url": "https://storage.unifically.com/images/4926fe1a.png"
    },
    "error": {}
  }
}

Request

curl --location 'https://api.unifically.com/gpt-image-1/status/4926fe1a-b7fb-4da4-b726-8f5de4a33767' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json'

Path Parameters

task_id
string
required
The task ID returned from the generation request

Response

code
number
HTTP status code
data
object
Task status data

Status Values

StatusDescription
pendingTask is queued
processingImage is being generated
completedImage generation is complete
failedGeneration failed with an error

Response Examples

{
  "code": 200,
  "data": {
    "status": "completed",
    "task_id": "4926fe1a-b7fb-4da4-b726-8f5de4a33767",
    "output": {
      "image_url": "https://storage.unifically.com/images/4926fe1a.png"
    },
    "error": {}
  }
}
Poll this endpoint periodically to check generation progress