图片生成

Task Query

GET /v1/tasks/{task_id} —— 轮询图片生成任务的状态与结果

查询图片生成提交的异步任务结果。任务状态流转：submitted → processing → completed / failed。

轮询异步任务的状态和结果。图片生成提交后拿到的 task_id 填在这里查。

GEThttps://coder.api.visioncoder.cn/v1/tasks/{task_id}

鉴权

Authorization: Bearer YOUR_API_KEY

路径参数

参数	说明
`task_id`	提交图片生成后返回的任务 ID

调用示例

curl https://coder.api.visioncoder.cn/v1/tasks/task_01HZY3K8Q2W7X9V4 \
  -H "Authorization: Bearer $VISIONCODER_API_KEY"

import time
import requests

def wait_for_task(task_id, api_key):
    url = f"https://coder.api.visioncoder.cn/v1/tasks/{task_id}"
    headers = {"Authorization": f"Bearer {api_key}"}
    while True:
        data = requests.get(url, headers=headers).json()["data"]
        if data["status"] == "completed":
            return data["result"]["images"]
        if data["status"] == "failed":
            raise RuntimeError(data.get("error", "generation failed"))
        time.sleep(3)

images = wait_for_task("task_01HZY3K8Q2W7X9V4", "YOUR_API_KEY")
print(images)

async function waitForTask(taskId) {
  const url = `https://coder.api.visioncoder.cn/v1/tasks/${taskId}`;
  const headers = { Authorization: `Bearer ${process.env.VISIONCODER_API_KEY}` };
  for (;;) {
    const { data } = await (await fetch(url, { headers })).json();
    if (data.status === "completed") return data.result.images;
    if (data.status === "failed") throw new Error(data.error || "generation failed");
    await new Promise((r) => setTimeout(r, 3000));
  }
}

console.log(await waitForTask("task_01HZY3K8Q2W7X9V4"));

响应示例

生成完成（status = completed）：

{
  "code": 200,
  "data": {
    "id": "task_01HZY3K8Q2W7X9V4",
    "status": "completed",
    "progress": 100,
    "created": 1779438767,
    "completed": 1779438792,
    "result": {
      "images": [
        {
          "url": [
            "https://cdn.visioncoder.cn/images/task_01HZY3K8Q2W7X9V4/0.png"
          ]
        }
      ]
    }
  }
}

生成中（status = processing）：

{
  "code": 200,
  "data": {
    "id": "task_01HZY3K8Q2W7X9V4",
    "status": "processing",
    "progress": 0,
    "created": 1779438767
  }
}

生成失败（status = failed）：

{
  "code": 200,
  "data": {
    "id": "task_01HZY3K8Q2W7X9V4",
    "status": "failed",
    "progress": 0,
    "created": 1779438767,
    "error": "prompt rejected by content policy"
  }
}

加群 & 客服