获取任务详情
GET
/api/v1/jobs/recordInfo
概述
任务状态
| 状态 | 描述 | 操作 |
|---|---|---|
waiting | 任务已排队等待处理 | 继续轮询 |
queuing | 任务在处理队列中 | 继续轮询 |
generating | 任务正在处理中 | 继续轮询 |
success | 任务成功完成 | 解析resultJson获取结果 |
fail | 任务失败 | 查看failCode和failMsg了解详情 |
轮询最佳实践
错误处理
{
"code": 200,
"msg": "success",
"data": {
"taskId": "task_12345678",
"model": "grok-imagine/text-to-image",
"state": "fail",
"param": "{\"model\":\"grok-imagine/text-to-image\",\"input\":\"{\\\"prompt\\\":\\\"...\\\"}\"}",
"resultJson": null,
"failCode": "400",
"failMsg": "<error detail>",
"completeTime": 1698765432000,
"createTime": 1698765400000,
"updateTime": 1698765432000
}
}常见错误代码
| 代码 | 描述 | 解决方案 |
|---|---|---|
401 | 未授权 - API密钥无效或缺失 | 检查您的API密钥 |
422 | 缺少 taskId，或任务不存在 / 不属于当前账号 | 检查 taskId 是否正确 |
500 | 内部服务器错误 | 几分钟后重试 |
501 | 生成失败 | 查看failMsg了解具体错误详情 |
示例: 完整的轮询流程
速率限制
相关资源
Request
Query Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.kie.ai/api/v1/jobs/recordInfo?taskId=undefined' \
--header 'Authorization: Bearer <token>'Response Response Example
200 - 成功示例
{
"code": 200,
"msg": "success",
"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": 15,
"completeTime": 1698765432000,
"createTime": 1698765400000,
"updateTime": 1698765432000,
"progress": 45,
"creditsConsumed": 50
}
}