获取任务详情
GET
/api/v1/client/tasks
概述
任务状态
| 状态 | 描述 | 操作 |
|---|---|---|
waiting | 任务已排队等待处理 | 继续轮询 |
queuing | 任务在处理队列中 | 继续轮询 |
generating | 任务正在处理中 | 继续轮询 |
success | 任务成功完成 | 解析resultJson获取结果 |
fail | 任务失败 | 查看failCode和failMsg了解详情 |
轮询最佳实践
错误处理
常见错误代码
| 代码 | 描述 | 解决方案 |
|---|---|---|
401 | 未授权 - API密钥无效或缺失 | 检查您的API密钥 |
404 | 未找到任务 | 验证taskId是否正确 |
422 | 原始请求中的验证错误 | 查看failMsg了解详情 |
500 | 内部服务器错误 | 几分钟后重试 |
501 | 生成失败 | 查看failMsg了解具体错误详情 |
示例: 完整的轮询流程
速率限制
相关资源
Request
Query Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.emix.ai/api/v1/client/tasks?taskId=undefined' \
--header 'Authorization: Bearer <token>'Response Response Example
200 - 成功示例
{
"code": 500,
"msg": "success",
"success": true,
"data": {
"taskId": "task_12345678",
"model": "grok-imagine/text-to-image",
"state": "success",
"param": "{\"model\":\"grok-imagine/text-to-image\",\"callBackUrl\":\"https://your-domain.com/api/callback\",\"input\":{\"prompt\":\"电影肖像...\",\"aspect_ratio\":\"3:2\"}}",
"resultJson": "{\"resultUrls\":[\"https://example.com/generated-content.jpg\"]}",
"failCode": "",
"failMsg": "",
"costTime": 15000,
"completeTime": 1698765432000,
"createTime": 1698765400000,
"updateTime": 1698765432000,
"progress": 45,
"creditsConsumed": 50
}
}