图片生成

API 码头提供基于 gpt-image-2 模型的图像生成能力，兼容 OpenAI Images API 协议，支持文生图（text-to-image）与图改图（image edit）两种调用方式。

端点

用途	方法	端点
文生图	POST	/v1/images/generations
图改图	POST	/v1/images/edits

请求头需携带鉴权：Authorization: Bearer sk-你的Key。

风控提示

图像生成不允许用于违法、色情、暴力、名人肖像、受版权保护 IP 等场景。模型侧与平台侧均设有内容风控，违规 prompt 可能被直接拦截或要求改写。请遵守相关法律法规和服务条款。

参数说明

参数	类型	必填	说明
model	string	是	固定为 gpt-image-2
prompt	string	是	图像描述，建议用英文并尽量具体
n	int	否	生成数量，默认 1
size	string	否	输出尺寸，默认 1024x1024，详见下方尺寸参考
quality	string	否	图像质量，可选 low / medium / high / auto
response_format	string	否	返回格式，默认返回 b64_json，部分模型支持 url
image	file	图改图必填	待编辑的原图（multipart/form-data 上传）

文生图示例

curl https://apimatou.cc/v1/images/generations \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A cute orange cat playing with yarn, studio ghibli style",
    "n": 1,
    "size": "1024x1024",
    "quality": "auto"
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://apimatou.cc/v1",
    api_key="sk-你的Key",
)

resp = client.images.generate(
    model="gpt-image-2",
    prompt="A cute orange cat playing with yarn, studio ghibli style",
    n=1,
    size="1024x1024",
)

# 默认返回 b64_json，可直接落盘或转 data URI
print(resp.data[0].b64_json[:32], "...")

import OpenAI from 'openai';
import fs from 'node:fs';

const client = new OpenAI({
  baseURL: 'https://apimatou.cc/v1',
  apiKey: process.env.APIMATOU_API_KEY,
});

const resp = await client.images.generate({
  model: 'gpt-image-2',
  prompt: 'A cute orange cat playing with yarn, studio ghibli style',
  n: 1,
  size: '1024x1024',
});

// b64_json 写入文件
fs.writeFileSync('out.png', Buffer.from(resp.data[0].b64_json, 'base64'));
console.log('saved out.png');

图改图示例

图改图需通过 multipart/form-data 提交，包含待编辑的原图与改写 prompt。

curl https://apimatou.cc/v1/images/edits \
  -H "Authorization: Bearer sk-你的Key" \
  -F model="gpt-image-2" \
  -F prompt="Restyle this image as a watercolor painting, soft pastel palette" \
  -F n=1 \
  -F size="1024x1024" \
  -F image="@cat.png"

from openai import OpenAI

client = OpenAI(
    base_url="https://apimatou.cc/v1",
    api_key="sk-你的Key",
)

resp = client.images.edit(
    model="gpt-image-2",
    image=open("cat.png", "rb"),
    prompt="Restyle this image as a watercolor painting, soft pastel palette",
    n=1,
    size="1024x1024",
)

print(resp.data[0].b64_json[:32], "...")

import OpenAI from 'openai';
import fs from 'node:fs';

const client = new OpenAI({
  baseURL: 'https://apimatou.cc/v1',
  apiKey: process.env.APIMATOU_API_KEY,
});

const resp = await client.images.edit({
  model: 'gpt-image-2',
  image: fs.createReadStream('cat.png'),
  prompt: 'Restyle this image as a watercolor painting, soft pastel palette',
  n: 1,
  size: '1024x1024',
});

fs.writeFileSync('edited.png', Buffer.from(resp.data[0].b64_json, 'base64'));
console.log('saved edited.png');

尺寸参考

不同比例对应常用尺寸与典型用途：

比例	尺寸	用途
1:1	1024x1024 / 2048x2048	Logo、商品图、头像
16:9	1920x1080 / 3840x2160	幻灯片、横幅、视频封面
9:16	1080x1920 / 2160x3840	手机壁纸、短视频
4:3	1600x1200 / 2048x1536	经典照片
3:2	1536x1024 / 1920x1280	相机画幅

实际可用的尺寸以模型源支持为准。若传入不被支持的尺寸，平台会返回错误码并提示可选项。

计费方式

图像生成按张或按 token 计费，不同质量档位（low / medium / high）与尺寸对应不同的消耗。具体的倍率与单价不在文档内维护，请前往 模型广场 查看 gpt-image-2 的最新计费规则。