图像生成

用于 Nano Banana 2 高效率图像生成、图像编辑、宽画幅素材和批量创意探索。

Authorization

BearerAuth

AuthorizationBearer <token>

模型 relay 接口鉴权。请求头：Authorization: Bearer 。

In: header

Path Parameters

model*string

Gemini 模型名。

Default"gemini-3.1-flash-image-preview"

输入内容数组，用于承载用户、模型或工具之间的一轮或多轮消息。每个元素是一个 Content 对象，通常包含 role 与 parts：role 表示消息来源，常用 user、model，单轮用户输入可省略；parts 是内容片段数组，可包含 text 文本、inlineData/inline_data Base64 媒体数据（需提供 mime_type 与 data）、functionCall、functionResponse、executableCode 或 codeExecutionResult。适用于文本对话、图片/音频/视频/文档理解、函数调用和多模态生成等场景。数组长度及媒体大小以上游模型和业务配置限制为准。

systemInstruction?object

Gemini 系统指令。

generationConfig?

生成配置，例如温度、topK、topP、最大输出长度。

safetySettings?

安全策略设置。 safetySettings 列表。范围：数组长度以上游或业务配置为准。

tools?

Gemini 工具定义。工具定义列表。范围：数组长度和 schema 复杂度以上游限制为准。

Response Body

application/json

curl -X POST "https://api.tokaify.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "写一首四句的中文短诗，主题是城市夜雨。"
          }
        ]
      }
    ],
    "generationConfig": {
      "temperature": 0.7,
      "maxOutputTokens": 100000
    }
  }'

curl -X POST "https://api.tokaify.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent" \  -H "Content-Type: application/json" \  -d '{    "contents": [      {        "parts": [          {            "text": "写一首四句的中文短诗，主题是城市夜雨。"          }        ]      }    ],    "generationConfig": {      "temperature": 0.7,      "maxOutputTokens": 100000    }  }'

{
  "candidates": [],
  "usageMetadata": {},
  "modelVersion": "string"
}

请求参数

字段	类型	必选	默认值	描述
`contents`	array	是	无	Gemini 内容数组，支持文本和输入图像。
`contents[].parts[].text`	string	是	无	图像生成提示词。
`contents[].parts[].inline_data`	object	否	无	输入参考图，包含 `mime_type` 与 Base64 `data`。
`generationConfig.responseModalities`	string[]	否	`["TEXT","IMAGE"]`	返回模态，建议 `["IMAGE"]`。
`generationConfig.imageConfig.aspectRatio`	string	否	`1:1`	支持 `1:1`、`1:4`、`1:8`、`2:3`、`3:2`、`3:4`、`4:1`、`4:3`、`4:5`、`5:4`、`8:1`、`9:16`、`16:9`、`21:9`。
`generationConfig.candidateCount`	integer	否	`1`	候选数量，建议保持 `1`。
`safetySettings`	array	否	无	Gemini 安全策略设置。

示例代码

curl "https://api.tokaify.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent" \
  -H "Authorization: Bearer $TOKAIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{ "role": "user", "parts": [{ "text": "生成一张 21:9 的 AI 模型路由横幅，适合技术文档首页" }] }],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "imageConfig": { "aspectRatio": "21:9" }
    }
  }'

import requests

response = requests.post(
    "https://api.tokaify.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent",
    headers={"Authorization": "Bearer YOUR_TOKAIFY_API_KEY"},
    json={
        "contents": [{"role": "user", "parts": [{"text": "生成一张 21:9 的 AI 模型路由横幅，适合技术文档首页"}]}],
        "generationConfig": {"responseModalities": ["IMAGE"], "imageConfig": {"aspectRatio": "21:9"}},
    },
)
print(response.json())

const response = await fetch("https://api.tokaify.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.TOKAIFY_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    contents: [{ role: "user", parts: [{ text: "生成一张 21:9 的 AI 模型路由横幅，适合技术文档首页" }] }],
    generationConfig: { responseModalities: ["IMAGE"], imageConfig: { aspectRatio: "21:9" } },
  }),
});
console.log(await response.json());

响应示例

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [{ "inlineData": { "mimeType": "image/png", "data": "iVBORw0KGgoAAAANSUhEUg..." } }]
      },
      "finishReason": "STOP"
    }
  ],
  "usageMetadata": { "promptTokenCount": 36, "candidatesTokenCount": 1600, "totalTokenCount": 1636 }
}

业务提示

计费倍率按后台模型倍率与渠道倍率配置执行。该模型支持更宽/更窄的特殊画幅；极端画幅适合横幅、长图或移动端封面。