Skip to main content
POST
Gemini 3 Pro Image 图像生成

模型选择

渠道会将对外模型 gemini-3-pro-image 映射为 gemini-3-pro-image-preview 后发送至 APIMart。

主要参数

下表列出常用参数;媒体引用的组合限制以接口校验结果为准。

返回说明

成功时返回 data[].url。如返回 504 与 task_id,请先查询原任务,不要直接重复提交。

授权

Authorization
string
header
必填

本项目签发的 API 密钥,不是上游密钥

请求体

application/json
model
enum<string>
必填

对外请求的模型 ID

可用选项:
gemini-3-pro-image
prompt
string
必填

图片生成或编辑的文字描述;必填

Minimum string length: 1
size
enum<string>
默认值:auto

输出宽高比;图生图建议指定比例

可用选项:
auto,
1:1,
2:3,
3:2,
3:4,
4:3,
4:5,
5:4,
9:16,
16:9,
21:9
resolution
enum<string>
默认值:1K

输出分辨率(当前网关不接受 0.5K)

可用选项:
1K,
2K,
4K
n
enum<integer>
默认值:1

每次生成 1 张

可用选项:
1
image_urls
string[]

图像编辑参考图,最多 14 张;每张不超过 30MB;支持公开 URL 或图片 Data URI

Maximum array length: 14
nsfw_check
boolean
默认值:false

提交前进行内容审核;默认为 false

official_fallback
boolean
默认值:false

可选的官方线路回退;可能使用不同计费档位

response_format
enum<string>

本网关仅支持 url 响应格式

可用选项:
url

响应

生成成功,返回图片 URL

created
integer
data
object[]