图像编辑

用于快速图像编辑、局部重绘、风格转换和宽画幅素材改版。

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`。

示例代码

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 横幅，保持主体在左侧，右侧留出标题空间" },
        { "inline_data": { "mime_type": "image/png", "data": "BASE64_IMAGE" } }
      ]
    }],
    "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 横幅，保持主体在左侧，右侧留出标题空间"},
            {"inline_data": {"mime_type": "image/png", "data": "BASE64_IMAGE"}},
        ]}],
        "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 横幅，保持主体在左侧，右侧留出标题空间" },
      { inline_data: { mime_type: "image/png", data: "BASE64_IMAGE" } },
    ] }],
    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"
    }
  ]
}

业务提示

计费倍率按后台模型倍率与渠道倍率配置执行。极端画幅编辑可能牺牲主体细节稳定性。