API Doc-CometAPI
English
  • English
  • Русский
HomeDashBoardModel Marketplace
HomeDashBoardModel Marketplace
Discord_Support
English
  • English
  • Русский
  1. Gemini
  • 🚀 Overview
    • Quick Start
    • Important Guidelines
    • Release Notes
    • Quickly request CometAPI via ApiDog
    • Models
  • 💬 Text Models
    • Chat
    • Responses
    • Anthropic Messages
    • Gemini Generating Content
    • Embeddings
    • Recognizing Images
  • 🖼️ Image Models
    • Midjourney
      • Midjourney Quick Start: Complete Image Generation Workflow in One Go
      • Task Fetching API
        • List by Condition
        • Fetch Single Task (most recommended)
      • Submit Video
      • Submit Editor
      • Imagine
      • Action (UPSCALE; VARIATION; REROLL; ZOOM, etc.)
      • Blend (image -> image)
      • Describe (image -> text)
      • Modal (Area Redesign & Zoom)
    • Replicate(image)
      • Create Predictions - General
      • replicate query
      • Create Task -flux-kontext-pro、max
      • Create Task -flux-1.1-pro
      • Create Task -flux-1.1-pro-ultra
    • seededit/seedream
      • bytedance-image-generation(seedream)
      • bytedance-Image Editing (seededit)
    • OpenAI
      • Images
      • gpt-4o-image generates image
      • Image Editing (gpt-image-1)
    • Gemini
      • Guide to calling gemini-2.5-flash-image (Nano Banana)
      • Gemini generates image
        POST
    • Hunyuan3D
      POST
  • 🎵 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
  • 📺 Video Models
    • veo3
      • veo3-chat format
      • Submit video generation task
      • Query video generation status
    • sora-2
      • official
        • Create video
        • Remix video
        • Retrieve video
        • Delete video
        • Retrieve video content
      • sora-2 generate video by chat
    • 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
    • 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
      • Generating images
      • Expanded
      • Text Generation Video
      • Image Generation Video
      • Multi-Image To Video
      • Multi-Image to Image
      • Video Extension
      • virtual try-on
      • lip sync
      • effects
      • Video to audio
      • Text to audio
      • Individual queries
    • bytedance
      • bytedance-video
      • bytedance-video get
    • MiniMax Conch(video)
      • MiniMax Conch Official Documentation
      • MiniMax Conch Generation
      • MiniMax Conch Query
      • MiniMax Conch Download
  • 🔊 Audio Models
    • Create speech
    • Create transcription
    • Create translation
  • 🧩 Integration Guides
    • LiteLLM
    • Dify
    • Make
    • n8n
    • Lobe-Chat
    • COZE
    • Zapier
    • Activepieces
    • LlamaIndex
    • Continue
    • FlowiseAI
    • Chatbox
    • CherryStudio
    • Cursor
    • 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/gemini-2.5-flash-image-preview: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

🍌 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

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-2.5-flash-image-preview:generateContent' \
--header 'Authorization: {{api-key}}' \
--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": [
          {
            "text": "![image](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAABAAAAAQACAIAAADwf7zUAAAAiXpUWHRSYXcgcHJvZmlsZSB0eXBlIGlwdGMAAAiZTYwxDgIxDAT7vOKekDjrtV1T0VHwgbtcIiEhgfh/QaDgmGlWW0w6X66n5fl6jNu9p+ULkapDENgzpj+Kl5aFfa6KnYWgSjZjGOiSYRxTY/v8KIijI/rXyc236kHdAK22RvHVummEN+91ML0BQ+siou79WmMAAAKHaVRYdFhNTDpjb20uYWRvYmUueG1wAAAAAAA8P3hwYWNrZXQgYmVnaW49Iu+7vyIgaWQ9Ilc1TTBNcENlaGlIenJlU3pOVGN6a2M5ZCI/PiA8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIiB4OnhtcHRrPSJYTVAgQ29yZSA1LjUuMCI+IDxyZGY6UkRGIHhtbG5zOnJkZj0iaHR0cDovL3d3dy53My5vcmcvMTk5OS8wMi8yMi1yZGYtc3ludGF4LW5zIyI+IDxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSIiIHhtbG5zOklwdGM0eG1wRXh0PSJodHRwOi8vaXB0Yy5vcmcvc3RkL0lwdGM0eG1wRXh0LzIwMDgtMDItMjkvIiB4bWxuczpwaG90b3Nob3A9Imh0dHA6Ly9ucy5hZG9iZS5jb20vcGhvdG9zaG9wLzEuMC8iIElwdGM0eG1wRXh0OkRpZ2l0YWxTb3VyY2VGaWxlVHlwZT0iaHR0cDovL2N2LmlwdGMub3JnL25ld3Njb2Rlcy9kaWdpdGFsc291cmNldHlwZS90cmFpbmVkQWxnb3JpdGhtaWNNZWRpYSIgSXB0YzR4bXBFeHQ6RGlnaXRhbFNvdXJjZVR5cGU9Imh0dHA6Ly9jdi5pcHRjLm9yZy9uZXdzY29kZXMvZGlnaXRhbHNvdXJjZXR5cGUvdHJhaW5lZEFsZ29yaXRobWljTWVkaWEiIHBob3Rvc2hvcDpDcmVkaXQ9Ik1hZGUgd2l0aCBHb29nbGUgQUkiLz4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gICA8P3hwYWNrZXQgZW5kPSJ3Ij8+fxJoawAAIABJREFUeJxkvVmzLMlxJva5e2TWOefeXtBYGkCDAAkQIIGhKFLGkUzSSI96kV6kF/3ckcm0jMZo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
Modified at 2025-10-26 05:40:49
Previous
Guide to calling gemini-2.5-flash-image (Nano Banana)
Next
Hunyuan3D
Built with