curl --request POST \
  --url https://direct.evolink.ai/v1beta/models/{model}:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Please introduce yourself"
        }
      ]
    }
  ]
}
'

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "Hello! I'm pleased to introduce myself.\n\nI'm a large language model, trained and developed by Google...",
            "thought": true,
            "thoughtSignature": "<Signature_A>"
          }
        ]
      },
      "finishReason": "STOP",
      "index": 0,
      "safetyRatings": [
        {}
      ]
    }
  ],
  "promptFeedback": {
    "safetyRatings": [
      {}
    ]
  },
  "usageMetadata": {
    "promptTokenCount": 4,
    "candidatesTokenCount": 611,
    "totalTokenCount": 2422,
    "thoughtsTokenCount": 1807,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 4
      }
    ],
    "cachedContentTokenCount": 0
  },
  "modelVersion": "gemini-3.6-flash",
  "responseId": "l-LoaPu0BPmo1dkP6ZPHiQc"
}

{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Insufficient quota",
    "type": "insufficient_quota_error",
    "fallback_suggestion": "https://evolink.ai/dashboard/billing"
  }
}

{
  "error": {
    "code": 403,
    "message": "Access denied for this model",
    "type": "permission_error"
  }
}

{
  "error": {
    "code": 404,
    "message": "Model not found",
    "type": "not_found_error"
  }
}

{
  "error": {
    "code": 413,
    "message": "Request body too large",
    "type": "request_too_large_error",
    "fallback_suggestion": "reduce file size"
  }
}

{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded",
    "type": "rate_limit_error",
    "fallback_suggestion": "retry after 60 seconds"
  }
}

{
  "error": {
    "code": 500,
    "message": "Internal server error",
    "type": "internal_server_error",
    "fallback_suggestion": "try again later"
  }
}

{
  "error": {
    "code": 502,
    "message": "Upstream AI service unavailable",
    "type": "upstream_error",
    "fallback_suggestion": "try again later"
  }
}

{
  "error": {
    "code": 503,
    "message": "Service temporarily unavailable",
    "type": "service_unavailable_error",
    "fallback_suggestion": "retry after 30 seconds"
  }
}

Google Native API Format

Gemini All-Model API - Native API Format

Select the Gemini text model to call via {model} in the path (see the reference table for the model parameter for all available values).

Uses the Google native API format and returns conversation content synchronously
Plain text / multimodal input: mixed text + image / audio / video input
Streaming: replace generateContent in the path with streamGenerateContent (append ?alt=sse to receive SSE)

Model specs and differences

Sampling parameters temperature / topP / topK: consistent across the entire Gemini 3.x series, custom values do not affect the output; topK is dropped outright by the gateway (not forwarded upstream), and a temperature / topP value outside the valid range returns a 400.
Thinking control: the Gemini 3.x series uses thinkingConfig.thinkingLevel (see the thinkingLevel parameter for the levels supported and the default of each model); the Gemini 2.5 series uses thinkingConfig.thinkingBudget (an integer, 0=off). The two are mutually exclusive.
Function calling: for Gemini 3.x, the FunctionResponse must echo back the id and name matching the corresponding FunctionCall, otherwise the request errors.
Last-turn role: the role of the last message must not be model (Gemini 3.5+ will error).
Token limits: gemini-3.6-flash / gemini-3.5-flash-lite have a context window of 1,048,576 and a maximum output of 65,536; other models follow their respective specs.

POST

v1beta

models

{model}

:generateContent

curl --request POST \
  --url https://direct.evolink.ai/v1beta/models/{model}:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Please introduce yourself"
        }
      ]
    }
  ]
}
'

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "Hello! I'm pleased to introduce myself.\n\nI'm a large language model, trained and developed by Google...",
            "thought": true,
            "thoughtSignature": "<Signature_A>"
          }
        ]
      },
      "finishReason": "STOP",
      "index": 0,
      "safetyRatings": [
        {}
      ]
    }
  ],
  "promptFeedback": {
    "safetyRatings": [
      {}
    ]
  },
  "usageMetadata": {
    "promptTokenCount": 4,
    "candidatesTokenCount": 611,
    "totalTokenCount": 2422,
    "thoughtsTokenCount": 1807,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 4
      }
    ],
    "cachedContentTokenCount": 0
  },
  "modelVersion": "gemini-3.6-flash",
  "responseId": "l-LoaPu0BPmo1dkP6ZPHiQc"
}

{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Insufficient quota",
    "type": "insufficient_quota_error",
    "fallback_suggestion": "https://evolink.ai/dashboard/billing"
  }
}

{
  "error": {
    "code": 403,
    "message": "Access denied for this model",
    "type": "permission_error"
  }
}

{
  "error": {
    "code": 404,
    "message": "Model not found",
    "type": "not_found_error"
  }
}

{
  "error": {
    "code": 413,
    "message": "Request body too large",
    "type": "request_too_large_error",
    "fallback_suggestion": "reduce file size"
  }
}

{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded",
    "type": "rate_limit_error",
    "fallback_suggestion": "retry after 60 seconds"
  }
}

{
  "error": {
    "code": 500,
    "message": "Internal server error",
    "type": "internal_server_error",
    "fallback_suggestion": "try again later"
  }
}

{
  "error": {
    "code": 502,
    "message": "Upstream AI service unavailable",
    "type": "upstream_error",
    "fallback_suggestion": "try again later"
  }
}

{
  "error": {
    "code": 503,
    "message": "Service temporarily unavailable",
    "type": "service_unavailable_error",
    "fallback_suggestion": "retry after 30 seconds"
  }
}

Streaming: Replace generateContent with streamGenerateContent in the URL. The request body parameters are identical. Responses will be returned in streaming chunks. See the “Streaming Response” section below for the response format.

BaseURL: The default BaseURL is https://direct.evolink.ai, which has better support for text models and long-lived connections. https://api.evolink.ai is the primary endpoint for multimodal services and serves as a fallback address for text models.

Authorizations

Authorization

string

header

required

##All APIs require Bearer Token authentication##

Get API Key:

Visit API Key Management Page to get your API Key

Add to request header:

Authorization: Bearer YOUR_API_KEY

Path Parameters

model

enum<string>

required

Select the Gemini text model to call:

Model ID	Series	Positioning
`gemini-3.6-flash`	3.6 Flash	Multi-step orchestration / code refactoring / general reasoning
`gemini-3.5-flash`	3.5 Flash	General-purpose Flash
`gemini-3.5-flash-lite`	3.5 Flash-Lite	Low cost / high throughput / lightweight agent
`gemini-3.1-pro-preview`	3.1 Pro (Preview)	Advanced reasoning
`gemini-3.1-pro-preview-customtools`	3.1 Pro · CustomTools	Advanced reasoning + custom tools
`gemini-3.1-flash-lite-preview`	3.1 Flash-Lite (Preview)	Low cost
`gemini-3-pro-preview`	3.0 Pro (Preview)	Advanced reasoning
`gemini-3-flash-preview`	3.0 Flash (Preview)	General-purpose Flash
`gemini-2.5-pro`	2.5 Pro	Advanced reasoning
`gemini-2.5-flash`	2.5 Flash	General-purpose Flash
`gemini-2.5-flash-lite`	2.5 Flash-Lite	Low cost

Available options:

gemini-3.6-flash,

gemini-3.5-flash,

gemini-3.5-flash-lite,

gemini-3.1-pro-preview,

gemini-3.1-pro-preview-customtools,

gemini-3.1-flash-lite-preview,

gemini-3-pro-preview,

gemini-3-flash-preview,

gemini-2.5-pro,

gemini-2.5-flash,

gemini-2.5-flash-lite

Example:

"gemini-3.6-flash"

Body

application/json

contents

object[]

required

List of conversation contents, supports multi-turn dialogue and multimodal input

Minimum array length: 1

Show child attributes

generationConfig

object

Generation configuration parameters (optional)

Show child attributes

systemInstruction

object

System instruction (optional), mainly text content

Show child attributes

tools

object[]

List of tools the model can call, such as function calling or code execution

toolConfig

object

Tool calling configuration (optional)

safetySettings

object[]

Safety settings list (optional)

cachedContent

string

Cached content name, in the form cachedContents/{cachedContent}

Response

Content generated successfully

Response format description:

When using the generateContent endpoint, returns GenerateContentResponse (returns complete response at once)
When using the streamGenerateContent endpoint, returns StreamGenerateContentResponse (streaming response, returns content in chunks)

Sync Response
Stream Response

candidates

object[]

List of candidate responses

Show child attributes

promptFeedback

object

Show child attributes

usageMetadata

object

Usage statistics

Show child attributes

modelVersion

string

Model version

Example:

"gemini-3.6-flash"

responseId

string

Response ID

Example:

"l-LoaPu0BPmo1dkP6ZPHiQc"

Gemini All-Model API - Native API Quickstart Gemini All-Model API - OpenAI Quickstart

Image Series

Video Series

Audio Series

Text Series

Account Management

Task Management

File Management

Gemini All-Model API - Native API Format

Authorizations

Path Parameters

Body

Response