GET
https://api.unifically.com
/
higgsfield
/
cinematic-studio-image
/
status
/
{task_id}
Get Task
curl --request GET \
  --url https://api.unifically.com/higgsfield/cinematic-studio-image/status/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "success": true,
  "data": {
    "status": "processing",
    "output": null
  }
}
Check the status of a cinematic image generation task and retrieve the result when complete.

​
Request

curl -X GET "https://api.unifically.com/higgsfield/cinematic-studio-image/status/{task_id}" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Path Parameters

​
task_id
string
required
The unique task ID returned from the generate endpoint

​
Response (Processing)

{
  "code": 200,
  "success": true,
  "data": {
    "status": "processing",
    "output": null
  }
}

​
Response (Completed)

{
  "code": 200,
  "success": true,
  "data": {
    "status": "completed",
    "output": {
      "image_url": "https://cdn.example.com/generated-image.png"
    }
  }
}

​
Response Fields

​
code
integer
Status code of the request
​
success
boolean
Whether the request was successful
​
data
object
Response data
​
status
string
Current task status: pending, processing, completed, failed
​
output
object
Output data (only present when status is completed)
​
image_url
string
URL of the generated cinematic image

​
Status Values

StatusDescription
pendingTask is queued
processingTask is being processed
completedTask finished successfully
failedTask failed
Poll this endpoint every 3-5 seconds until the status is completed or failed. Image generation is typically faster than video generation.
Alternatively, use callback_url in the generate request to receive a webhook notification when the task completes. See Callback documentation.