English
  • English
  • 中文简体
English
  • English
  • 中文简体
English
  • English
  • 中文简体
  1. Official API
  • Model interface
    • Aiide Platform
    • Law and Policy
      • Service Agreement
      • Privacy Policy
    • List of model interfaces
      • Get Models
        • Get Available Models
      • Anthropic (Claude Code)
        • Official API
          • Text Chat (Preferred)
        • OpenAI-Compatible API
          • Text Chat
      • OpenAI (Codex, GPT-Image-2)
        • Official API
          • Text Chat (Officially Recommended / Next Generation)
          • Text Chat (Compatible API)
          • Generate Image (GPT-Image-2)
          • Edit Image (GPT-Image-2)
          • Create Video
          • Get Video Task Status
          • Get Video Content
      • Google (Gemini, Nano Banana)
        • Official API
          • Text Chat (Preferred)
            POST
          • Generate Image (Nano Banana)
            POST
        • OpenAI-Compatible API
          • Text Chat
          • Generate Image (Nano Banana)
      • xAI (Grok-Image)
        • OpenAI-Compatible API
          • Generate Image (Grok)
      • Images
        • OpenAI-Compatible API
          • Generate Image
        • Qwen-Compatible Format
          • Generate Image
          • Edit Image
      • Videos
        • Qwen Format (Happyhorse)
          • Create Video (Text-to-Video)
          • Create Video (First-Frame Image-to-Video)
          • Create Video (Reference-Image-to-Video)
          • Create Video (Video Editing)
          • Get Video Generation Task Status
        • Volcengine Doubao Format (Seed-2.0)
          • Create Video (Multimodal Reference-to-Video)
          • Get Video Generation Task Status
        • OpenAI Format (Google Veo 3.1, Seed-2.0)
          • Google Veo 3.1
            • Create Video (Text-to-Video)
            • Create Video (Reference-Image-to-Video)
            • Get Video Generation Task Status
          • OpenAI Sora Format (Seed-2.0 Special Price)
            • Create Video (Text-to-Video)
            • Create Video (Multimodal Reference-to-Video)
            • Get Video Generation Task Status
            • Get Video Content
    • Video Asset APIs
      • Asset Library API Integration Guide
      • Asset Library API Integration Guide (Volcengine Official Format)
      • Upload Asset
      • List Assets
      • Get Asset
      • Update Asset Description
      • Delete Asset
    • Tool Configuration Tutorial
      • CC Switch 配置
      • Claude Code配置
      • Codex配置
      • Gemini CLI配置
      • OpenCode 配置
      • Cursor 配置
      • node 安装教程
  1. Official API

Text Chat (Preferred)

POST
/v1beta/models/{model}:generateContent
Google Gemini API request.
Path format: /v1beta/models/{model_name}:{action}
Optional model IDs, e.g.:
gemini-2.5-flash
gemini-2.5-pro
gemini-3-flash-preview
gemini-3.1-pro-preview, etc.

Request

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

Body Params application/jsonRequired

Example
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "hello"
        }
      ]
    }
  ],
  "generationConfig": {
    "maxOutputTokens": 100
  }
}

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 'https://www.aiide.com/v1beta/models/gemini-2.5-flash:generateContent' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "hello"
        }
      ]
    }
  ],
  "generationConfig": {
    "maxOutputTokens": 100
  }
}'

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{
    "candidates": [
        {
            "content": {
                "parts": [
                    {
                        "text": "string"
                    }
                ],
                "role": "string"
            },
            "finishReason": "string"
        }
    ],
    "createTime": "string",
    "modelVersion": "string",
    "responseId": "string",
    "usageMetadata": {
        "candidatesTokenCount": 0,
        "candidatesTokensDetails": [
            {
                "modality": "string",
                "tokenCount": 0
            }
        ],
        "promptTokenCount": 0,
        "promptTokensDetails": [
            {
                "modality": "string",
                "tokenCount": 0
            }
        ],
        "thoughtsTokenCount": 0,
        "totalTokenCount": 0,
        "trafficType": "string"
    }
}
🟠429Rate Limit
🟠400Bad Request
Modified at 2026-09-10 05:58:19
Previous
Get Video Content
Next
Generate Image (Nano Banana)
Built with