生成内容：gemini-2.5-flash

使用 Vortap 的原生模型兼容接口调用 gemini-2.5-flash 生成内容。

HTTP 请求

POST https://www.vortapapi.com/v1beta/models/gemini-2.5-flash:generateContent

查询参数

名称	类型	必填	说明
key	string	是	Vortap API Key，例如 sk-***。

请求头

名称	必填	说明
Content-Type	是	请求体格式。通常设置为 application/json。

请求体

请求体为 JSON。常用字段如下：

字段	类型	必填	说明
contents	array	是	输入内容列表。每个元素通常包含 role 与 parts。
contents[].role	string	否	消息角色，例如 user。
contents[].parts	array	是	内容片段数组，可包含文本或文件相关内容。
contents[].parts[].text	string	否	文本输入。
generationConfig	object	否	生成参数配置。
systemInstruction	object	否	系统级指令。

示例：文本生成

curl "https://www.vortapapi.com/v1beta/models/gemini-2.5-flash:generateContent?key=sk-***" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "请用三句话介绍 Vortap。"
          }
        ]
      }
    ]
  }'

示例：带生成配置

curl "https://www.vortapapi.com/v1beta/models/gemini-2.5-flash:generateContent?key=sk-***" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "写一段适合 API 文档首页的简介。"
          }
        ]
      }
    ],
    "generationConfig": {
      "temperature": 0.7,
      "maxOutputTokens": 512
    }
  }'

响应示例

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "Vortap 是一个面向开发者的 AI 模型 API 网关，提供统一、稳定的模型调用体验。它兼容常见 API 调用方式，便于将不同模型快速接入现有应用。通过 Vortap，团队可以更高效地构建、测试和部署 AI 功能。"
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 12,
    "candidatesTokenCount": 58,
    "totalTokenCount": 70
  }
}

注意事项

• key 必须作为查询参数传入。
• 请求体必须是合法 JSON，并且请求头应包含 Content-Type: application/json。
• 模型路径中的 gemini-2.5-flash 是模型标识，请保持不变。