快速开始
三步用 API 生成第一张图:获取密钥、发送一个请求、读取返回的图片,请求和返回的字段与 OpenAI Images API 相同。
API 的请求和返回与 OpenAI Images API 相同。如果你已经在调用 OpenAI,换掉地址和密钥,其余代码不用动。
1. 获取 API 密钥
登录后在 API 密钥 页面创建一个密钥。新账号有 5 张免费图,API 也能用:限 GPT Image 2、2.5、2.6 的 1K 图,每次 1 张。其他情况请先充值。密钥以 sk-cheap- 开头,只在创建时显示一次,请当场复制保存。
2. 发送请求
curl https://api.cheapestimagen.com/v1/images/generations \
-H "Authorization: Bearer $YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "雪地里的一只红狐",
"size": "1536x1024"
}'from openai import OpenAI
client = OpenAI(
base_url="https://api.cheapestimagen.com/v1",
api_key="YOUR_KEY",
)
result = client.images.generate(
model="gpt-image-2",
prompt="雪地里的一只红狐",
size="1536x1024",
)import OpenAI from 'openai';
const client = new OpenAI({
baseURL: 'https://api.cheapestimagen.com/v1',
apiKey: process.env.YOUR_KEY,
});
const result = await client.images.generate({
model: 'gpt-image-2',
prompt: '雪地里的一只红狐',
size: '1536x1024',
});3. 读取图片
返回里每张图一项。默认每项用 b64_json 带回图片的 base64 数据:
{
"created": 1794660236,
"data": [{ "b64_json": "iVBORw0KGgo..." }]
}传 "response_format": "url" 可以改为返回图片链接。链接里的图片保存 72 小时。
同步还是异步
上面的请求是同步的:图片生成完才返回。如果请求时间长,或者要一次提交很多张,改用异步方式:在请求里加 "async": true,立刻拿到任务号,之后再轮询任务,也可以加 webhook_url,任务结束时我们回调通知你。两种方式价格相同。轮询、批量查询和回调的写法见同步请求和异步请求。
怎么收费
GPT Image 2、2.5、2.6 每张 8 积分;Nano Banana 2 和 2.1 每张 12 积分;Nano Banana Pro、gpt-image-2-adobe 以及 flare 版本每张 20 积分;sunburst 版本每张 25 积分;Nano Banana 稳定通道(-1k、-2k、-4k)每张 60 到 180 积分。尺寸和质量不影响价格(1 积分约 0.001 到 0.0018 美元,见 /zh/pricing)。失败的请求不收费:请求开始时预扣积分,没有交付的图片会退回。唯一的例外:Nano Banana 稳定通道(-1k、-2k、-4k)因内容违规被拒的图照样扣积分。