Skip to main content
GET
/
v1
/
images
/
tasks
/
{task_id}
Get Task
curl --request GET \
  --url https://openapi.imini.ai/imini/router/v1/images/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "task_id": "task_8f3a2c1b9d4e",
  "status": "succeeded",
  "model": "google/nano-banana-2",
  "created_at": "2026-03-30T10:00:00Z",
  "completed_at": "2026-03-30T10:00:12Z",
  "images": [
    {
      "url": "https://file.iminicdn.com/file/2026/04/06/2041350421116751872.png",
      "width": 1920,
      "height": 1080
    }
  ],
  "error": null,
  "request_id": "req_abc123"
}

Authorizations

​
Authorization
string
header
required

Pass Authorization: Bearer <YOUR_API_KEY> in the request header. Go to the API Keys management page to create and manage API Keys.

Path Parameters

​
task_id
string
required

Unique task ID, returned by the image generation endpoint.

Example:

"task_8f3a2c1b9d4e"

Response

Query successful

​
task_id
string

Unique task ID

Example:

"task_8f3a2c1b9d4e"

​
status
enum<string>

Task status:

  • queued — Submitted, waiting in queue
  • processing — Model is generating
  • succeeded — Generation succeeded
  • failed — Generation failed, see the error field
Available options:
queued,
processing,
succeeded,
failed
Example:

"succeeded"

​
model
string

The model ID used for this task

Example:

"google/nano-banana-2"

​
created_at
string<date-time>

Task creation time (ISO 8601)

Example:

"2026-03-30T10:00:00Z"

​
completed_at
string<date-time> | null

Task completion time (ISO 8601); null while not yet completed

Example:

"2026-03-30T10:00:12Z"

​
images
object[] | null

Generation result list. Populated when status is succeeded, otherwise null.

​
error
object

Error information. Populated when status is failed, otherwise null.

​
request_id
string

Unique request ID

Example:

"req_abc123"