图像生成

用于专业级图像资产、复杂指令、多轮编辑、文字渲染和高分辨率输出。

Authorization

BearerAuth

AuthorizationBearer <token>

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

In: header

Path Parameters

model*string

Gemini 模型名。

Default"gemini-3-pro-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-pro-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-pro-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"]` 或 `["TEXT","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.imageConfig.imageSize`	string	否	`1K`	输出尺寸档位，支持最高 `4K`，具体可用值以渠道为准。
`generationConfig.candidateCount`	integer	否	`1`	候选数量，建议保持 `1` 以降低延迟和费用。
`safetySettings`	array	否	无	Gemini 安全策略设置。

示例代码

curl "https://api.tokaify.com/v1beta/models/gemini-3-pro-image-preview:generateContent" \
  -H "Authorization: Bearer $TOKAIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{ "role": "user", "parts": [{ "text": "生成一张 4K 产品海报，标题为 Tokaify API，深色科技风，文字清晰" }] }],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "imageConfig": { "aspectRatio": "16:9", "imageSize": "4K" }
    }
  }'

import requests

response = requests.post(
    "https://api.tokaify.com/v1beta/models/gemini-3-pro-image-preview:generateContent",
    headers={"Authorization": "Bearer YOUR_TOKAIFY_API_KEY"},
    json={
        "contents": [{"role": "user", "parts": [{"text": "生成一张 4K 产品海报，标题为 Tokaify API，深色科技风，文字清晰"}]}],
        "generationConfig": {"responseModalities": ["IMAGE"], "imageConfig": {"aspectRatio": "16:9", "imageSize": "4K"}},
    },
)
print(response.json())

const response = await fetch("https://api.tokaify.com/v1beta/models/gemini-3-pro-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: "生成一张 4K 产品海报，标题为 Tokaify API，深色科技风，文字清晰" }] }],
    generationConfig: { responseModalities: ["IMAGE"], imageConfig: { aspectRatio: "16:9", imageSize: "4K" } },
  }),
});
console.log(await response.json());

响应示例

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

业务提示

计费倍率按后台模型倍率与渠道倍率配置执行。高分辨率会显著增加延迟和消耗；预览模型可能存在可用性变化，生产环境建议配置备用模型。