> ## Documentation Index
> Fetch the complete documentation index at: https://docs.poixe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 任务状态

```bash curl theme={"theme":{"light":"min-light","dark":"min-dark"}}
curl https://sys.poixe.com/api/channel-tasks/sys-1731337200000000000-a3b9c2d1 \
  -H "Authorization: Bearer $POIXE_SYSTEM_TOKEN"
```

```json response theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "task_id": "sys-1731337200000000000-a3b9c2d1",
  "status": "completed",
  "created_count": 2,
  "failed_count": 0,
  "channels": [
    {
      "id": 42,
      "name": "OpenAI ChatGPT · sk-...wxyz · 3 models",
      "type": "openai_chatgpt",
      "type_name": "OpenAI ChatGPT",
      "models": "gpt-4o,gpt-4o-mini,gpt-4-turbo",
      "status": "enabled",
      "created_at": 1731337220
    }
  ],
  "timestamp": 1731337260
}
```

GET
`https://sys.poixe.com/api/channel-tasks/:taskID`

轮询渠道创建任务的执行状态，直到 `status` 为 `completed` 或 `failed`。任务 24 小时后过期。

建议轮询间隔为 2–5 秒，任务通常在数秒内完成。

## 路径参数

**taskID** `string` *required*

[创建渠道](https://docs.poixe.com/cn/api-reference/system-api/channel/create.md) 返回的 `task_id`

## 响应字段

**task\_id** `string`

任务 ID

**status** `string`

任务状态：`pending` · `running` · `completed` · `failed`

**created\_count** `integer`

已成功创建的渠道数

**failed\_count** `integer`

失败的渠道数。`completed` 状态时若此值大于 0，表示部分 Key 通过模型验证失败（找不到可用模型），成功创建的渠道仍会列出

**channels** `array`

已成功创建的渠道列表（任务完成后）：

**渠道字段**

**id** `integer`

渠道 ID

**name** `string`

渠道名称

**type** `string`

渠道类型 slug

**type\_name** `string`

渠道类型展示名称

**models** `string`

探测到的可用模型列表，逗号分隔

**status** `string`

渠道状态

**created\_at** `integer`

创建时间戳（Unix 秒）

**timestamp** `integer`

响应时间戳（Unix 秒）


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.