- Plugin Configuration
- List Models
- OpenAI Format (Supports Major Official Provider Models)
- Chat (Responses)
- ChatGPT APIs
- Images
- Audio
- Embeddings
- Anthropic Format
- Google Gemini APIs
- Native Format
- Text-to-Image (Aspect Ratio + Clarity Controls)
- Generate Image
- Text Generation
- Text Generation (Streaming)
- Text Generation + Reasoning (Streaming)
- Image Generation
- Formatted Output
- Function Calling
- Document Understanding
- URL context [native format]
- Code Execution
- google search
- Video Understanding
- URL context
- Video understanding-url [native format]
- Imagen 4 under development
- Audio Understanding
- Embeddings
- Chat
- Edit Image
- Image-to-Image Base64 Request (Officially Recommended)
- Multi-Image Fusion Generation with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)POST
- Image EditingPOST
- Single Image with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)POST
- Image Generation with gemini-2.5-flash-imagePOST
- Image Generation with gemini-2.5-flash-image (Aspect Ratio Control)POST
- Image UnderstandingPOST
- Multi-Image Fusion Generation with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
- Image-to-Image URL Request / OpenAI-style URL Request
- Image-to-Image URL Request (Not Currently Supported)
- Image-to-Image URL Request, Gemini Format (Not Currently Supported)
- NanoBanana
- Image-to-Image Base64 Request (Officially Recommended)
- Multi-Image Fusion Generation with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
- Image Editing
- Single Image with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
- Image Generation with gemini-2.5-flash-image
- Image Generation with gemini-2.5-flash-image (Aspect Ratio Control)
- Image Understanding
- Gemini Request Format
- OpenAI Request Format
- Image-to-Image Base64 Request (Officially Recommended)
- Midjourney Format
- Doubao Video Generation
- Doubao Image Generation
- Jimeng AI
- Rerank Models
- Text-to-Music (Suno)
- Veo Video Generation
- Sora Video Generation
- Kling (Kuaishou)
- Wan (Qwen)
- MinMax Video Generation
- Vidu Video Generation
Multi-Image Fusion Generation with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
POST
/v1beta/models/gemini-3-pro-image-preview:generateContent
Request
Query Params
Header Params
Body Params application/json
Example
{
"contents": [
{
"role": "user",
"parts": [
{
"text": "Generate an explosion diagram with a consistent style based on the shape of the main house, and still use white to mark key components and mark them outside the diagram. The main frame is located in the center of the picture. The disassembled construction is arranged around the main frame according to the spatial relationship, which not only separates but also reflects the assembly relationship, and the structural dimensions are marked locally."
},
{
"inline_data": {
"mime_type": "image/jpeg",
"data": "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 Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff '/v1beta/models/gemini-3-pro-image-preview:generateContent?key={{YOUR_API_KEY}}' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "Generate an explosion diagram with a consistent style based on the shape of the main house, and still use white to mark key components and mark them outside the diagram. The main frame is located in the center of the picture. The disassembled construction is arranged around the main frame according to the spatial relationship, which not only separates but also reflects the assembly relationship, and the structural dimensions are marked locally."
},
{
"inline_data": {
"mime_type": "image/jpeg",
"data": "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
🟢200OK
application/json
Bodyapplication/json
Example
{}Modified at 2026-07-09 10:12:26