AI·Img
目录 · API 文档

5 分钟跑通

从拿到 key 到第一张图，三个动作。

1. 创建 API Key

登录后进入 API Keys 页面，点 创建 key， 给一个名字（比如 local-test），保存弹出的明文 —— 它形如：

aiimg-sk-live-xxxxxxxxxxxxxxxxxxxx
明文 只显示一次。丢了只能撤销重建。

2. 第一次请求(curl)

curl https://aiimg.top/v1/images/generations \
  -H "Authorization: Bearer $AIIMG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一张极简风格的山水画",
    "n": 1,
    "size": "1024x1024",
    "quality": "low"
  }'

响应（OpenAI 兼容）：

{
  "created": 1714123456,
  "data": [
    { "url": "https://chatgpt2.tokensolo.com/images/2026/04/26/xxx.png" }
  ],
  "aiimg_generation_id": "cmofjncu7007910z3..."
}

3. Python SDK(直接复用 OpenAI 官方 SDK)

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AIIMG_API_KEY"],
    base_url="https://aiimg.top/v1",
)

resp = client.images.generate(
    model="gpt-image-2",
    prompt="一张极简风格的山水画",
    n=1,
    size="1024x1024",
    quality="low",        # low / medium / high
)
print(resp.data[0].url)

4. Node SDK

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.AIIMG_API_KEY,
  baseURL: "https://aiimg.top/v1",
});

const resp = await client.images.generate({
  model: "gpt-image-2",
  prompt: "一张极简风格的山水画",
  n: 1,
  size: "1024x1024",
  quality: "low",
});
console.log(resp.data[0].url);

下一步