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\"]}"
}
}
通用接口
获取任务详情
查询异步任务的状态和结果
GET
/
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
参数接收生成完成的自动通知，而非轮询状态端点。
授权
string
必填
Bearer Token 认证。格式：Bearer sk-xxxxxx
路径参数
string
必填
任务 ID，创建任务时返回的唯一标识符
响应
integer
必填
响应状态码
string
必填
响应消息
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\"]}"
}
}
⌘I