62 lines
2.7 KiB
Markdown
62 lines
2.7 KiB
Markdown
# Gemini 图片生成
|
|
|
|
Gemini 图片插件调用 `generateContent`，把提示词和参考图组织为一个 `user` content。Data URL 被拆为 `inline_data`，外部 URL 被发送为 `file_data.file_uri`；响应从候选内容中的内联图片解析。
|
|
|
|
## 接口与鉴权
|
|
|
|
{{OPERATIONS}}
|
|
|
|
```http
|
|
POST {channel_base_url}/v1beta/models/{model}:generateContent
|
|
x-goog-api-key: <GEMINI_API_KEY>
|
|
Content-Type: application/json
|
|
```
|
|
|
|
通过后端渠道中转时，API Key 必须留在服务端头部，不能放进浏览器 URL。Vertex AI 使用不同 Base URL、OAuth 与资源路径，除非网关转换协议，否则不能直接复用此插件。
|
|
|
|
## 模型与输出模式
|
|
|
|
只有支持原生图片输出的 Gemini 模型才能返回内联图片。模型 ID 原样放进 URL 并进行路径转义。插件不维护模型白名单、图片尺寸表或计费，因为这些应由官方模型页和渠道模型配置共同确定。
|
|
|
|
## 参数与字段映射
|
|
|
|
{{PARAMETERS}}
|
|
|
|
`aspectRatio -> generationConfig.imageConfig.aspectRatio`。`quality` 优先、`resolution` 回退，经插件映射为 `generationConfig.imageConfig.imageSize`（仅 `1K` / `2K` / `4K`）；未知值（如画布视频清晰度 `720`）省略，不能覆盖已选的图片档位。多图由宿主按次创建，不映射 `candidateCount`。`extra` 可替换 `generationConfig`、`safetySettings` 和 `systemInstruction`；替换完整配置时调用方必须保留所需图片输出配置。
|
|
|
|
## 文生图请求
|
|
|
|
```bash
|
|
curl "{channel_base_url}/v1beta/models/YOUR_MODEL:generateContent" \
|
|
-H "x-goog-api-key: <GEMINI_API_KEY>" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{
|
|
"contents":[{"role":"user","parts":[{"text":"复古科幻电影海报，中文标题清晰"}]}],
|
|
"generationConfig":{"imageConfig":{"aspectRatio":"3:4","imageSize":"2K"}}
|
|
}'
|
|
```
|
|
|
|
## 参考图请求
|
|
|
|
```json
|
|
{
|
|
"contents":[{"role":"user","parts":[
|
|
{"text":"保持人物一致，改为冬季服装"},
|
|
{"inline_data":{"mime_type":"image/png","data":"<BASE64>"}}
|
|
]}]
|
|
}
|
|
```
|
|
|
|
外部 URL 会被构造成 `file_data.file_uri`。该 URI 是否允许任意 HTTP URL 取决于上游；如果官方只接受 Files API URI，必须先上传文件，当前插件不会自动代传。
|
|
|
|
## 响应解析与安全
|
|
|
|
解析器遍历 `candidates[].content.parts[]`，识别 `inlineData` 或 `inline_data`，再生成 `data:<mime>;base64,...`。只有文本、finishReason 或安全反馈而没有内联图片时请求会失败。大图片不能进入 localStorage，应立即转存到宿主资源存储。
|
|
|
|
## 官方资料
|
|
|
|
- [Gemini native image generation](https://ai.google.dev/gemini-api/docs/image-generation)
|
|
- [Gemini generateContent API](https://ai.google.dev/api/generate-content)
|
|
|
|
{{CONTRACT}}
|