gemini-4-argon

Gemini 4 Argon 通过一个 generateContent 端点提供文本推理、多模态理解、结构化输出、函数调用和内置工具能力。选择对应能力查看请求和响应结构。

文本与思考
多模态理解
结构化输出
函数调用
内置工具

生成内容

POST /v1beta/models/gemini-4-argon:generateContent

cURL

curl --request POST \
  --url 'https://www.anyfast.ai/v1beta/models/gemini-4-argon:generateContent?key=YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "contents": [{
      "role": "user",
      "parts": [{
        "text": "审查这个重试方案，找出竞态条件并给出安全的实现计划。"
      }]
    }],
    "generationConfig": {
      "thinkingConfig": {"thinkingLevel": "medium"},
      "maxOutputTokens": 2048
    }
  }'

鉴权和请求头

string

必填

AnyFast API Key。

string

默认值:"application/json"

必填

请求媒体类型。

请求体

object[]

必填

对话历史和当前用户请求。最后一项必须是非空的 user 轮次。

string

默认值:"user"

对话角色：user 或 model。请求不能以 model 轮次结尾。

object[]

必填

当前轮次的内容片段。

string

必填

文本提示词或对话内容。

string

默认值:"medium"

思考等级：low、medium 或 high。

integer

同步请求的最大生成 Token 数，取值为 1 至 32,768。

成功响应

200

{
  "candidates": [{
    "content": {
      "parts": [{"text": "该设计在超时处理和重试调度之间存在竞态条件……"}],
      "role": "model"
    },
    "finishReason": "STOP",
    "index": 0,
    "safetyRatings": []
  }],
  "usageMetadata": {
    "promptTokenCount": 18,
    "candidatesTokenCount": 121,
    "thoughtsTokenCount": 86,
    "totalTokenCount": 225,
    "trafficType": "ON_DEMAND"
  },
  "modelVersion": "gemini-4-argon",
  "responseId": "response-example-001"
}

object[]

生成的候选结果。

object

模型响应轮次。

string

生成的文本。

string

停止生成的原因，例如 STOP、MAX_TOKENS 或 SAFETY。

object[]

对候选结果进行安全评估时返回的安全评级。

object

输入、输出、推理、工具、缓存和总 Token 用量。

string

生成响应的模型版本。

string

响应 ID。

生成内容

POST /v1beta/models/gemini-4-argon:generateContent

cURL

curl --request POST \
  --url 'https://www.anyfast.ai/v1beta/models/gemini-4-argon:generateContent?key=YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "contents": [{
      "role": "user",
      "parts": [
        {"text": "概述这个架构，并找出最可能的性能瓶颈。"},
        {
          "fileData": {
            "mimeType": "image/png",
            "fileUri": "https://example.com/architecture.png"
          }
        }
      ]
    }]
  }'

鉴权和请求头

string

必填

AnyFast API Key。

string

默认值:"application/json"

必填

请求媒体类型。

请求体

object[]

必填

包含文本和媒体的对话轮次。

string

默认值:"user"

对话角色：user 或 model。

object[]

必填

一个或多个文本或媒体片段。

string

针对媒体的指令或问题。

object

内联图片、音频、视频或文档数据。

string

必填

媒体 MIME 类型，例如 image/jpeg、audio/mpeg、video/mp4 或 application/pdf。

string

必填

Base64 编码的媒体数据。

object

通过 URI 提供的媒体或文档。

string

必填

媒体 MIME 类型。

string

必填

可访问的媒体或文档 URI。

成功响应

200

{
  "candidates": [{
    "content": {
      "parts": [{"text": "该图展示了使用消息队列的工作节点层，数据库连接池最可能成为瓶颈……"}],
      "role": "model"
    },
    "finishReason": "STOP",
    "index": 0
  }],
  "usageMetadata": {
    "promptTokenCount": 846,
    "candidatesTokenCount": 94,
    "totalTokenCount": 940,
    "promptTokensDetails": [
      {"modality": "TEXT", "tokenCount": 18},
      {"modality": "IMAGE", "tokenCount": 828}
    ]
  },
  "modelVersion": "gemini-4-argon",
  "responseId": "response-example-002"
}

string

对所传媒体的文本分析。

string

停止生成的原因。

object[]

按模态统计的输入 Token 数。

object[]

返回时按模态统计的输出 Token 数。

string

生成响应的模型版本。

string

响应 ID。

生成内容

POST /v1beta/models/gemini-4-argon:generateContent

cURL

curl --request POST \
  --url 'https://www.anyfast.ai/v1beta/models/gemini-4-argon:generateContent?key=YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "contents": [{
      "role": "user",
      "parts": [{"text": "提取服务名、严重级别和建议操作：checkout-api 请求超时，需要立即回滚。"}]
    }],
    "generationConfig": {
      "responseMimeType": "application/json",
      "responseSchema": {
        "type": "object",
        "properties": {
          "service": {"type": "string"},
          "severity": {"type": "string"},
          "action": {"type": "string"}
        },
        "required": ["service", "severity", "action"]
      }
    }
  }'

鉴权和请求头

string

必填

AnyFast API Key。

string

默认值:"application/json"

必填

请求媒体类型。

请求体

object[]

必填

包含抽取或生成指令的对话轮次。

string

必填

指令和源文本。

string

必填

JSON 结构化输出使用 application/json；单个枚举值使用 text/x.enum。

object

必填

约束生成 JSON 的 Schema。请显式定义属性和必填字段。

成功响应

200

{
  "candidates": [{
    "content": {
      "parts": [{
        "text": "{\"service\":\"checkout-api\",\"severity\":\"critical\",\"action\":\"rollback\"}"
      }],
      "role": "model"
    },
    "finishReason": "STOP",
    "index": 0
  }],
  "usageMetadata": {
    "promptTokenCount": 27,
    "candidatesTokenCount": 24,
    "totalTokenCount": 51
  },
  "modelVersion": "gemini-4-argon",
  "responseId": "response-example-003"
}

string

以文本形式返回且符合所请求 Schema 的 JSON。

string

停止生成的原因。

object

当前请求的 Token 用量。

string

生成响应的模型版本。

string

响应 ID。

生成函数调用

POST /v1beta/models/gemini-4-argon:generateContent

cURL

curl --request POST \
  --url 'https://www.anyfast.ai/v1beta/models/gemini-4-argon:generateContent?key=YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "contents": [{
      "role": "user",
      "parts": [{"text": "检查 checkout-api 的部署状态。"}]
    }],
    "tools": [{
      "functionDeclarations": [{
        "name": "get_deployment_status",
        "description": "返回指定服务当前的部署状态。",
        "parameters": {
          "type": "object",
          "properties": {"service": {"type": "string"}},
          "required": ["service"]
        }
      }]
    }],
    "toolConfig": {
      "functionCallingConfig": {
        "mode": "ANY",
        "allowedFunctionNames": ["get_deployment_status"]
      }
    }
  }'

鉴权和请求头

string

必填

AnyFast API Key。

string

默认值:"application/json"

必填

请求媒体类型。

请求体

object[]

必填

包含用户请求的对话轮次；后续步骤还应包含之前的模型调用和函数结果。

object[]

必填

提供给模型的函数。

string

必填

函数名称。

string

说明模型何时以及如何使用函数。

object

函数参数的 JSON Schema。

string

默认值:"AUTO"

AUTO、ANY、NONE 或 VALIDATED。

string[]

允许模型调用的已声明函数子集。

string

必填

返回工具结果时对应的函数名称。

string

模型返回的调用 ID。

object

结构化函数结果。

string

模型返回的不透明签名，后续请求必须原样保留。

函数调用响应

200

{
  "candidates": [{
    "content": {
      "parts": [{
        "functionCall": {
          "id": "call-example-001",
          "name": "get_deployment_status",
          "args": {"service": "checkout-api"}
        },
        "thoughtSignature": "opaque-signature-placeholder"
      }],
      "role": "model"
    },
    "finishReason": "STOP",
    "index": 0
  }],
  "usageMetadata": {
    "promptTokenCount": 86,
    "candidatesTokenCount": 18,
    "toolUsePromptTokenCount": 64,
    "totalTokenCount": 168
  },
  "modelVersion": "gemini-4-argon",
  "responseId": "response-example-004"
}

object

模型请求调用的函数。

string

用于关联所返回函数结果的调用 ID。

string

函数名称。

object

模型生成的函数参数。

string

回传模型轮次时必须保留的不透明签名。

integer

返回该指标时，工具上下文使用的 Token 数。

string

响应 ID。

生成有依据的内容

POST /v1beta/models/gemini-4-argon:generateContent

cURL

curl --request POST \
  --url 'https://www.anyfast.ai/v1beta/models/gemini-4-argon:generateContent?key=YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "contents": [{
      "role": "user",
      "parts": [{"text": "查找最新的 Gemini API 稳定模型，并给出来源。"}]
    }],
    "tools": [{"googleSearch": {}}]
  }'

鉴权和请求头

string

必填

AnyFast API Key。

string

默认值:"application/json"

必填

请求媒体类型。

请求体

object[]

必填

包含工具辅助请求的对话轮次。

object

使用实时 Google 搜索结果为响应提供依据。

object

使用 Google 地图数据为位置相关回答提供依据。

object

读取和分析提示词中给出的 URL。

object

允许模型执行代码。

object

允许模型提出 Computer Use 操作。此工具处于预览阶段。

string

Computer Use 环境，例如 ENVIRONMENT_BROWSER。

依据响应

200

{
  "candidates": [{
    "content": {
      "parts": [{"text": "Gemini 4 Argon 是最新的稳定版 Flash 模型……"}],
      "role": "model"
    },
    "finishReason": "STOP",
    "groundingMetadata": {
      "webSearchQueries": ["latest stable Gemini API model"],
      "searchEntryPoint": {
        "renderedContent": "<style>...</style><div>...</div>"
      },
      "groundingChunks": [{
        "web": {
          "uri": "https://ai.google.dev/gemini-api/docs/models",
          "title": "Gemini models"
        }
      }],
      "groundingSupports": [{
        "segment": {"startIndex": 0, "endIndex": 56, "text": "Gemini 4 Argon 是最新的稳定版 Flash 模型"},
        "groundingChunkIndices": [0]
      }]
    }
  }],
  "usageMetadata": {
    "promptTokenCount": 15,
    "candidatesTokenCount": 58,
    "toolUsePromptTokenCount": 43,
    "totalTokenCount": 116
  },
  "modelVersion": "gemini-4-argon",
  "responseId": "response-example-005"
}

object[]

文本、可执行代码、代码结果或其他返回片段。

string[]

返回依据元数据时，为检索发起的搜索查询。

string

返回时，由 Google 提供的搜索建议界面 HTML 和 CSS。

object[]

响应返回的网页或地图来源。

object[]

返回时，建立生成文本片段与依据来源的对应关系。

object

启用 codeExecution 且模型选择执行代码时返回的代码。

object

代码执行后返回的执行状态和输出。

integer

返回该指标时，工具上下文使用的 Token 数。

string

响应 ID。

通用可选请求字段

object

仅包含文本的系统指令，内部使用 parts 数组。

string[]

遇到后停止生成的字符串，最多五个。

object[]

按危害类别设置的安全阈值。

string

支持的类别，例如 HARM_CATEGORY_HATE_SPEECH 或 HARM_CATEGORY_DANGEROUS_CONTENT。

string

拦截阈值，例如 BLOCK_MEDIUM_AND_ABOVE、BLOCK_ONLY_HIGH 或 BLOCK_NONE。

错误响应

integer

与 HTTP 状态兼容的错误码。

string

可读的错误说明。

string

规范化错误状态。

400 通常表示最后一个对话轮次无效、思考等级或工具不受支持，或者函数响应不完整；401 表示 API Key 无效；429 表示触发限流。

概览

原生兼容端点

模型 API

生成内容

鉴权和请求头

请求体

成功响应

生成内容

鉴权和请求头

请求体

成功响应

生成内容

鉴权和请求头

请求体

成功响应

生成函数调用

鉴权和请求头

请求体

函数调用响应

生成有依据的内容

鉴权和请求头

请求体

依据响应

通用可选请求字段

错误响应

​生成内容

​鉴权和请求头

​请求体

​成功响应

​生成内容

​鉴权和请求头

​请求体

​成功响应

​生成内容

​鉴权和请求头

​请求体

​成功响应

​生成函数调用

​鉴权和请求头

​请求体

​函数调用响应

​生成有依据的内容

​鉴权和请求头

​请求体

​依据响应

​通用可选请求字段

​错误响应

生成内容

鉴权和请求头

请求体

成功响应

生成内容

鉴权和请求头

请求体

成功响应

生成内容

鉴权和请求头

请求体

成功响应

生成函数调用

鉴权和请求头

请求体

函数调用响应

生成有依据的内容

鉴权和请求头

请求体

依据响应

通用可选请求字段

错误响应