图片生成 gemini-3-pro-image-preview 控制宽高比 +清晰度
▼
Authorization
在 Header 添加参数 Authorization，其值为 Bearer 之后拼接 Token
示例：
Authorization: Bearer ********************
请求参数
Header 参数
Content-Type
string
必需
示例: application/json
Authorization
string
必需
示例: Bearer $OPENAI_API_KEY
Body 参数 application/json
contents
array [object]
必需
对话内容列表，支持文本和图片输入。
generationConfig
object
必需
生成配置，包含 responseModalities 和 imageConfig。
responseModalities
array [string]
必需
响应模式，如 ["TEXT", "IMAGE"]。
imageConfig
object
必需
图片配置，通过 aspectRatio 控制宽高比，通过 clarity 控制清晰度。
示例
{
"contents": [
{
"role": "user",
"parts": [
{
"text": "Generate a high quality portrait photo of a cat"
}
]
}
],
"generationConfig": {
"responseModalities": [
"TEXT",
"IMAGE"
],
"imageConfig": {
"aspectRatio": "1:1"
}
}
}请求示例代码
curl --location -g --request POST 'https://api.quickrouter.ai/v1beta/models/gemini-3-pro-image-preview:generateContent?key=' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "Generate a high quality portrait photo of a cat"
}
]
}
],
"generationConfig": {
"responseModalities": [
"TEXT",
"IMAGE"
],
"imageConfig": {
"aspectRatio": "1:1"
}
}
}'var myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer <token>");
myHeaders.append("Content-Type", "application/json");
var raw = JSON.stringify({
"contents": [
{
"role": "user",
"parts": [
{
"text": "Generate a high quality portrait photo of a cat"
}
]
}
],
"generationConfig": {
"responseModalities": [
"TEXT",
"IMAGE"
],
"imageConfig": {
"aspectRatio": "1:1"
}
}
});
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: raw,
redirect: 'follow'
};
fetch("https://api.quickrouter.ai/v1beta/models/gemini-3-pro-image-preview:generateContent?key=", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));import http.client
import json
conn = http.client.HTTPSConnection("api.quickrouter.ai")
payload = json.dumps({
"contents": [
{
"role": "user",
"parts": [
{
"text": "Generate a high quality portrait photo of a cat"
}
]
}
],
"generationConfig": {
"responseModalities": [
"TEXT",
"IMAGE"
],
"imageConfig": {
"aspectRatio": "1:1"
}
}
})
headers = {
'Authorization': 'Bearer <token>',
'Content-Type': 'application/json'
}
conn.request("POST", "/v1beta/models/gemini-3-pro-image-preview:generateContent?key=", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))返回响应
响应参数 🟢 200 OK · application/json
candidates
array [object]
必需
modelVersion
string
必需
示例
{
"candidates": [
{
"content": {
"parts": [
{
"text": "Here is the image you requested:"
},
{
"inlineData": {
"mimeType": "image/png",
"data": "..."
}
}
],
"role": "model"
},
"finishReason": "STOP"
}
],
"modelVersion": "gemini-3-pro-image-preview"
}