Crazyrouter API Document
🇺🇸 English
  • 中文
  • 🇺🇸 English
🇺🇸 English
  • 中文
  • 🇺🇸 English
🇺🇸 English
  • 中文
  • 🇺🇸 English
API 参考
快速开始接入教程官网模型与价格控制台
API 参考
快速开始接入教程官网模型与价格控制台
  1. Gemini Native Format
  • 默认模块
    • Crazyrouter Overview
      • Introduction
      • API request
      • API Quick Start Guide
      • API Endpoint
      • Contact us
    • Chat
      • ChatGPT
        • ChatGPT Audio
          • whisper-1
          • Create Translation (whisper-1, audio to English, untested)
        • ChatGPT Chat
          • Chat Completion Object
          • Chat Completion Chunk Object
          • Create Chat Completion (Streaming)
          • Create Chat Completion (Non-Streaming)
          • Create Chat Vision (Streaming)
          • Create Chat Vision (Streaming) base64
          • Create Chat Vision (Non-Streaming)
          • Create Chat Image Generation (Non-Streaming)
          • Function calling
          • Official N Test
          • Create Chat Function Call
          • Create Structured Output
          • Control Reasoning Model Effort Level
          • Create Chat Completion qwen-mt-turbo
          • Create Chat Completion DeepSeek V3.1 Thinking Level (Streaming)
          • DeepSeek OCR Recognition
        • ChatGPT Completions
          • Completion Object
        • ChatGPT Embeddings
          • Embedding Object
          • Create Embedding
        • Web Search
          • web search
        • ChatGPT Moderations
          • Content Moderation (Moderations)
      • Anthropic Claude
        • Chat Completion Object
        • Chat Completion Chunk Object
        • Count Input Tokens count_tokens [Native Format]
        • Create Chat Completion (Streaming) [Native Format]
        • Create Function Call (Streaming) [Native Format]
        • Create Thinking Chat [Native Format]
        • Create Thinking Chat
        • Create Chat Completion (Streaming)
        • Create Chat Completion (Non-Streaming)
        • Create Chat Vision (Streaming)
        • Create Chat Vision (Non-Streaming)
        • PDF Support [Native Format]
      • Google Gemini
        • Gemini Native Format
          • Create Context Cache cachedContents [Native Format]
            POST
          • Text Generation
            POST
          • Text Generation Streaming
            POST
          • Text Generation Thingking+streaming
            POST
          • Image Generation gemini-2.5-flash-image
            POST
          • Image Generation gemini-2.5-flash-image Control Aspect Ratio +imageSize
            POST
          • Image Understanding
            POST
          • Formatted Output
            POST
          • Function Call
            POST
          • Document Understanding
            POST
          • URL context
            POST
          • Code Execution
            POST
          • Video Understanding
            POST
          • URL context
            POST
          • Video Understanding-url Native Format
            POST
          • Audio Understanding
            POST
          • Text Generation gemini-3-pro-preview:generateContent
            POST
        • Chat-compatible Format
          • Gemini Image Generation API [Chat Compatible Format]
          • Chat API [Chat Compatible Format]
          • Chat API - Thinking 1 [Chat Compatible Format]
          • Chat API - Thinking 2 [Chat Compatible Format]
          • Vision API [Chat Compatible Format]
          • Chat + File Reading API [Chat Compatible Format]
    • Chat (Responses)
      • Responses API vs Chat API
      • Create Function Calling
      • Create Model Response (Streaming)
      • Create Model Response (Control Thinking Length)
      • web search
      • Create Model Response (GPT-5 Enable Thinking)
    • Image Generation Models
      • Image Object
      • Midjourney
        • Submit Video Task (Image-to-Video)
        • Submit Simple Change Task (String Form)
        • Get Task Image (Gateway-Hosted Copy)
        • Submit Edits Task (Inpainting)
        • Submit Shorten Task (Prompt Shortening)
        • Submit Change Task (U/V/R Actions)
        • InsightFace Face Swap
        • upload image
        • upload Imagine task
        • Query Task Status by Task ID
        • Query Tasks by ID List
        • Get Task Image Seed
        • Execute Action
        • Submit Blend Task
        • Sumit Describe task
        • Sumit Modal
      • GPT Image (gpt-image-2)
        • Create gpt-image-1
        • Create Image (gpt-image-2, OpenAI images/generations format)
        • Edit Image (gpt-image-2, mask / multi-image reference)
      • Jimeng Image
        • Create Image
        • Edit Image
      • Doubao Seedream
        • doubao-seedream-3-0-t2i-250415
        • 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
        • doubao-seedream-4-5-251128 Text-to-Image (text-only input, single image output)
        • doubao-seedream-4-5-251128 Text+Image to Image (single image in, single image out)
        • doubao-seedream-4-5-251128 Multi-Image Fusion (multiple inputs, single output)
        • doubao-seedream-4-5-251128 Image Set Output (multi-image output)
        • doubao-seedream-4-5-251128 Single Image to Image Set
        • doubao-seedream-4-5-251128 Multi-Reference to Image Set
      • Qwen-Image
        • qwen-image-edit-2509
    • Video Models
      • Veo
        • Unified Video Format
          • Unified Video API Task Status
          • Create Video with Image
          • Create Video (Reference Image)
        • OpenAI Video Format
      • Kling
        • Callback Protocol
        • Omni Video omni-video (kling-v3-omni / kling-video-o1)
        • Image Generation
        • Text-to-Video
        • Image to Video
        • Query Task (free)
        • Multi-Image Reference to Video
        • Lip Sync
        • Extend Video
        • Video Effects
      • Jimeng Video
        • Jimeng Task Status
        • Submit Video Generation Task
        • Query Video Task (free)
      • Hailuo (MiniMax)
        • Hailuo Task Status
        • Submit Video Generation Task
        • Query Video Task Status
        • Image-to-Video
      • Doubao Seedance
        • Text-to-Video Example
        • Image to Video - First Frame
        • seedance-lite First/Last Frame
        • Image-to-Video (base64 encoded)
        • Query Single Task
      • Sora
        • OpenAI Video Format
          • OpenAI Query Task
          • OpenAI Download Video
          • OpenAI Create Video (with image)
          • Create Video from Storyboard
          • OpenAI Create Video with Image (Private Mode)
          • OpenAI Create Video (with Character)
      • Tongyi Wanxiang
        • Generate Video
        • Query Video
      • Unified Video API (all video models)
        • Query Video Task (Unified Format)
        • Submit Video Generation Task (Unified Format)
    • System API
      • List Tokens
      • Create Token
      • Get Models Supported by Token
      • Get Account Info
      • Update Token
      • Delete Token
      • Search Tokens
      • Query Async Task (Image / Video)
      • Get Single Model Info
    • Suno Music
      • Suno Parameters
      • Suno Overview
      • Submit Tasks
        • Generate Song (Inspiration Mode)
        • Generate Song (Custom Mode)
        • Generate Song (Extend Mode)
        • Generate Song (Artist Style)
        • Generate Song (Upload Song for Re-creation)
        • Generate Lyrics
        • Concatenate Songs
      • Query Tasks
        • Batch Get Tasks
        • Query Single Task
        • Get WAV
    • Python
      • Python Speech-to-Text (whisper-1)
      • Python Embeddings
      • Python Function Calling Demo
      • Python LangChain Demo
      • Python llama_index Configuration
      • Python Basic Chat
      • Python Local Image Recognition (Multimodal)
      • Python Remote Image Recognition (Multimodal)
      • Python Image Recognition with Claude
      • Python Library Streaming Output
      • Python requests streaming output demo
      • Python image generation and editing (gpt-image-2)
      • Python official OpenAI library (AutoGPT / LangChain, etc.)
      • Python multi-turn conversation
    • Rerank
      • Rerank
    • PHP
      • PHP Image Editing Demo
    • Node.js
      • Node.js Audio Transcription Demo
    • Plugins & Client Setup Guides
      • Codex
      • N8N
      • Gemini CLI
      • Claude Code Installation and Usage Guide
      • CherryStudio Configuration Guide
      • dify Configuration Guide
      • cline
      • aider
      • Cursor
      • lobechat
      • ChatBox
      • gpt_academic
      • nextchat
      • zotero gpt
      • CLAUDE DEV
      • ChatGPT Sidebar
      • chatgpt-on-wechat
      • chatgpt GPT Academic
      • RikkaHub
      • Coze Workflow Configuration Guide
    • Help Center
      • Thinking Model Response Format
      • HTTP Status Codes and Their Meanings
      • Image Upload API
    • Decisions API (TypeSafe JEV)
      • Create Decisions
    • 3D Generation (Hunyuan hy-3d)
      • Query 3D Generation Task
      • Submit 3D Generation Task
    • File Upload
      • Temporary Images
        • Temporary Base64 Image Upload
        • Get Presigned Direct Upload URL (recommended for large files)
        • Re-host Remote Image as Temporary URL
        • Temporary Local Image Upload
      • Playground
        • Playground Image Upload
      • Deprecated
        • Legacy Upload Endpoint (Unsupported)
  • Unified Video API
    • Unified Video
  1. Gemini Native Format

Image Understanding

默认 API 入口 api.crazyrouter.com
https://api.crazyrouter.com
默认 API 入口 api.crazyrouter.com
https://api.crazyrouter.com
POST
/v1beta/models/gemini-2.5-pro:generateContent
Official docs: https://ai.google.dev/gemini-api/docs/image-understanding?hl=zh-cn

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Query Params

Header Params

Body Params application/json

Examples

Responses

🟢200成功
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff 'https://api.crazyrouter.com/v1beta/models/gemini-2.5-pro:generateContent?key={{YOUR_API_KEY}}' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "inline_data": {
            "mime_type": "image/png",
            "data": "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
Response Response Example
{}
Modified at 2026-09-28 14:53:31
Previous
Image Generation gemini-2.5-flash-image Control Aspect Ratio +imageSize
Next
Formatted Output
Built with