跳转到主要内容
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\"]}"
  }
}
使用此端点查询通过 API 创建的任何异步任务的状态和结果。
生产环境中，建议使用 callback_url 参数接收生成完成的自动通知，而非轮询状态端点。

​
授权

​
Authorization
string
必填
Bearer Token 认证。格式：Bearer sk-xxxxxx

​
路径参数

​
taskId
string
必填
任务 ID，创建任务时返回的唯一标识符

​
响应

​
code
integer
必填
响应状态码
​
message
string
必填
响应消息
​
data
object
必填
任务数据对象

​
任务状态说明

状态描述
waiting任务已排队等待处理
queuing任务在处理队列中
generating任务正在处理中
success任务成功完成
fail任务失败
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\"]}"
  }
}