API 参考图片Gemini
通用接口
Gemini 图片模型的 OpenAI 兼容图片生成与参考图修改接口,返回图片 URL。
通用接口使用 OpenAI 图片格式,生成结果通常返回图片 URL。
接口信息
| 项目 | 值 |
|---|---|
| 请求地址 | POST https://token.aiznt.com/v1/images/generations |
| 认证方式 | Header Authorization: Bearer sk-你的密钥 |
| Content-Type | application/json |
图片生成
curl https://token.aiznt.com/v1/images/generations \
-H "Authorization: Bearer sk-你的aiznt密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.1-flash-image",
"prompt": "一只猫在雨后的霓虹街道上奔跑,电影感",
"size": "1k",
"aspect_ratio": "1:1",
"response_format": "url"
}'携带参考图
部分模型支持参考图。将参考图 URL 放入请求体的 image 数组,prompt 仅填写文字修改指令:
curl https://token.aiznt.com/v1/images/generations \
-H "Authorization: Bearer sk-你的aiznt密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.1-flash-image",
"prompt": "保持人物不变,把背景替换为海边日落",
"size": "1k",
"aspect_ratio": "16:9",
"response_format": "url",
"image": [
"https://example.com/reference.jpg"
]
}'返回结果
图片生成和携带参考图使用相同的返回结构。生成成功后,图片地址位于 data[0].url。
{
"created": 1787888579,
"data": [
{
"b64_json": "",
"revised_prompt": "",
"url": "https://cdn.aiznt.com/relay-temp-images/20260828/b13c70b8-5e24-4936-a54f-d158aadf980a.jpg"
}
]
}| 字段 | 类型 | 说明 |
|---|---|---|
created | integer | 响应创建时间的 Unix 时间戳,单位为秒 |
data | array | 生成的图片结果列表 |
data[].url | string | 生成图片的临时访问地址 |
data[].b64_json | string | Base64 图片数据;URL 返回模式下通常为空字符串 |
data[].revised_prompt | string | 服务端修订后的提示词;未提供时通常为空字符串 |
临时图片地址
建议获取响应后及时下载并保存 url 指向的图片,不要将临时地址作为长期存储地址。
Python
import requests
response = requests.post(
"https://token.aiznt.com/v1/images/generations",
headers={"Authorization": "Bearer sk-你的aiznt密钥"},
json={
"model": "gemini-3.1-flash-image",
"prompt": "一只猫在雨后的霓虹街道上奔跑,电影感",
"size": "1k",
"aspect_ratio": "1:1",
"response_format": "url",
},
timeout=300,
)
response.raise_for_status()
print(response.json()["data"][0]["url"])常用参数
| 参数 | 说明 |
|---|---|
model | Gemini 图片模型 ID |
prompt | 生成描述或修改指令 |
image | 参考图数组(仅在具体模型支持时使用) |
size | 常用 1k、2k,以模型支持范围为准 |
aspect_ratio | 比例,如 1:1、16:9 |
response_format | 通常使用 url |
完整字段和模型能力以当前控制台接口定义为准。