Skip to main content
GET
/
v1
/
tasks
/
{task_id}
Query Task Status
curl --request GET \
  --url https://api.evolink.ai/v1/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "created": 1756817821,
  "id": "task-unified-1756817821-4x3rx6ny",
  "model": "gemini-3.1-flash-image-preview",
  "object": "image.generation.task",
  "progress": 100,
  "results": [
    "http://example.com/image.jpg"
  ],
  "status": "completed",
  "error": {
    "code": "content_policy_violation",
    "message": "Content policy violation.\nYour request was blocked by safety filters.",
    "type": "task_error"
  },
  "task_info": {
    "can_cancel": false
  },
  "type": "image"
}

Authorizations

​
Authorization
string
header
required

##All APIs require Bearer Token authentication##

Get API Key:

Visit API Key Management Page to get your API Key

Add to request header:

Authorization: Bearer YOUR_API_KEY

Path Parameters

​
task_id
string
required

Task ID, ignore {} when querying, append the id from the async task response body at the end of the path

Response

Task status details

​
created
integer

Task creation timestamp

Example:

1756817821

​
id
string

Task ID

Example:

"task-unified-1756817821-4x3rx6ny"

​
model
string

Model used

Example:

"gemini-3.1-flash-image-preview"

​
object
enum<string>

Task type

Available options:
image.generation.task,
video.generation.task,
audio.generation.task
Example:

"image.generation.task"

​
progress
integer

Task progress percentage

Required range: 0 <= x <= 100
Example:

100

​
results
string<uri>[]

Task result list (provided when completed)

Example:
["http://example.com/image.jpg"]
​
status
enum<string>

Task status

Available options:
pending,
processing,
completed,
failed
Example:

"completed"

​
error
object

Error information when the task fails (only present when status is "failed"). Note: error.code here is a string-type business error code, different from HTTP status codes. See the Error Codes Reference for the complete list.

​
task_info
object

Task detailed information

​
type
enum<string>

Task type

Available options:
image,
video,
audio,
text
Example:

"image"