curl --request POST \
--url https://api.mixroute.ai/v1/models/gemini-3.1-flash-image:generateContent \
--header 'Authorization: Bearer sk-xxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "一只可爱的橙色小猫坐在花园里"
}
]
}
],
"generationConfig": {
"responseModalities": [
"TEXT",
"IMAGE"
],
"imageConfig": {
"aspectRatio": "16:9",
"imageSize": "2K"
}
}
}'
import requests
url = "https://api.mixroute.ai/v1/models/gemini-3.1-flash-image:generateContent"
headers = {
"Authorization": "Bearer sk-xxxxxxxxxx",
"Content-Type": "application/json"
}
payload = {
"contents": [
{
"role": "user",
"parts": [
{
"text": "一只可爱的橙色小猫坐在花园里"
}
]
}
],
"generationConfig": {
"responseModalities": [
"TEXT",
"IMAGE"
],
"imageConfig": {
"aspectRatio": "16:9",
"imageSize": "2K"
}
}
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
const response = await fetch('https://api.mixroute.ai/v1/models/gemini-3.1-flash-image:generateContent', {
method: 'POST',
headers: {
'Authorization': 'Bearer sk-xxxxxxxxxx',
'Content-Type': 'application/json'
},
body: JSON.stringify({
contents: [
{
role: "user",
parts: [
{
text: "一只可爱的橙色小猫坐在花园里"
}
]
}
],
generationConfig: {
responseModalities: [
"TEXT",
"IMAGE"
],
imageConfig: {
aspectRatio: "16:9",
imageSize: "2K"
}
}
})
});
const data = await response.json();
console.log(data);
<?php
$client = new GuzzleHttp\Client();
$response = $client->post('https://api.mixroute.ai/v1/models/gemini-3.1-flash-image:generateContent', [
'headers' => [
'Authorization' => 'Bearer sk-xxxxxxxxxx',
'Content-Type' => 'application/json',
],
'json' => [
'contents' => [
[
'role' => 'user',
'parts' => [
[
'text' => '一只可爱的橙色小猫坐在花园里'
]
]
]
],
'generationConfig' => [
'responseModalities' => [
'TEXT',
'IMAGE'
],
'imageConfig' => [
'aspectRatio' => '16:9',
'imageSize' => '2K'
]
]
]
]);
echo $response->getBody();
package main
import (
"bytes"
"encoding/json"
"net/http"
)
func main() {
payload := map[string]interface{}{
"contents": []interface{}{
map[string]interface{}{
"role": "user",
"parts": []interface{}{
map[string]interface{}{
"text": "一只可爱的橙色小猫坐在花园里",
},
},
},
},
"generationConfig": map[string]interface{}{
"responseModalities": []string{
"TEXT",
"IMAGE",
},
"imageConfig": map[string]interface{}{
"aspectRatio": "16:9",
"imageSize": "2K",
},
},
}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://api.mixroute.ai/v1/models/gemini-3.1-flash-image:generateContent", bytes.NewBuffer(body))
req.Header.Set("Authorization", "Bearer sk-xxxxxxxxxx")
req.Header.Set("Content-Type", "application/json")
http.DefaultClient.Do(req)
}
import java.net.http.*;
import java.net.URI;
HttpClient client = HttpClient.newHttpClient();
String json = """
{
"contents": [
{
"role": "user",
"parts": [
{
"text": "一只可爱的橙色小猫坐在花园里"
}
]
}
],
"generationConfig": {
"responseModalities": [
"TEXT",
"IMAGE"
],
"imageConfig": {
"aspectRatio": "16:9",
"imageSize": "2K"
}
}
}
""";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.mixroute.ai/v1/models/gemini-3.1-flash-image:generateContent"))
.header("Authorization", "Bearer sk-xxxxxxxxxx")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(json))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
require 'net/http'
require 'json'
uri = URI('https://api.mixroute.ai/v1/models/gemini-3.1-flash-image:generateContent')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer sk-xxxxxxxxxx'
request['Content-Type'] = 'application/json'
request.body = {
contents: [
{
role: 'user',
parts: [
{
text: '一只可爱的橙色小猫坐在花园里'
}
]
}
],
generationConfig: {
responseModalities: [
'TEXT',
'IMAGE'
],
imageConfig: {
aspectRatio: '16:9',
imageSize: '2K'
}
}
}.to_json
response = http.request(request)
puts response.body
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{
"inlineData": {
"mimeType": "image/png",
"data": "iVBORw0KGgoAAAANSUhEUgAAAAQAAAAECAIA..."
}
},
{
"inlineData": {
"mimeType": "image/png",
"data": "iVBORw0KGgoAAAANSUhEUgAACAAAAAgACAIA..."
}
}
]
},
"finishReason": "STOP"
}
],
"usageMetadata": {
"promptTokenCount": 13,
"candidatesTokenCount": 1680,
"totalTokenCount": 1693,
"trafficType": "ON_DEMAND",
"promptTokensDetails": [
{
"modality": "TEXT",
"tokenCount": 13
}
],
"candidatesTokensDetails": [
{
"modality": "IMAGE",
"tokenCount": 1680
}
]
},
"modelVersion": "gemini-3.1-flash-image",
"createTime": "2026-06-24T02:41:32.820834Z",
"responseId": "3EM7auKMMvmTmecP2dTdsAE"
}
图像系列
Gemini 原生(图像)
Gemini 原生图像生成模型,文生图与图生图
POST
/
v1
/
models
/
{model}
:generateContent
curl --request POST \
--url https://api.mixroute.ai/v1/models/gemini-3.1-flash-image:generateContent \
--header 'Authorization: Bearer sk-xxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "一只可爱的橙色小猫坐在花园里"
}
]
}
],
"generationConfig": {
"responseModalities": [
"TEXT",
"IMAGE"
],
"imageConfig": {
"aspectRatio": "16:9",
"imageSize": "2K"
}
}
}'
import requests
url = "https://api.mixroute.ai/v1/models/gemini-3.1-flash-image:generateContent"
headers = {
"Authorization": "Bearer sk-xxxxxxxxxx",
"Content-Type": "application/json"
}
payload = {
"contents": [
{
"role": "user",
"parts": [
{
"text": "一只可爱的橙色小猫坐在花园里"
}
]
}
],
"generationConfig": {
"responseModalities": [
"TEXT",
"IMAGE"
],
"imageConfig": {
"aspectRatio": "16:9",
"imageSize": "2K"
}
}
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
const response = await fetch('https://api.mixroute.ai/v1/models/gemini-3.1-flash-image:generateContent', {
method: 'POST',
headers: {
'Authorization': 'Bearer sk-xxxxxxxxxx',
'Content-Type': 'application/json'
},
body: JSON.stringify({
contents: [
{
role: "user",
parts: [
{
text: "一只可爱的橙色小猫坐在花园里"
}
]
}
],
generationConfig: {
responseModalities: [
"TEXT",
"IMAGE"
],
imageConfig: {
aspectRatio: "16:9",
imageSize: "2K"
}
}
})
});
const data = await response.json();
console.log(data);
<?php
$client = new GuzzleHttp\Client();
$response = $client->post('https://api.mixroute.ai/v1/models/gemini-3.1-flash-image:generateContent', [
'headers' => [
'Authorization' => 'Bearer sk-xxxxxxxxxx',
'Content-Type' => 'application/json',
],
'json' => [
'contents' => [
[
'role' => 'user',
'parts' => [
[
'text' => '一只可爱的橙色小猫坐在花园里'
]
]
]
],
'generationConfig' => [
'responseModalities' => [
'TEXT',
'IMAGE'
],
'imageConfig' => [
'aspectRatio' => '16:9',
'imageSize' => '2K'
]
]
]
]);
echo $response->getBody();
package main
import (
"bytes"
"encoding/json"
"net/http"
)
func main() {
payload := map[string]interface{}{
"contents": []interface{}{
map[string]interface{}{
"role": "user",
"parts": []interface{}{
map[string]interface{}{
"text": "一只可爱的橙色小猫坐在花园里",
},
},
},
},
"generationConfig": map[string]interface{}{
"responseModalities": []string{
"TEXT",
"IMAGE",
},
"imageConfig": map[string]interface{}{
"aspectRatio": "16:9",
"imageSize": "2K",
},
},
}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://api.mixroute.ai/v1/models/gemini-3.1-flash-image:generateContent", bytes.NewBuffer(body))
req.Header.Set("Authorization", "Bearer sk-xxxxxxxxxx")
req.Header.Set("Content-Type", "application/json")
http.DefaultClient.Do(req)
}
import java.net.http.*;
import java.net.URI;
HttpClient client = HttpClient.newHttpClient();
String json = """
{
"contents": [
{
"role": "user",
"parts": [
{
"text": "一只可爱的橙色小猫坐在花园里"
}
]
}
],
"generationConfig": {
"responseModalities": [
"TEXT",
"IMAGE"
],
"imageConfig": {
"aspectRatio": "16:9",
"imageSize": "2K"
}
}
}
""";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.mixroute.ai/v1/models/gemini-3.1-flash-image:generateContent"))
.header("Authorization", "Bearer sk-xxxxxxxxxx")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(json))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
require 'net/http'
require 'json'
uri = URI('https://api.mixroute.ai/v1/models/gemini-3.1-flash-image:generateContent')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer sk-xxxxxxxxxx'
request['Content-Type'] = 'application/json'
request.body = {
contents: [
{
role: 'user',
parts: [
{
text: '一只可爱的橙色小猫坐在花园里'
}
]
}
],
generationConfig: {
responseModalities: [
'TEXT',
'IMAGE'
],
imageConfig: {
aspectRatio: '16:9',
imageSize: '2K'
}
}
}.to_json
response = http.request(request)
puts response.body
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{
"inlineData": {
"mimeType": "image/png",
"data": "iVBORw0KGgoAAAANSUhEUgAAAAQAAAAECAIA..."
}
},
{
"inlineData": {
"mimeType": "image/png",
"data": "iVBORw0KGgoAAAANSUhEUgAACAAAAAgACAIA..."
}
}
]
},
"finishReason": "STOP"
}
],
"usageMetadata": {
"promptTokenCount": 13,
"candidatesTokenCount": 1680,
"totalTokenCount": 1693,
"trafficType": "ON_DEMAND",
"promptTokensDetails": [
{
"modality": "TEXT",
"tokenCount": 13
}
],
"candidatesTokensDetails": [
{
"modality": "IMAGE",
"tokenCount": 1680
}
]
},
"modelVersion": "gemini-3.1-flash-image",
"createTime": "2026-06-24T02:41:32.820834Z",
"responseId": "3EM7auKMMvmTmecP2dTdsAE"
}
简介
Nano Banana 对应 Google Gemini 原生图像生成能力,包括 Nano Banana(gemini-2.5-flash-image)、Nano Banana 2(gemini-3.1-flash-image、gemini-3.1-flash-image-preview)与 Nano Banana Pro(gemini-3-pro-image)。调用 MixRoute 原生接口时,使用端点 POST /v1/models/<model>:generateContent,并传入符合 Gemini 原生结构的 JSON Payload,支持文生图、图生图及多图融合等能力。
完整参数与多模型说明请参见 图片生成。
认证
Bearer Token,如Bearer sk-xxxxxxxxxx
支持的模型
| 模型 ID | 说明 |
|---|---|
gemini-2.5-flash-image | Nano Banana,高性价比文生图/图生图,输出为固定 1024px 级尺寸 |
gemini-3.1-flash-image | Nano Banana 2,卓越画质与速度平衡,支持 1K、2K、4K 输出 |
gemini-3.1-flash-image-preview | Nano Banana 2 预览版,支持图像生成测试 |
gemini-3-pro-image | Nano Banana Pro,更高画质与极强细节控制,支持 1K、2K、4K 输出 |
基础示例
- 文生图
- 图生图
curl -X POST "https://api.mixroute.ai/v1/models/gemini-3.1-flash-image:generateContent" \
-H "Authorization: Bearer sk-xxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "一只可爱的橙色小猫坐在花园里,阳光明媚,高质量摄影"
}
]
}
],
"generationConfig": {
"responseModalities": [
"TEXT",
"IMAGE"
],
"imageConfig": {
"aspectRatio": "16:9",
"imageSize": "2K"
}
}
}'
curl -X POST "https://api.mixroute.ai/v1/models/gemini-3.1-flash-image:generateContent" \
-H "Authorization: Bearer sk-xxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "根据这张图生成一张俯瞰广州塔的图片"
},
{
"inlineData": {
"mimeType": "image/png",
"data": "iVBORw0KGgoAAA..."
}
}
]
}
],
"generationConfig": {
"responseModalities": [
"TEXT",
"IMAGE"
],
"imageConfig": {
"aspectRatio": "16:9",
"imageSize": "2K"
}
}
}'
请求参数
string
required
Gemini 原生(图像)模型标识,位于 URL 路径中,如
gemini-3.1-flash-image 或 gemini-3-pro-image。array
required
原生对话或图像内容列表。
object
生成配置参数。
Show generationConfig 子字段
Show generationConfig 子字段
array
响应模态。如传入该字段,需包含
"IMAGE";常用写法为 ["TEXT", "IMAGE"]。object
图像生成配置。
Show imageConfig 子字段
Show imageConfig 子字段
string
输出图像的宽高比。
gemini-2.5-flash-image 与 gemini-3-pro-image 支持 "1:1"、"2:3"、"3:2"、"3:4"、"4:3"、"4:5"、"5:4"、"9:16"、"16:9"、"21:9";gemini-3.1-flash-image 系列另外支持 "1:4"、"4:1"、"1:8"、"8:1"。string
输出分辨率或尺寸档位。
gemini-2.5-flash-image 不使用该字段,按宽高比返回固定 1024px 级尺寸;gemini-3.1-flash-image 系列与 gemini-3-pro-image 支持 "1K"、"2K"、"4K"。响应格式
接口返回 JSON 格式的响应,图像以一个或多个 Base64 编码的inlineData 形式内嵌在 candidates 中:
| 字段 | 类型 | 说明 |
|---|---|---|
candidates[].content.parts[].inlineData.mimeType | string | 图像 MIME 类型(如 image/png) |
candidates[].content.parts[].inlineData.data | string | 图像的 Base64 编码数据 |
candidates[].finishReason | string | 生成结束原因,如 "STOP" |
usageMetadata.promptTokenCount | integer | 输入 token 数 |
usageMetadata.candidatesTokenCount | integer | 输出 token 数(图像 token) |
modelVersion | string | 实际使用的模型版本 |
createTime | string | 生成时间(ISO 8601) |
responseId | string | 响应唯一标识 |
curl --request POST \
--url https://api.mixroute.ai/v1/models/gemini-3.1-flash-image:generateContent \
--header 'Authorization: Bearer sk-xxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "一只可爱的橙色小猫坐在花园里"
}
]
}
],
"generationConfig": {
"responseModalities": [
"TEXT",
"IMAGE"
],
"imageConfig": {
"aspectRatio": "16:9",
"imageSize": "2K"
}
}
}'
import requests
url = "https://api.mixroute.ai/v1/models/gemini-3.1-flash-image:generateContent"
headers = {
"Authorization": "Bearer sk-xxxxxxxxxx",
"Content-Type": "application/json"
}
payload = {
"contents": [
{
"role": "user",
"parts": [
{
"text": "一只可爱的橙色小猫坐在花园里"
}
]
}
],
"generationConfig": {
"responseModalities": [
"TEXT",
"IMAGE"
],
"imageConfig": {
"aspectRatio": "16:9",
"imageSize": "2K"
}
}
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
const response = await fetch('https://api.mixroute.ai/v1/models/gemini-3.1-flash-image:generateContent', {
method: 'POST',
headers: {
'Authorization': 'Bearer sk-xxxxxxxxxx',
'Content-Type': 'application/json'
},
body: JSON.stringify({
contents: [
{
role: "user",
parts: [
{
text: "一只可爱的橙色小猫坐在花园里"
}
]
}
],
generationConfig: {
responseModalities: [
"TEXT",
"IMAGE"
],
imageConfig: {
aspectRatio: "16:9",
imageSize: "2K"
}
}
})
});
const data = await response.json();
console.log(data);
<?php
$client = new GuzzleHttp\Client();
$response = $client->post('https://api.mixroute.ai/v1/models/gemini-3.1-flash-image:generateContent', [
'headers' => [
'Authorization' => 'Bearer sk-xxxxxxxxxx',
'Content-Type' => 'application/json',
],
'json' => [
'contents' => [
[
'role' => 'user',
'parts' => [
[
'text' => '一只可爱的橙色小猫坐在花园里'
]
]
]
],
'generationConfig' => [
'responseModalities' => [
'TEXT',
'IMAGE'
],
'imageConfig' => [
'aspectRatio' => '16:9',
'imageSize' => '2K'
]
]
]
]);
echo $response->getBody();
package main
import (
"bytes"
"encoding/json"
"net/http"
)
func main() {
payload := map[string]interface{}{
"contents": []interface{}{
map[string]interface{}{
"role": "user",
"parts": []interface{}{
map[string]interface{}{
"text": "一只可爱的橙色小猫坐在花园里",
},
},
},
},
"generationConfig": map[string]interface{}{
"responseModalities": []string{
"TEXT",
"IMAGE",
},
"imageConfig": map[string]interface{}{
"aspectRatio": "16:9",
"imageSize": "2K",
},
},
}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://api.mixroute.ai/v1/models/gemini-3.1-flash-image:generateContent", bytes.NewBuffer(body))
req.Header.Set("Authorization", "Bearer sk-xxxxxxxxxx")
req.Header.Set("Content-Type", "application/json")
http.DefaultClient.Do(req)
}
import java.net.http.*;
import java.net.URI;
HttpClient client = HttpClient.newHttpClient();
String json = """
{
"contents": [
{
"role": "user",
"parts": [
{
"text": "一只可爱的橙色小猫坐在花园里"
}
]
}
],
"generationConfig": {
"responseModalities": [
"TEXT",
"IMAGE"
],
"imageConfig": {
"aspectRatio": "16:9",
"imageSize": "2K"
}
}
}
""";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.mixroute.ai/v1/models/gemini-3.1-flash-image:generateContent"))
.header("Authorization", "Bearer sk-xxxxxxxxxx")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(json))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
require 'net/http'
require 'json'
uri = URI('https://api.mixroute.ai/v1/models/gemini-3.1-flash-image:generateContent')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer sk-xxxxxxxxxx'
request['Content-Type'] = 'application/json'
request.body = {
contents: [
{
role: 'user',
parts: [
{
text: '一只可爱的橙色小猫坐在花园里'
}
]
}
],
generationConfig: {
responseModalities: [
'TEXT',
'IMAGE'
],
imageConfig: {
aspectRatio: '16:9',
imageSize: '2K'
}
}
}.to_json
response = http.request(request)
puts response.body
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{
"inlineData": {
"mimeType": "image/png",
"data": "iVBORw0KGgoAAAANSUhEUgAAAAQAAAAECAIA..."
}
},
{
"inlineData": {
"mimeType": "image/png",
"data": "iVBORw0KGgoAAAANSUhEUgAACAAAAAgACAIA..."
}
}
]
},
"finishReason": "STOP"
}
],
"usageMetadata": {
"promptTokenCount": 13,
"candidatesTokenCount": 1680,
"totalTokenCount": 1693,
"trafficType": "ON_DEMAND",
"promptTokensDetails": [
{
"modality": "TEXT",
"tokenCount": 13
}
],
"candidatesTokensDetails": [
{
"modality": "IMAGE",
"tokenCount": 1680
}
]
},
"modelVersion": "gemini-3.1-flash-image",
"createTime": "2026-06-24T02:41:32.820834Z",
"responseId": "3EM7auKMMvmTmecP2dTdsAE"
}
⌘I