跳转到主要内容
POST
/
v1beta
/
models
/
gemini-2.5-pro:
{method}
curl --request POST \
  --url https://api.evolink.ai/v1beta/models/gemini-2.5-pro:{method} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "请介绍下你自己"
        }
      ]
    }
  ]
}'
{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "你好！很高兴能向你介绍我自己。\n\n我是一个大型语言模型，由 Google 训练和开发..."
          }
        ]
      },
      "finishReason": "STOP",
      "index": 0,
      "safetyRatings": [
        {}
      ]
    }
  ],
  "promptFeedback": {
    "safetyRatings": [
      {}
    ]
  },
  "usageMetadata": {
    "promptTokenCount": 4,
    "candidatesTokenCount": 611,
    "totalTokenCount": 2422,
    "thoughtsTokenCount": 1807,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 4
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

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

获取 API Key :

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

使用时在请求头中添加:

Authorization: Bearer YOUR_API_KEY

Headers

​
X-Async-Mode
boolean
default:false

启用异步处理模式。设置为 true 时，请求将异步处理并立即返回任务ID，而不是等待完整响应。

说明:

  • 异步模式优先级最高，即使设置了流式方法，也会返回任务ID
  • 返回任务ID后，可通过任务查询接口获取生成结果，此结果的响应格式必然是非流式的

Path Parameters

​
method
enum<string>
required

生成方法：

  • generateContent: 等待完整响应后一次性返回
  • streamGenerateContent: 流式生成，逐块实时返回内容
可用选项:
generateContent,
streamGenerateContent

Body

application/json
​
contents
object[]
required

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

Minimum length: 1
​
generationConfig
object

生成配置参数（可选）

Response

内容生成成功

响应格式说明：

  • 当 X-Async-Mode=true 时，返回 AsyncTaskResponse（异步任务响应，立即返回任务ID）
  • 当 method=generateContent 且无异步模式时，返回 GenerateContentResponse（等待完整响应后一次性返回）
  • 当 method=streamGenerateContent 且无异步模式时，返回 StreamGenerateContentResponse（流式响应，逐块返回内容）
  • 同步响应
  • 流式响应
  • 异步响应
​
candidates
object[]

候选响应列表

​
promptFeedback
object
​
usageMetadata
object

使用量统计