1. 引言
AIone API
  • 引言
    • 快速开始
    • 认证方式
    • 错误码说明
    • 定价说明
    • 联系我们
    • 服务质量保障
    • 完整请求案例
    • 关于缓存与成本优化
    • 模型质量监控与保障
    • 关于模型真实性验证
    • 在IDE中使用AIone
    • 网络与连接说明
    • 模型命名与兼容规则
    • Gemini 图片生成
  • 聊天(Chat)
    • 基础文本对话
      POST
    • 流式响应
      POST
  • 模型(Models)
    • 获取模型列表
      GET
    • List Models
      GET
  • API Key 管理
    • List Keys
      GET
    • Create Key
      POST
    • Get Key
      GET
    • Update Key
      PUT
    • Delete Key
      DELETE
    • Rotate Key
      PUT
    • Disable Key
      PUT
    • Enable Key
      PUT
  • 用量统计
    • Query Usage
    • Get Dashboard
  • 账单
    • Get Current Plan
    • Get Billing Account
    • List Invoices
  • 数据模型
    • HTTPValidationError
    • DashboardResponse
    • KeyCreateRequest
    • KeyListResponse
    • PlanDetailResponse
    • ModelListResponse
    • KeyResponse
    • InvoiceListResponse
    • KeyRotateResponse
    • BillingAccountResponse
    • UsageRow
    • KeyUpdateRequest
    • ValidationError
    • TechDashboardData
    • ModelInfo
    • BusinessDashboardData
    • DailyTrend
    • TeamCostItem
    • ModelDistribution
  1. 引言

Gemini 图片生成

Gemini 图片生成#

概述#

AIone 已支持 Gemini 图片生成模型,并统一通过 OpenAI Compatible 的 /v1/chat/completions 端点访问。
这一组模型在网关内部会自动切换到 Gemini 原生图片生成链路,再转换回 OpenAI 兼容响应格式。因此你的请求方式仍然保持统一,但可以额外使用图片生成相关参数。

当前已接入的图片模型#

目前已接入以下 Gemini 图片模型:
gemini-3-pro-image-preview
gemini-3-pro-image-preview-2k
gemini-3-pro-image-preview-4k
gemini-2.5-flash-image
gemini-3.1-flash-image-preview
如果你不确定模型名,请以 GET https://api.nexara.net/v1/models 和 Portal 模型列表页为准。

最小可用示例#

说明:
不传 aspect_ratio 和 image_size 也可以正常出图
返回结果仍然是 OpenAI 兼容的 chat.completion 结构

带比例与尺寸参数的示例#

支持的请求参数#

通用参数#

model:图片模型 ID
messages:对话消息数组,仍然遵循 OpenAI Chat Completions 格式
max_tokens / max_completion_tokens:会映射到 Gemini 原生的 maxOutputTokens
temperature
top_p
top_k

图片相关参数#

aspect_ratio:会映射到 Gemini 原生的 imageConfig.aspectRatio
image_size:会映射到 Gemini 原生的 imageConfig.imageSize
这两个参数不传也能正常出图。

参考图输入#

如果你需要传参考图,可以使用 OpenAI 风格的多模态 messages.content:
{
  "model": "gemini-3-pro-image-preview",
  "messages": [
    {
      "role": "user",
      "content": [
        {"type": "text", "text": "参考这张图的构图,画一只坐在窗边的猫"},
        {
          "type": "image_url",
          "image_url": {
            "url": "data:image/png;base64,iVBORw0KGgoAAA..."
          }
        }
      ]
    }
  ],
  "max_tokens": 4096
}
注意:
当前网关对 Gemini 原生链路只保证 data: URI 格式的 image_url.url
如果直接传公网图片 URL,网关不会把它转换成 Gemini 原生图片输入

返回结果说明#

图片模型返回的 choices[0].message.content 可能不是普通字符串,而是数组:
{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "model": "gemini-3-pro-image-preview",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": [
          {"type": "text", "text": "这是为你生成的图片:"},
          {
            "type": "image_url",
            "image_url": {
              "url": "data:image/png;base64,AAAA..."
            }
          }
        ]
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 123,
    "completion_tokens": 456,
    "total_tokens": 579
  }
}
这意味着:
有些返回会同时包含说明文字和图片
图片内容通过 image_url.url 返回,通常是 data:image/...;base64,... 格式
usage 字段仍然会返回,便于你在控制台和响应结果中核对消耗

限制与注意事项#

1.
仅支持 /v1/chat/completions:Gemini 图片模型不支持 /v1/messages
2.
不支持流式返回:stream 必须为 false 或不传
3.
响应内容可能是数组:不要假设 choices[0].message.content 一定是纯文本字符串
4.
模型权限:请确认你的 API Key 有权访问对应图片模型
5.
模型选择:如果你明确要使用接入好的 2K / 4K 变体,可以直接选择 gemini-3-pro-image-preview-2k 或 gemini-3-pro-image-preview-4k
修改于 2026-04-02 05:28:06
上一页
模型命名与兼容规则
下一页
基础文本对话
Built with