## 生成内容 `POST /v1beta/models/gemini-4-argon:generateContent`

## 鉴权和请求头 AnyFast API Key。请求媒体类型。 ## 请求体对话历史和当前用户请求。最后一项必须是非空的 `user` 轮次。对话角色：`user` 或 `model`。请求不能以 `model` 轮次结尾。当前轮次的内容片段。文本提示词或对话内容。思考等级：`low`、`medium` 或 `high`。同步请求的最大生成 Token 数，取值为 1 至 32,768。 ## 成功响应

```json 200 theme={null} { "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" } ```

生成的候选结果。模型响应轮次。生成的文本。停止生成的原因，例如 `STOP`、`MAX_TOKENS` 或 `SAFETY`。对候选结果进行安全评估时返回的安全评级。输入、输出、推理、工具、缓存和总 Token 用量。生成响应的模型版本。响应 ID。 ## 生成内容 `POST /v1beta/models/gemini-4-argon:generateContent`

## 鉴权和请求头 AnyFast API Key。请求媒体类型。 ## 请求体包含文本和媒体的对话轮次。对话角色：`user` 或 `model`。一个或多个文本或媒体片段。针对媒体的指令或问题。内联图片、音频、视频或文档数据。媒体 MIME 类型，例如 `image/jpeg`、`audio/mpeg`、`video/mp4` 或 `application/pdf`。 Base64 编码的媒体数据。通过 URI 提供的媒体或文档。媒体 MIME 类型。可访问的媒体或文档 URI。 ## 成功响应

```json 200 theme={null} { "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" } ```

对所传媒体的文本分析。停止生成的原因。按模态统计的输入 Token 数。返回时按模态统计的输出 Token 数。生成响应的模型版本。响应 ID。 ## 生成内容 `POST /v1beta/models/gemini-4-argon:generateContent`

```bash cURL theme={null} 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"] } } }' ```

## 鉴权和请求头 AnyFast API Key。请求媒体类型。 ## 请求体包含抽取或生成指令的对话轮次。指令和源文本。 JSON 结构化输出使用 `application/json`；单个枚举值使用 `text/x.enum`。约束生成 JSON 的 Schema。请显式定义属性和必填字段。 ## 成功响应

```json 200 theme={null} { "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" } ```

以文本形式返回且符合所请求 Schema 的 JSON。停止生成的原因。当前请求的 Token 用量。生成响应的模型版本。响应 ID。 ## 生成函数调用 `POST /v1beta/models/gemini-4-argon:generateContent`

```bash cURL theme={null} 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"] } } }' ```

## 鉴权和请求头 AnyFast API Key。请求媒体类型。 ## 请求体包含用户请求的对话轮次；后续步骤还应包含之前的模型调用和函数结果。提供给模型的函数。函数名称。说明模型何时以及如何使用函数。函数参数的 JSON Schema。 `AUTO`、`ANY`、`NONE` 或 `VALIDATED`。允许模型调用的已声明函数子集。返回工具结果时对应的函数名称。模型返回的调用 ID。结构化函数结果。模型返回的不透明签名，后续请求必须原样保留。 ## 函数调用响应

```json 200 theme={null} { "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" } ```

模型请求调用的函数。用于关联所返回函数结果的调用 ID。函数名称。模型生成的函数参数。回传模型轮次时必须保留的不透明签名。返回该指标时，工具上下文使用的 Token 数。响应 ID。 ## 生成有依据的内容 `POST /v1beta/models/gemini-4-argon:generateContent`

## 鉴权和请求头 AnyFast API Key。请求媒体类型。 ## 请求体包含工具辅助请求的对话轮次。使用实时 Google 搜索结果为响应提供依据。使用 Google 地图数据为位置相关回答提供依据。读取和分析提示词中给出的 URL。允许模型执行代码。允许模型提出 Computer Use 操作。此工具处于预览阶段。 Computer Use 环境，例如 `ENVIRONMENT_BROWSER`。 ## 依据响应

```json 200 theme={null} { "candidates": [{ "content": { "parts": [{"text": "Gemini 4 Argon 是最新的稳定版 Flash 模型……"}], "role": "model" }, "finishReason": "STOP", "groundingMetadata": { "webSearchQueries": ["latest stable Gemini API model"], "searchEntryPoint": { "renderedContent": "

...

" }, "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" } ```

文本、可执行代码、代码结果或其他返回片段。返回依据元数据时，为检索发起的搜索查询。返回时，由 Google 提供的搜索建议界面 HTML 和 CSS。响应返回的网页或地图来源。返回时，建立生成文本片段与依据来源的对应关系。启用 `codeExecution` 且模型选择执行代码时返回的代码。代码执行后返回的执行状态和输出。返回该指标时，工具上下文使用的 Token 数。响应 ID。