Appearance
Gemini 图像生成
Gemini 图像生成使用 Gemini-compatible 格式提交请求,nano-banana-2 和 nano-banana-pro 也归在 Gemini 图像生成下面。MoonApiX 价格页当前常见图片模型包括 gemini-3.1-flash-image-preview、gemini-3-pro-image-preview、nano-banana-2 和 nano-banana-pro。请求时请以 MoonApiX 后台、价格页或 GET /v1/models 返回的模型名为准。
推荐入口
http
POST /v1beta/models/{model}:generateContent
POST /v1beta/models/{modelName}:generateContent请求示例
bash
curl https://moonapix.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent \
-H "Authorization: Bearer <MOONAPIX_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "Generate a clean product mockup on a white studio table."
}
]
}
]
}'常用模型
| 模型 | 建议用途 |
|---|---|
gemini-3.1-flash-image-preview | Gemini 图片生成,适合速度优先的图像创作。 |
gemini-3-pro-image-preview | Gemini 图片生成,适合质量优先的图像创作。 |
nano-banana-2 | Gemini 图像生成,适合 Nano Banana 系列图片创作。 |
nano-banana-pro | Gemini 图像生成,适合更高质量的 Nano Banana 图片创作。 |
结果处理
Gemini-compatible 响应通常使用 candidates[].content.parts[] 返回文本或图片内容。业务侧应保存原始请求、模型名和最终图片 URL 或图片内容,便于重试和追踪。