Skip to main content
GET
https://api.ruxa.ai
/
api
/
v1
/
tasks
/
query
/
{taskId}
curl --request GET \
  --url https://api.ruxa.ai/api/v1/tasks/query/task_gemini-2.5-flash-image_1766304530229_cf4dafd2 \
  --header 'Authorization: Bearer sk-xxxxxx'

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "task_gemini-2.5-flash-image_1766304530229_cf4dafd2",
    "state": "success",
    "resultJson": "{\"resultUrls\":[\"https://cdn.example.com/image.png\"]}"
  }
}
Use this endpoint to query the status and results of any async task created via the API.
In production, use the callBackUrl parameter to receive automatic notifications rather than polling.

​
Authorization

​
Authorization
string
required
Bearer Token authentication. Format: Bearer sk-xxxxxx

​
Path Parameters

​
taskId
string
required
Task ID, the unique identifier returned when creating the task

​
Response

​
code
integer
required
Response status code
​
message
string
required
Response message
​
data
object
required
Task data object

​
Task Status

StatusDescription
waitingTask queued for processing
queuingTask in processing queue
generatingTask is being processed
successTask completed successfully
failTask failed
curl --request GET \
  --url https://api.ruxa.ai/api/v1/tasks/query/task_gemini-2.5-flash-image_1766304530229_cf4dafd2 \
  --header 'Authorization: Bearer sk-xxxxxx'

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "task_gemini-2.5-flash-image_1766304530229_cf4dafd2",
    "state": "success",
    "resultJson": "{\"resultUrls\":[\"https://cdn.example.com/image.png\"]}"
  }
}