1. Image-to-Image URL Request (Not Currently Supported)
beeswitch docs
  • Plugin Configuration
    • API Relay Setup
    • Claude Code for VS Code Tutorial
    • Claude Code Installation and Usage Guide
    • Gemini CLI Configuration and Usage Guide
    • Codex CLI Configuration Guide
    • OpenCode Integration Configuration Guide
    • N8N Workflow Relay API Usage Guide
  • List Models
    • Models (list models)
      GET
  • OpenAI Format (Supports Major Official Provider Models)
    • Chat (Responses)
      • Create Web Search
      • Create Model Response (GPT-5 Reasoning Enabled)
      • Create Function Call
      • Create Model Response
      • Create Function Call
      • Create Model Response (Streaming)
      • Create Model Response (Control Reasoning Length)
    • ChatGPT APIs
      • ChatGPT Audio
        • Create Video
        • Speech-to-Text gpt-4o-transcribe
        • Create translation (not supported)
        • Speech-to-Text whisper-1
        • Speech-to-Text gpt-4o-transcribe
        • Create speech gpt-4o-mini-tts
        • Create translation (not supported)
      • ChatGPT Chat
        • List Models
        • Create Video with Image
        • Continuously modify and generate videos
        • Create chat picture recognition (streaming) best64
        • Official N test
        • Create Structured Output
        • Control Reasoning Effort
        • Create Chat Function Call
        • deepseek-ocr recognition
        • Create Chat Completion (Non-streaming)
      • ChatGPT Completions
        • Create Completion
    • Images
      • Modify pictures (images)
      • Create Chat Completion (Streaming)
      • Create chat completion qwen-mt-turbo
      • Create chat completion deepseek v3.1 thinking level (streaming)
    • Audio
      • Speech recognition(audio)
      • Speech synthesis (audio)
      • Official Function Calling
      • Create a chat creation graph (non-streaming)
    • Embeddings
      • Text Embeddings
  • Anthropic Format
    • Chat
      POST
    • Chat (prompt cache)
      POST
    • Streaming Response
      POST
    • Chat (Deep Reasoning)
      POST
    • Tool Calling (Function Call)
      POST
    • Tool Calling (MCP) - Pending Support
      POST
    • Analyze Image
      POST
  • 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)
      • 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
    • Image-to-Image URL Request / OpenAI-style URL Request
      • Single Image-to-Image with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
      • Multi-Image Fusion Generation with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
      • Image Editing
      • Image Understanding
    • Image-to-Image URL Request (Not Currently Supported)
      • Multi-Image Fusion with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
        POST
      • Image Editing
        POST
      • Image Understanding
        POST
    • Image-to-Image URL Request, Gemini Format (Not Currently Supported)
      • Multi-Image Fusion Generation with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
      • Image Generation with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
      • Image Editing
      • Image Understanding
  • 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
      • Generate Image
      • Edit Image
    • OpenAI Request Format
      • Edit Image
      • OpenAI Image Format
  • Midjourney Format
    • Task Query API
    • Upload Image
    • Get Seed
    • Submit Imagine Task
    • Query Tasks by ID List
    • Face Swap
    • Execute Action
    • Submit Blend Task
    • Submit Describe Task
    • Submit Modal
    • Refresh URL
    • Edit Image
    • Query Task Status by Task ID
    • Get Seed for Task Image
  • Doubao Video Generation
    • Text-to-Video Example
    • Image-to-Video - First Frame
    • seedance-lite - First and Last Frames
    • Image-to-Video - Base64 Encoding
    • seedance-lite - Reference Image
    • Query Single Task
    • Query video generation task list-default
    • Query video generation task list - search multiple task IDs
  • Doubao Image Generation
    • doubao-seededit-3-0-i2i-250628
    • doubao-seedream-4-0-250828 - Text-to-Image
    • doubao-seedream-4-0-250828 - Image-to-Image
    • doubao-seedream-4-0-250828 - Multi-Image-to-Image
  • Jimeng AI
    • Jimeng AI - Image Generation
      • seedream-4.5
      • seedream-4.5 - Text-to-Image
      • seedream-4.5 - Image-to-Image
      • seedream-4.5 - Multi-Image-to-Image
    • Jimeng AI - Video Generation
      • Unified Task Submission API
      • Unified Query API
  • Rerank Models
    • Rerank
  • Text-to-Music (Suno)
    • Task Submission
      • Generate Song (Inspiration Mode)
      • Generate Song (Custom Mode)
      • Generate Song (Continuation Mode)
      • Generate Song (Singer Style)
      • Generate Song (Remix Uploaded Song)
      • Generate Song (Song Concatenation)
      • Generate Lyrics
      • Song Concatenation
    • Query APIs
      • Fetch Tasks in Batch
      • Query Single Task
  • Veo Video Generation
    • Latest Veo Video Generation (Recommended First)
      • Upload Image (Valid for One Day)
      • Create Video Generation Task - Text Only
      • Create Video Generation Task with Reference Image
      • Query Task Status
    • OpenAI Video Format (Recommended)
      • OpenAI Create Video with Image
      • OpenAI Query Task
      • OpenAI Download Video
    • Unified Video Format (Pending Unification)
      • Create Video
      • Create Video with Image
      • Query Task
      • Create Video (Reference Image)
  • Sora Video Generation
    • Official OpenAI Video Format (Recommended)
      • sora-2/sora-2-pro
        • OpenAI Query Task
        • OpenAI Download Video
        • OpenAI Create Video with Image
        • OpenAI Create Video (with Character)
        • OpenAI Edit Video
    • Chat Format
  • Kling (Kuaishou)
    • Text-to-Video
    • Image-to-Video
    • Query tasks (free)
  • Wan (Qwen)
    • Create Video with Image (Wan)
    • Query Video (Wan)
  • MinMax Video Generation
    • Text-to-Video Generation Task (MinMax)
    • Image-to-Video Task (MinMax)
    • Query Video Generation Task Status (MinMax)
    • Video Download (MinMax)
  • Vidu Video Generation
    • Vidu Generate Video
    • Vidu Query
  1. Image-to-Image URL Request (Not Currently Supported)

Image Editing

POST
/v1beta/models/gemini-2.0-flash-exp-image-generation:generateContent
Official documentation: https://ai.google.dev/gemini-api/docs/image-generation?hl=zh-cn#gemini-image-editing

Request

Query Params

Header Params

Body Params application/json

Example
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "'Hi, This is a picture of me. Can you add a llama next to me"
        },
        {
          "imageUrl": "https://image.baidu.com/front/aigc?atn=aigc&fr=home_hover&imgcontent=%7B%22aigcQuery%22%3A%22%22%2C%22imageAigcId%22%3A%22%22%7D&isImmersive=1&pd=image_content&quality=1&ratio=9%3A16&sa=searchpromo_shijian_photohp_inspire&tn=aigc&top=%7B%22sfhs%22%3A1%7D&word=%E5%B9%BF%E5%91%8A%E5%AE%A3%E4%BC%A0%E5%9B%BE%EF%BC%8C%E5%AE%A4%E5%86%85%E9%AB%98%E6%B8%85%EF%BC%8C%E5%B9%BF%E5%91%8A%EF%BC%8C%E6%B5%B7%E6%8A%A5%E8%B4%A8%E6%84%9F%EF%BC%8C%E9%AB%98%E6%B8%85%E6%91%84%E5%BD%B1%EF%BC%8C%E5%86%B0%E5%87%89%E7%9A%84%E6%B1%BD%E6%B0%B4%EF%BC%8C%E6%B0%B4%E6%9E%9C%E6%B1%BD%E6%B0%B4%EF%BC%8C%E6%B8%85%E6%96%B0%E7%9A%84%E8%87%AA%E7%84%B6%E7%8E%AF%E5%A2%83%EF%BC%8C%E8%B6%85%E9%AB%98%E6%B8%85%E5%88%86%E8%BE%A8%E7%8E%87%EF%BC%8C%E9%B2%9C%E8%89%B3%E8%89%B2%E5%BD%A9%EF%BC%8C%E6%B4%BB%E5%8A%9B%E5%9B%9B%E6%BA%A2%EF%BC%8C%E8%87%AA%E7%84%B6%E9%98%B3%E5%85%89%E7%85%A7%E5%B0%84%EF%BC%8C%E5%85%89%E6%BB%91%E5%86%B0%E5%87%8"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ]
  }
}

Request 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-2.0-flash-exp-image-generation:generateContent?key={{YOUR_API_KEY}}' \
--header 'Authorization: Bearer  {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "'\''Hi, This is a picture of me. Can you add a llama next to me"
        },
        {
          "imageUrl": "https://image.baidu.com/front/aigc?atn=aigc&fr=home_hover&imgcontent=%7B%22aigcQuery%22%3A%22%22%2C%22imageAigcId%22%3A%22%22%7D&isImmersive=1&pd=image_content&quality=1&ratio=9%3A16&sa=searchpromo_shijian_photohp_inspire&tn=aigc&top=%7B%22sfhs%22%3A1%7D&word=%E5%B9%BF%E5%91%8A%E5%AE%A3%E4%BC%A0%E5%9B%BE%EF%BC%8C%E5%AE%A4%E5%86%85%E9%AB%98%E6%B8%85%EF%BC%8C%E5%B9%BF%E5%91%8A%EF%BC%8C%E6%B5%B7%E6%8A%A5%E8%B4%A8%E6%84%9F%EF%BC%8C%E9%AB%98%E6%B8%85%E6%91%84%E5%BD%B1%EF%BC%8C%E5%86%B0%E5%87%89%E7%9A%84%E6%B1%BD%E6%B0%B4%EF%BC%8C%E6%B0%B4%E6%9E%9C%E6%B1%BD%E6%B0%B4%EF%BC%8C%E6%B8%85%E6%96%B0%E7%9A%84%E8%87%AA%E7%84%B6%E7%8E%AF%E5%A2%83%EF%BC%8C%E8%B6%85%E9%AB%98%E6%B8%85%E5%88%86%E8%BE%A8%E7%8E%87%EF%BC%8C%E9%B2%9C%E8%89%B3%E8%89%B2%E5%BD%A9%EF%BC%8C%E6%B4%BB%E5%8A%9B%E5%9B%9B%E6%BA%A2%EF%BC%8C%E8%87%AA%E7%84%B6%E9%98%B3%E5%85%89%E7%85%A7%E5%B0%84%EF%BC%8C%E5%85%89%E6%BB%91%E5%86%B0%E5%87%8"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ]
  }
}'

Responses

🟢200OK
application/json
Bodyapplication/json

Example
{}
Modified at 2026-07-09 10:12:26
Previous
Multi-Image Fusion with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
Next
Image Understanding
Built with