curl --request POST \
  --url https://direct.evolink.ai/v1beta/models/gemini-3.1-pro-preview:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "请介绍下你自己"
        }
      ]
    }
  ]
}
'

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "你好！很高兴能向你介绍我自己。\n\n我是一个大型语言模型，由 Google 训练和开发...",
            "thought": true,
            "thoughtSignature": "<Signature_A>"
          }
        ]
      },
      "finishReason": "STOP",
      "index": 0,
      "safetyRatings": [
        {}
      ]
    }
  ],
  "promptFeedback": {
    "safetyRatings": [
      {}
    ]
  },
  "usageMetadata": {
    "promptTokenCount": 4,
    "cachedContentTokenCount": 0,
    "candidatesTokenCount": 611,
    "totalTokenCount": 2422,
    "thoughtsTokenCount": 1807,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 4
      }
    ]
  },
  "modelVersion": "gemini-3.1-pro-preview",
  "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 原生 API 格式

Gemini 3.1 Pro - Native API - 完整参数文档

使用 Google 原生 API 格式调用 Gemini-3.1-pro 模型
可使用同步处理模式，实时返回对话内容
纯文本对话：单轮或多轮上下文对话，可参考示例代码中 simple_text、multi_turn 示例
多模态输入：支持文本 + 图像/音频/视频混合输入，可参考示例代码中 audio_analysis、image_understanding、multi_file 示例
参数调优：通过 generationConfig 控制生成效果
流式：将 URL 中 generateContent 替换为 streamGenerateContent 即可

POST

v1beta

models

gemini-3.1-pro-preview:generateContent

curl --request POST \
  --url https://direct.evolink.ai/v1beta/models/gemini-3.1-pro-preview:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "请介绍下你自己"
        }
      ]
    }
  ]
}
'

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "你好！很高兴能向你介绍我自己。\n\n我是一个大型语言模型，由 Google 训练和开发...",
            "thought": true,
            "thoughtSignature": "<Signature_A>"
          }
        ]
      },
      "finishReason": "STOP",
      "index": 0,
      "safetyRatings": [
        {}
      ]
    }
  ],
  "promptFeedback": {
    "safetyRatings": [
      {}
    ]
  },
  "usageMetadata": {
    "promptTokenCount": 4,
    "cachedContentTokenCount": 0,
    "candidatesTokenCount": 611,
    "totalTokenCount": 2422,
    "thoughtsTokenCount": 1807,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 4
      }
    ]
  },
  "modelVersion": "gemini-3.1-pro-preview",
  "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"
  }
}

流式调用：将 URL 中的 generateContent 替换为 streamGenerateContent，请求体参数完全相同，响应将以流式逐块返回。响应格式参见下方「流式响应」说明。

BaseURL 说明：默认 BaseURL 为 https://direct.evolink.ai，对文本模型支持更好，支持长连接；https://api.evolink.ai 是多模态主力地址，对文本模型作为备用地址使用。

授权

Authorization

string

header

必填

##所有接口均需要使用Bearer Token进行认证##

获取 API Key：

访问 API Key 管理页面获取您的 API Key

使用时在请求头中添加：

Authorization: Bearer YOUR_API_KEY

请求体

application/json

contents

object[]

必填

对话内容列表，支持多轮对话和多模态输入

Minimum array length: 1

Show child attributes

systemInstruction

object

系统指令（可选），当前以文本为主

Show child attributes

tools

object[]

模型可调用的工具列表，如函数调用或代码执行

toolConfig

object

工具调用配置（可选）

safetySettings

object[]

安全设置列表（可选）

generationConfig

object

生成配置参数（可选）

Show child attributes

cachedContent

string

缓存内容名称，格式为 cachedContents/{cachedContent}

响应

内容生成成功

响应格式说明：

使用 generateContent 端点时，返回 GenerateContentResponse（等待完整响应后一次性返回）
使用 streamGenerateContent 端点时，返回 StreamGenerateContentResponse（流式响应，逐块返回内容）

同步响应
流式响应

candidates

object[]

候选响应列表

Show child attributes

promptFeedback

object

Show child attributes

usageMetadata

object

使用量统计

Show child attributes

modelVersion

string

模型版本

示例:

"gemini-3.1-pro-preview"

responseId

string

响应 ID

示例:

"l-LoaPu0BPmo1dkP6ZPHiQc"

Gemini 3.1 Pro - Native API - 快速开始 Gemini 3.1 Pro Customtools - OpenAI SDK - 快速开始

图像系列

视频系列

音频系列

语言系列

账户管理

任务管理

文件管理

Gemini 3.1 Pro - Native API - 完整参数文档

授权

请求体

响应