请输入
菜单

Gemini 图片生成(聊天兼容格式)

通过 OpenAI 聊天格式调用支持图片输出的 Gemini 模型。

请求

项目 说明
方法 POST
路径 /v1/chat/completions
网关地址 https://ailink.nativex.com
认证 Authorization: Bearer sk-xxxx,替换为你的 API Key
请求格式 application/json

示例中的 MODEL_ID 请替换为「模型广场」中支持本接口的模型名称。模型、参数支持范围与可用权限以当前账户为准。

参数说明

参数 位置 类型 必填 说明
model Body string 是 支持图片输出及聊天兼容调用的 Gemini 模型
messages Body object[] 是 以 user 消息描述要生成或编辑的图片
stream Body boolean 否 是否使用 SSE;示例使用 false
这是聊天兼容接口,图片结果不采用 Images API 的 data[] 结构。需要 imageConfig 等原生配置时,优先使用 Gemini 原生接口。

调用示例

curl -X POST 'https://ailink.nativex.com/v1/chat/completions' \
  -H 'Authorization: Bearer sk-xxxx' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "MODEL_ID",
  "messages": [
    {
      "role": "user",
      "content": "画一只坐在窗边的橘猫,水彩风格。"
    }
  ],
  "stream": false
}'

响应

以下为便于阅读的简化结构示例,标识、链接、文本及用量均为示意值。

{
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "![生成图片](https://example.com/generated.png)"
      },
      "finish_reason": "stop"
    }
  ]
}
字段或结果 说明
choices[].message.content 兼容格式可能以 Markdown 图片或数据链接返回图片;以实际结果为准

错误处理

非成功响应时,先查看 HTTP 状态和错误正文。检查 API Key、模型名称、账户额度及参数;遇到限流时降低并发并稍后重试。

最近修改: 2026-10-28