Gemini 3.1 Pro (openai)

本页说明本站网关实际支持的调用方式。

接口

POST /chat/completions

完整 URL: https://modelfold.ai/v1/chat/completions

鉴权：所有请求都需要 Authorization: Bearer <API_KEY> 请求头。

本站将此请求转换为模型上游协议，返回 OpenAI 风格的对话结果。本端点返回完整 JSON，不支持 stream、tools 或仅上游支持的字段。编程智能体及原生协议接入见 AI Agent。

请求参数

请求体 (application/json)

参数	类型	必填	说明
model	string	是	可选值：gemini-3.1-pro。 示例：gemini-3.1-pro。
messages	array<object>	是	minItems: 1.
messages[].role	string	是	可选值：system / user / assistant。 示例：system。
messages[].content	string	是	—
max_tokens	integer	否	默认值：1024。 示例：1024。
temperature	number	否	—

请求示例

curl -X POST "https://modelfold.ai/v1/chat/completions" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gemini-3.1-pro",
  "messages": [
    {
      "role": "user",
      "content": "Hello!"
    }
  ],
  "max_tokens": 512
}'

{
  "model": "gemini-3.1-pro",
  "messages": [
    {
      "role": "user",
      "content": "Hello!"
    }
  ],
  "max_tokens": 512
}

响应

200 — 对话完成；usage 返回实际 token 和积分用量。

{
  "ok": true,
  "object": "chat.completion",
  "model": "gemini-3.1-pro",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello!"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {}
}