API Doc-CometAPI
HomeDashBoardModel Marketplace
HomeDashBoardModel Marketplace
Discord_Support
  1. Gemini
  • How to Use CometAPI?
  • šŸš€ Overview
    • Quick Start
    • Important Guidelines
    • Release Notes
    • Quickly request CometAPI via ApiDog
    • Models
  • šŸ’¬ Text Models
    • Chat
    • Responses
    • Anthropic Messages
    • Gemini Generating Content
    • Embeddings
  • šŸ–¼ļø Image Models
    • OpenAI
      • gpt-4o-image generates image
      • Images
      • Image Editing (gpt-image-1)
    • Gemini
      • Guide to calling gemini-3-pro-image (Nano Banana)
      • Gemini generates image
        POST
    • Midjourney
      • Midjourney Quick Start: Complete Image Generation Workflow in One Go
      • Task Fetching API
        • List by Condition
        • Fetch Single Task (most recommended)
      • Imagine
      • Submit Video
      • Submit Editor
      • Action (UPSCALE; VARIATION; REROLL; ZOOM, etc.)
      • Blend (image -> image)
      • Describe (image -> text)
      • Modal (Area Redesign & Zoom)
    • Replicate(image)
      • Create Predictions - General
      • replicate query
    • seededit/seedream
      • bytedance-Image Editing (seededit)
      • bytedance-image-generation(seedream)
    • bria
      • Generate Image
      • Generate Vector Graphics - Base (Beta)
      • Image Editing
      • Query Status
    • Flux(images)
      • flux generate image
      • flux query
    • Hunyuan3D
      POST
  • šŸ“ŗ Video Models
    • sora-2
      • official
        • Create video
        • Remix video
        • Retrieve video
        • Retrieve video content
      • self-developed
        • Create video
        • Retrieve video
    • veo3
      • veo3-chat format
      • Submit video generation task
      • Query video generation status
    • kling (video)
      • callback_url
      • Multimodal Video Editing
        • Initialize Video for Editing
        • Add Video Selection
        • Delete Video Selection
        • Clear Video Selection
        • Preview Selected Video Area
        • Create Task
      • Text to Video
      • Image to Video
      • Multi-Image To Video
      • Video Extension
      • Avatar
      • Lip-Sync
      • Video Effects
      • Text to Audio
      • Video to Audio
      • TTS
      • Image Generation
      • Multi-Image to Image
      • Image Expansion
      • Image Recognize
      • Virtual Try-On
      • [Counterpart] Creating Tasks
      • lip sync
      • Individual queries
    • runway(video)
      • official format
        • runway images raw video
        • Generate a video from a video
        • Generate an image from text
        • Upscale a video
        • Control a character
        • runway to get task details
      • Reverse Format
        • generate(text)
        • generate(Reference images)
        • Video to Video Style Redraw
        • Act-one Expression Migration
        • feed-get task
    • bytedance
      • bytedance-video
      • bytedance-video get
    • MiniMax Conch(video)
      • MiniMax Conch Official Documentation
      • MiniMax Conch Generation
      • MiniMax Conch Query
      • MiniMax Conch Download
  • šŸŽµ Music Models
    • Suno
      • Setting suno Version
      • Suno API Scenario Application Guide
      • Generate lyrics
      • Generate music clip
      • Upload clip
      • Submit concatenation
      • Full Track Audio Separation
      • Single Track Audio Separation
      • Create New Persona
      • add style tags
      • Single task query
      • Generate mp4 mv video
      • Timing: lyrics, audio timeline
      • Get wav format file
      • Get midi
      • Batch query tasks
  • šŸ”Š Audio Models
    • Realtime
    • Create speech
    • Create transcription
    • Create translation
  • 🧩 Integration Guides
    • LiteLLM
    • Dify
    • Make
    • n8n
    • Lobe-Chat
    • COZE
    • Zapier
    • Activepieces
    • LlamaIndex
    • Continue
    • FlowiseAI
    • Chatbox
    • CherryStudio
    • AnythingLLM
    • LangChain
    • BuildShip
    • gptme
    • Immersive Translation
    • Cline
    • Eudic Translation
    • ChatHub
    • OpenAI Translator
    • ChatAll Translation
    • Pot Translation
    • Zotero
    • NEXT CHAT (ChatGPT Next Web)
    • Obsidian's Text Generator Plugin
    • librechat
    • utools-ChatGPT Friend
    • avante.nvim
    • Open WebUI
    • GPT Academic Optimization (gpt_academic)
    • OpenManus
    • IntelliJ Translation Plugin
    • FastGPT
    • n8n Local Deployment
  • āš ļø Errors
    • Error Codes & Handling
  • šŸ“ Code Examples
    • Text-to-Image Generation
    • Image-to-image generation URL upload
    • Regular Post Text Conversation
    • OpenAI Official Library Usage Example
    • Streamed Output
    • Json Fixed Format Output Code Display
    • Embedding code example
    • o1-preview Model Code Example
    • LangChain Usage Example (Successful Test Date: 2024-11-25)
    • Openai dall-e-3 & flux series drawing model
    • gpt, claude, gemini multimodal network image parsing example
    • Multimodal PDF File Parsing Examples for GPT, Claude, and Gemini
    • Code example
  • šŸ„šŸ¼ā€ā™€ļø Best Practices
    • Midjourney Best Practices
    • Retry Logic Documentation for CometAPI and OpenAI Official API
    • Runway Best Practices
    • Claude Code Installation and Usage Guide
    • Gemini CLI Installation and Usage Guide
    • Codex Usage Guide
    • CometAPI Account Balance Query API Usage Instructions
  • šŸ’³ Pricing & Billing
    • About Pricing
  • šŸ¤šŸ¼ Support
    • Help Center
    • Interface Stability
    • Privacy policy
    • Terms of service
    • Common Misconceptions
    • Confusion about use
  1. Gemini

Gemini generates image

POST
https://api.cometapi.com/v1beta/models/{model}:generateContent
Maintainer:Not configured
Gemini Native Format Raw Graph, guide refer to: https://apidoc.cometapi.com/guide-to-calling-gemini-2-5-flash-image-1425263m0

šŸŽ‰ Gemini 3 Pro Image Now Supported!#

gemini-3-pro-image is now available! If you want to use Gemini models for image generation, we highly recommend reading the official Gemini documentation:
šŸ‘‰ https://ai.google.dev/gemini-api/docs/image-generation
You only need to replace https://generativelanguage.googleapis.com with https://api.cometapi.com
Generate images up to 4K resolution Example:
Multi-turn image editing Example:

šŸŒ Flash 2.5 Image Updates#

a. Flexible Aspect Ratios#

Now supports multiple aspect ratio settings for easy content creation across different devices. All resolutions consume 1,290 tokens by default.
Supported aspect ratios:
1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
Reference examples:
https://ai.google.dev/gemini-api/docs/image-generation#aspect_ratios
https://cloud.google.com/vertex-ai/generative-ai/docs/multimodal/image-generation#googlegenaisdk_imggen_mmflash_with_txt-drest
https://github.com/GoogleCloudPlatform/generative-ai/blob/main/gemini/getting-started/intro_gemini_2_5_image_gen.ipynb

b. Model Name Update#

All new features will be available on the new model ID: gemini-2.5-flash-image. The previous gemini-2.5-flash-image-preview will be deprecated.
āš ļø Migration required by October 31, 2025

c. Force Image Output#

To address the frequent issue of text-only outputs, you can now set "responseModalities" to ["IMAGE"] only in API requests. This ensures image generation without text-only responses.

Request

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST 'https://api.cometapi.com/v1beta/models/gemini-3-pro-image:generateContent' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "'\''Maintain the character features in the image to generate a new portrait photo: a woman leaning on a wooden railing of a traditional Chinese building. She is wearing a blue cheongsam with pink and red floral motifs and a headdress made of colorful flowers, including roses and lilacs. Her right hand gently touches a large kite with a blue background, decorated with pink fish motifs and a pair of large eyes. The background is the interior of an old wooden building, dimly lit and cozy. The painting style is realistic, focusing on the textural details of the clothing patterns, floral headdresses, and wooden buildings"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "IMAGE"
        ],
        "imageConfig": {
            "aspectRatio": "9:16"
        }
    }
}'
Response Response Example
{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "iVBORw0KGgoAAAANSUhEUgAABAAAAAQACAIAAADwf7zUAAAAiXpUWHRSYXcgcHJvZmlsZSB0eXBlIGlwdGMAAAiZTYwxDgIxDAT7vOKekDjrtV1T0VHwgbtcIiEhgfh/QaDgmGlWW0w6X66n5fl6jNu9p+ULkapDENgzpj+Kl5aFfa6KnYWgSjZjGOiSYRxTY/v8KIijI/rXyc236kHdAK22RvHVummEN+91ML0BQ+siou79WmMAAAKHaVRYdFhNTDpjb20uYWRvYmUueG1wAAAAAAA8P3hwYWNrZXQgYmVnaW49Iu+7vyIgaWQ9Ilc1TTBNcENlaGlIenJlU3pOVGN6a2M5ZCI/PiA8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIiB4OnhtcHRrPSJYTVAgQ29yZSA1LjUuMCI+IDxyZGY6UkRGIHhtbG5zOnJkZj0iaHR0cDovL3d3dy53My5vcmcvMTk5OS8wMi8yMi1yZGYtc3ludGF4LW5zIyI+IDxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSIiIHhtbG5zOklwdGM0eG1wRXh0PSJodHRwOi8vaXB0Yy5vcmcvc3RkL0lwdGM0eG1wRXh0LzIwMDgtMDItMjkvIiB4bWxuczpwaG90b3Nob3A9Imh0dHA6Ly9ucy5hZG9iZS5jb20vcGhvdG9zaG9wLzEuMC8iIElwdGM0eG1wRXh0OkRpZ2l0YWxTb3VyY2VGaWxlVHlwZT0iaHR0cDovL2N2LmlwdGMub3JnL25ld3Njb2Rlcy9kaWdpdGFsc291cmNldHlwZS90cmFpbmVkQWxnb3JpdGhtaWNNZWRpYSIgSXB0YzR4bXBFeHQ6RGlnaXRhbFNvdXJjZVR5cGU9Imh0dHA6Ly9jdi5pcHRjLm9yZy9uZXdzY29kZXMvZGlnaXRhbHNvdXJjZXR5cGUvdHJhaW5lZEFsZ29yaXRobWljTWVkaWEiIHBob3Rvc2hvcDpDcmVkaXQ9Ik1hZGUgd2l0aCBHb29nbGUgQUkiLz4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gICA8P3hwYWNrZXQgZW5kPSJ3Ij8+fxJoawAAIABJREFUeJx0vduSJcutJOYORFZvksOxMyaNyfSm//8kfcE8SXZMErmrMgCfBwCRuZpUGXeze9XK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
Modified atĀ 2025-11-27 07:14:24
Previous
Guide to calling gemini-3-pro-image (Nano Banana)
Next
Midjourney Quick Start: Complete Image Generation Workflow in One Go
Built with