图片生成

Image Generation

POST /v1/images/generations —— 文生图，兼容 OpenAI Images 协议

图片生成为异步任务：本接口提交后立即返回任务 ID（状态为 submitted），随后通过任务结果查询 GET /v1/tasks/{task_id} 轮询获取生成结果。

文生图接口，与 OpenAI Images 同构。耗时任务会返回 task，用 GET /v1/tasks/{task_id} 轮询结果。

POSThttps://coder.api.visioncoder.cn/v1/images/generations

鉴权

Authorization: Bearer YOUR_API_KEY

请求参数

参数	类型	必填	说明
`model`	string	是	图片模型 ID，如 `gpt-image-2`、`grok-imagine-image`、`doubao-seedream-5-0-260128`
`prompt`	string	是	图片描述，中英文都支持
`n`	integer	否	生成几张，1–10。按张计费
`size`	string	否	比例，如 `1:1`、`16:9`、`auto`；也接受 `1024x1024` 这种像素写法
`resolution`	string	否	输出分辨率档位
`image_urls`	array	否	参考图（URL 或 base64）。传了就变成图生图，不再是纯文生图

调用示例

curl https://coder.api.visioncoder.cn/v1/images/generations \
  -H "Authorization: Bearer $VISIONCODER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只戴着宇航员头盔的橘猫，赛博朋克风格",
    "n": 1,
    "size": "1:1",
    "resolution": "1k"
  }'

import requests

resp = requests.post(
    "https://coder.api.visioncoder.cn/v1/images/generations",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "model": "gpt-image-2",
        "prompt": "一只戴着宇航员头盔的橘猫，赛博朋克风格",
        "n": 1,
        "size": "1:1",
        "resolution": "1k",
    },
)
task_id = resp.json()["data"]["id"]
print(task_id)

const resp = await fetch("https://coder.api.visioncoder.cn/v1/images/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VISIONCODER_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gpt-image-2",
    prompt: "一只戴着宇航员头盔的橘猫，赛博朋克风格",
    n: 1,
    size: "1:1",
    resolution: "1k",
  }),
});
const { data } = await resp.json();
console.log(data.id);

图生图：通过 image_urls 传入参考图（URL 或 base64，最多 14 张）即切换为图生图模式：

{
  "model": "gpt-image-2",
  "prompt": "把这张照片变成水彩画风格",
  "image_urls": ["https://example.com/photo.png"]
}

响应示例

{
  "code": 200,
  "data": {
    "id": "task_01HZY3K8Q2W7X9V4",
    "status": "submitted"
  }
}

加群 & 客服