跳转到主要内容
POST
/
v1beta
/
models
/
gemini-3.1-pro-preview-customtools:generateContent
curl --request POST \ --url https://direct.evolink.ai/v1beta/models/gemini-3.1-pro-preview-customtools: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-customtools",
  "responseId": "l-LoaPu0BPmo1dkP6ZPHiQc"
}

Documentation Index

Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt

Use this file to discover all available pages before exploring further.

流式调用:将 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
systemInstruction
object

系统指令(可选),当前以文本为主

tools
object[]

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

toolConfig
object

工具调用配置(可选)

safetySettings
object[]

安全设置列表(可选)

generationConfig
object

生成配置参数(可选)

cachedContent
string

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

响应

内容生成成功

响应格式说明

  • 使用 generateContent 端点时,返回 GenerateContentResponse(等待完整响应后一次性返回)
  • 使用 streamGenerateContent 端点时,返回 StreamGenerateContentResponse(流式响应,逐块返回内容)
candidates
object[]

候选响应列表

promptFeedback
object
usageMetadata
object

使用量统计

modelVersion
string

模型版本

示例:

"gemini-3.1-pro-preview-customtools"

responseId
string

响应 ID

示例:

"l-LoaPu0BPmo1dkP6ZPHiQc"