# 图片任务查询

GET /v1/images/{task_id}

## 认证

请求头 Authorization: Bearer YOUR_API_KEY。API Key 可在网站“开发者 API”页面创建。

## 路径参数

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| task_id | string | 是 | 提交接口返回的 task_id；拼接 URL 时编码 |

无请求体。只能查询当前账户的图片任务；任务不存在、类型错误或不属于当前账户均返回 404。

## 返回 data 字段

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| task_id | string | 任务 ID |
| taskId | string | 兼容别名 |
| type | string | image |
| status | string | queued、running、succeeded、failed、canceled |
| progress | number | 参考进度；以 status 判断是否完成 |
| outputs | array | 成功时包含 {type,url}；其他状态或链接不可用时为空 |
| imageUrl | string/null | 兼容的结果链接，推荐统一读取 outputs |
| error | object/null | 失败时包含 code、message、error_id |
| credits | number | 任务记录的积分，不代表退款后的净额 |
| created_at | string | 创建时间，通常为 ISO 8601 |
| completed_at | string/null | 终结时间，未完成时可能为 null |

## 轮询与下载

- queued：排队中，继续查询。
- running：生成中，继续查询。
- succeeded：已完成，下载 outputs[0].url。
- failed：失败，停止查询并显示 error。
- canceled：已取消，停止查询。

建议每 3–5 秒查询一次；网络错误退避到 10–30 秒。等待超时可保留 task_id 稍后续查，不需重新创建任务。成功但 outputs 为空时稍后重查；持续为空可联系平台。下载链接可能过期，重新查询获取链接。下载请求不带 API Key。

## 调用示例

设置环境变量 DRAMAGEN_API_KEY（用户密钥）。设置 TASK_ID 为提交返回的 task_id。Python 需要 requests，JavaScript 使用 Node.js 20+。

### cURL

```bash
curl --request GET "https://api.storymo.art/v1/images/${TASK_ID}" \
  --header "Authorization: Bearer $DRAMAGEN_API_KEY"
```

### Python

```python
import os
import requests

api_origin = "https://api.storymo.art"
headers = {
  "Authorization": "Bearer YOUR_API_KEY"
}
headers["Authorization"] = "Bearer " + os.environ["DRAMAGEN_API_KEY"]
response = requests.request("GET", api_origin + "/v1/images/{task_id}".replace("{task_id}", requests.utils.quote(os.environ["TASK_ID"], safe="")), headers=headers, timeout=360)
response.raise_for_status()
result = response.json()
if result["code"] != "ok":
    raise RuntimeError(result)
print(result["data"])
```

### JavaScript

```javascript
const apiOrigin = "https://api.storymo.art";
const headers = {
  "Authorization": "Bearer YOUR_API_KEY"
};
headers.Authorization = `Bearer ${process.env.DRAMAGEN_API_KEY}`;
const response = await fetch(apiOrigin + "/v1/images/{task_id}".replace("{task_id}", encodeURIComponent(process.env.TASK_ID)), {
  method: "GET",
  headers,
});
const result = await response.json();
if (!response.ok || result.code !== "ok") throw new Error(JSON.stringify(result));
console.log(result.data);
```
