# 查询配音任务

> `GET /task?id=<任务ID>`　|　文档 6/7｜更新于 2026-09-26｜[返回索引](https://ai.aibobos.com/openapi/index.md)

按 `id` 查异步配音任务状态。轮询到 `status=2` 即完成，取 `audio_url`。

**为什么 Agent 需要它**：异步交付的收口端点；没有它，Agent 拿不到成片链接。

## 调用

```bash
curl -s "https://ai.aibobos.com/api/openapi/v1/task?id=<任务ID>" \
  -H "Authorization: Bearer $AIBO_KEY"
```

## 参数

| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `id` | int | 是 | `/tts` 异步返回的 `id`。仅能查自己账号的任务。 |

## 响应

```json
{
  "ok": 1,
  "data": {
    "id": 123,
    "status": 2,
    "status_text": "已完成",
    "text": "艾波开放平台已支持 OpenAI 兼容调用。",
    "chars": 20,
    "audio_url": "https://ai.aibobos.com/uploads/.../xxx.mp3"
  }
}
```

## 注意

- **状态码语义**：`0` 排队中 / `1` 处理中 / `2` 已完成 / `3` 失败。
- 建议轮询间隔 2–3 秒，上限约 60 秒；超时未完成按失败处理并提示用户。
- 查不到（含别人的任务）统一返回 `404 任务不存在`，不区分，避免探测。

---

- 鉴权：`Authorization: Bearer <API Key>`；需要 `tts` 能力域
- 计费：见[索引页的计费表](https://ai.aibobos.com/openapi/index.md#计费口径)，失败自动退回
- 机器可读描述：[openapi.json](https://ai.aibobos.com/openapi.json)