图像生成

用于低延迟图像生成、局部修改、图文混合响应和多轮视觉创作。

Authorization

BearerAuth

AuthorizationBearer <token>

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

In: header

Path Parameters

model*string

Gemini 模型名。

Default"gemini-2.5-flash-image"

输入内容数组，用于承载用户、模型或工具之间的一轮或多轮消息。每个元素是一个 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-2.5-flash-image: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-2.5-flash-image:generateContent" \  -H "Content-Type: application/json" \  -d '{    "contents": [      {        "parts": [          {            "text": "写一首四句的中文短诗，主题是城市夜雨。"          }        ]      }    ],    "generationConfig": {      "temperature": 0.7,      "maxOutputTokens": 100000    }  }'

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

请求参数

字段	类型	必选	默认值	描述
`contents`	array	是	无	Gemini 内容数组。文本生成图片时传 `parts[].text`；图像编辑时可同时传 `inline_data` 图片。
`contents[].role`	string	否	`user`	消息角色，通常为 `user`。
`contents[].parts[].text`	string	是	无	图像生成提示词。
`contents[].parts[].inline_data.mime_type`	string	否	无	输入参考图 MIME，支持 `image/png`、`image/jpeg`、`image/webp`、`image/heic`、`image/heif`。
`contents[].parts[].inline_data.data`	string	否	无	Base64 编码参考图。
`generationConfig.responseModalities`	string[]	否	`["TEXT","IMAGE"]`	返回模态。只要图片可传 `["IMAGE"]`。
`generationConfig.imageConfig.aspectRatio`	string	否	`1:1`	支持 `1:1`、`3:2`、`2:3`、`3:4`、`4:3`、`4:5`、`5:4`、`9:16`、`16:9`、`21:9`。
`generationConfig.candidateCount`	integer	否	`1`	候选数量，官方默认 `1`，通常不超过 `10`。
`safetySettings`	array	否	无	Gemini 安全策略设置。

示例代码

curl "https://api.tokaify.com/v1beta/models/gemini-2.5-flash-image:generateContent" \
  -H "Authorization: Bearer $TOKAIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{ "role": "user", "parts": [{ "text": "生成一张 16:9 的现代 API 文档封面，极简，蓝白配色" }] }],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "imageConfig": { "aspectRatio": "16:9" }
    }
  }'

import requests

response = requests.post(
    "https://api.tokaify.com/v1beta/models/gemini-2.5-flash-image:generateContent",
    headers={"Authorization": "Bearer YOUR_TOKAIFY_API_KEY"},
    json={
        "contents": [{"role": "user", "parts": [{"text": "生成一张 16:9 的现代 API 文档封面，极简，蓝白配色"}]}],
        "generationConfig": {"responseModalities": ["IMAGE"], "imageConfig": {"aspectRatio": "16:9"}},
    },
)
print(response.json())

const response = await fetch("https://api.tokaify.com/v1beta/models/gemini-2.5-flash-image:generateContent", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.TOKAIFY_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    contents: [{ role: "user", parts: [{ text: "生成一张 16:9 的现代 API 文档封面，极简，蓝白配色" }] }],
    generationConfig: { responseModalities: ["IMAGE"], imageConfig: { aspectRatio: "16:9" } },
  }),
});
console.log(await response.json());

响应示例

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

业务提示

计费倍率按后台模型倍率与渠道倍率配置执行。该模型通常输出约 1024px 级图片；只需要图片时请显式设置 responseModalities=["IMAGE"]。