图片2（同步）
模型名 gpt-image-2-1k-同步 走同步图片接口：文生图、图生图、图文生图提交后直接返回图片，无需轮询任务。
支持模型
gpt-image-2-1k-同步
认证与请求头
http
Authorization: Bearer sk-xxxxxx
Content-Type: application/json接口一览
| 能力 | 接口 | 是否传 image |
|---|---|---|
| 文生图 | POST /v1/images/generations | 否 |
| 图生图 | POST /v1/images/generations 或 POST /v1/images/edits | 是 |
| 图文生图 | POST /v1/images/generations 或 POST /v1/images/edits | 是 |
1. 文生图
仅根据文本生成图片，不要传 image 字段。
适用场景
- 海报、插画、概念图
- 纯创意描述，无参考图
请求要点
| 字段 | 必填 | 说明 |
|---|---|---|
model | 是 | 固定 gpt-image-2-1k-同步 |
prompt | 是 | 画面描述 |
size | 否 | 见下方尺寸表 |
请求示例
json
{
"model": "gpt-image-2-1k-同步",
"prompt": "生成一张海报风格的城市夜景，霓虹灯，电影感",
"size": "1024x1792"
}cURL
bash
curl --request POST \
--url 'https://bigbangtoken.com/v1/images/generations' \
--header 'Authorization: Bearer sk-xxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2-1k-同步",
"prompt": "生成一张海报风格的城市夜景，霓虹灯，电影感",
"size": "1024x1792"
}'2. 图生图
基于参考图生成新图，必须传 image。适合换风格、保留主体重绘、多图融合等。
适用场景
- 照片转动漫 / 油画 / 水彩
- 以产品图为参考生成新场景
- 多张参考图融合构图
请求要点
| 字段 | 必填 | 说明 |
|---|---|---|
model | 是 | 固定 gpt-image-2-1k-同步 |
prompt | 是 | 如何基于参考图生成 |
image | 是 | URL 或 base64，可数组 |
size | 否 | 输出比例 |
方式 A：generations + 参考图（推荐）
json
{
"model": "gpt-image-2-1k-同步",
"prompt": "把这张图改成油画风格，笔触明显",
"image": "https://example.com/reference.jpg",
"size": "1024x1024"
}方式 B：edits + 参考图
edits 接口必须带 image，未传会返回 400 image is required。
json
{
"model": "gpt-image-2-1k-同步",
"prompt": "改成油画风格，笔触明显",
"image": "https://example.com/reference.jpg",
"size": "1024x1024"
}多图参考
json
{
"model": "gpt-image-2-1k-同步",
"prompt": "融合两张图的主体与配色",
"image": [
"https://example.com/a.jpg",
"data:image/jpeg;base64,/9j/4AAQSkZJRg..."
],
"size": "1536x1024"
}cURL（generations）
bash
curl --request POST \
--url 'https://bigbangtoken.com/v1/images/generations' \
--header 'Authorization: Bearer sk-xxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2-1k-同步",
"prompt": "把这张图改成油画风格",
"image": "https://example.com/reference.jpg",
"size": "1024x1024"
}'3. 图文生图
图片 + 文本共同决定生成结果：文本写「改什么」，图片提供「长什么样」的视觉锚点。接口与图生图相同，区别在于 prompt 与 image 的分工。
适用场景
- 保留人物/产品主体，只改背景或氛围
- 参考构图和色调，按文字描述生成新内容
- 电商：产品图 +「换成节日促销背景」
请求要点
| 角色 | 字段 | 说明 |
|---|---|---|
| 文本意图 | prompt | 修改目标、风格、场景描述 |
| 视觉参考 | image | 主体、姿态、构图、配色来源 |
| 输出比例 | size | 可选 |
示例：换背景（generations）
json
{
"model": "gpt-image-2-1k-同步",
"prompt": "保留人物面部和服装，背景改为 sunny beach，自然光",
"image": "https://example.com/portrait.jpg",
"size": "1024x1792"
}示例：参考风格 + 新内容（edits）
json
{
"model": "gpt-image-2-1k-同步",
"prompt": "参考这张图的光影和色调，生成同风格的森林小径",
"image": "https://example.com/style-ref.jpg",
"size": "1792x1024"
}示例：产品图 + 文案意图
json
{
"model": "gpt-image-2-1k-同步",
"prompt": "保持瓶身不变，添加双11促销横幅和红色喜庆背景",
"image": "https://example.com/product.png",
"size": "1024x1024"
}cURL
bash
curl --request POST \
--url 'https://bigbangtoken.com/v1/images/generations' \
--header 'Authorization: Bearer sk-xxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2-1k-同步",
"prompt": "保留人物主体，背景改成赛博朋克街道",
"image": "https://example.com/portrait.jpg",
"size": "1024x1792"
}'generations 与 edits 怎么选？
| 接口 | 建议 |
|---|---|
generations + image | 通用图生图、图文生图，语义偏「生成新图」 |
edits + image | 偏「在原图基础上改」，如换背景、去元素 |
两者对 gpt-image-2-1k-同步 均为同步返回；若不确定，优先用 generations。
四、图片输入格式
URL
json
{ "image": "https://example.com/demo.jpg" }Base64 Data URL
json
{ "image": "data:image/jpeg;base64,/9j/4AAQSkZJRg..." }多张图片
json
{
"image": [
"https://example.com/a.jpg",
"https://example.com/b.jpg"
]
}五、参数标注（适用部分 key）
| 字段 | 类型 | 文生图 | 图生图 / 图文生图 | 说明 |
|---|---|---|---|---|
model | string | 必填 | 必填 | 固定 gpt-image-2-1k-同步 |
prompt | string | 必填 | 必填 | 描述或编辑意图 |
size | string | 可选 | 可选 | 内部转为 aspect_ratio |
image | string | string[] | 不传 | 必填 | 参考图 |
size 映射
OpenAI size | aspect_ratio |
|---|---|
1024x1024 | 1:1 |
1024x1792 | 9:16 |
1792x1024 | 16:9 |
1024x1536 | 2:3 |
1536x1024 | 3:2 |
不在上表中的 size（如 512x512）会报错。
六、响应格式
同步返回，常见两种：
Base64
json
{
"created": 1234567890,
"data": [
{ "b64_json": "data:image/png;base64,..." }
]
}URL
json
{
"created": 1234567890,
"data": [
{ "url": "https://example.com/output.png" }
]
}具体字段以上游为准。
七、计费与注意事项
- 按次计费，一次请求扣一次
- 仅支持 JSON，不支持
multipart/form-data - 与香蕉异步模型不同，不会返回
task_id，也不需要调用/v1/videos/{task_id}