千支API 文档

生图接口接入指南

本文档面向需要通过千支API调用图片生成能力的用户。接口兼容 OpenAI Images API，用户只需要准备 API Key、选择生图模型，并按白名单传入 size 即可。

进入控制台 查看模型价格 返回接入文档

1. 获取 API Key

1. 登录千支API控制台。
2. 进入「令牌」或「Token」页面。
3. 创建一个新令牌，并妥善保存。令牌格式通常类似 sk-...。
4. 确认该令牌所在分组包含「GPT生图-特价」或管理员分配的生图分组。

2. 模型与价格

下表来自当前线上价格接口。三档 gpt-image-2 特价模型有固定 size 白名单；其他生图模型是否支持特定尺寸、质量或格式，以模型实际返回为准。

3. 支持的 size 白名单

size 必须严格等于下方其中一个值。不要传 16:9、portrait、landscape 这类比例文字，请传具体宽高。

gpt-image-2-1K

1024x1024 1536x1024 1792x1024 1024x1536 1024x1792 2048x1024

gpt-image-2-2K

2048x2048 3072x2048 3584x2048 2048x3072 2048x3584 4096x2048

gpt-image-2-4K

4096x4096 6144x4096 7168x4096 4096x6144 4096x7168 8192x4096

4. 文生图请求

文生图使用 JSON 请求，最常用字段是 model、prompt、size。

curl 示例

curl https://api.qianzhiapi.com/v1/images/generations \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2-1K",
    "prompt": "一张未来感城市夜景海报，霓虹灯，电影感，高细节",
    "size": "1792x1024",
    "quality": "low",
    "response_format": "b64_json"
  }'

返回格式

{
  "created": 1783007786,
  "data": [
    {
      "b64_json": "这里是一大段图片 base64 内容"
    }
  ]
}

如果返回 b64_json，前端预览时可以拼成 data:image/png;base64,图片base64内容；服务端保存时，将 base64 解码成图片文件即可。

5. Python 接入

from openai import OpenAI
import base64

client = OpenAI(
    api_key="sk-你的APIKey",
    base_url="https://api.qianzhiapi.com/v1",
)

result = client.images.generate(
    model="gpt-image-2-1K",
    prompt="一张未来感城市夜景海报，霓虹灯，电影感，高细节",
    size="1792x1024",
    quality="low",
    response_format="b64_json",
)

image_base64 = result.data[0].b64_json
with open("output.png", "wb") as f:
    f.write(base64.b64decode(image_base64))

6. Node.js / TypeScript 接入

import OpenAI from "openai";
import { writeFile } from "node:fs/promises";

const client = new OpenAI({
  apiKey: "sk-你的APIKey",
  baseURL: "https://api.qianzhiapi.com/v1",
});

const result = await client.images.generate({
  model: "gpt-image-2-1K",
  prompt: "一张未来感城市夜景海报，霓虹灯，电影感，高细节",
  size: "1792x1024",
  quality: "low",
  response_format: "b64_json",
});

const imageBase64 = result.data[0].b64_json;
await writeFile("output.png", Buffer.from(imageBase64, "base64"));

7. 改图 / 图生图

改图接口使用 /v1/images/edits。如果图片已经有公网 URL，可以用 JSON 方式；如果是本地文件，可以用 multipart 上传。

公网图片 URL 方式

curl https://api.qianzhiapi.com/v1/images/edits \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2-1K",
    "prompt": "把这张图改成赛博朋克海报风格，保留主体构图",
    "images": [
      {
        "image_url": "https://example.com/input.png"
      }
    ],
    "size": "1024x1536",
    "quality": "low",
    "response_format": "b64_json"
  }'

本地文件上传方式

curl https://api.qianzhiapi.com/v1/images/edits \
  -H "Authorization: Bearer sk-你的APIKey" \
  -F "model=gpt-image-2-1K" \
  -F "prompt=把这张图改成赛博朋克海报风格，保留主体构图" \
  -F "[email protected]" \
  -F "size=1024x1536" \
  -F "quality=low" \
  -F "response_format=b64_json"

8. 常用参数

9. 常见错误

10. 最小可用测试

只要下面这段可以返回图片，就说明你的 Key、分组、模型和生图链路都正常。

curl https://api.qianzhiapi.com/v1/images/generations \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2-1K",
    "prompt": "一个红色圆形图标，白色背景，极简风格",
    "size": "1024x1024",
    "response_format": "b64_json"
  }'