API Reference
API 文档
Goon API 完全兼容 Google Gemini API 格式，只需修改 Base URL 和 API Key 即可使用。
快速开始
三步开始使用 Goon API：
- 注册账户 并登录到控制台
- 在 API Keys 页面 创建一个 API Key
- 将 Base URL 替换为 Goon API 的地址，使用你的 API Key 发送请求
认证方式
所有 API 请求需要在 HTTP Header 中携带 API Key：
HTTP Header
Authorization: Bearer YOUR_API_KEY
Tip
API Key 可在控制台的 API Keys 页面创建和管理。请妥善保管你的 API Key，不要泄露给他人。
Base URL
将所有 API 请求的 Base URL 替换为：
Base URL
Loading...例如，原 Google API 的请求地址：
Google API
https://generativelanguage.googleapis.com/v1/publishers/google/models/gemini-2.5-flash:generateContent替换为：
Goon API
Loading...接口列表
生成内容（非流式）
POST
/v1/publishers/google/models/{model}:generateContent
生成内容（流式）
POST
/v1/publishers/google/models/{model}:streamGenerateContent
获取模型列表
GET
/api/models
生成内容
发送文本生成请求：
Request Body (JSON)
{
"contents": [
{
"role": "user",
"parts": [
{
"text": "Hello, how are you?"
}
]
}
]
}多轮对话
发送包含对话历史的请求，实现多轮对话：
Multi-turn (JSON)
{
"contents": [
{
"role": "user",
"parts": [{ "text": "What is the capital of France?" }]
},
{
"role": "model",
"parts": [{ "text": "The capital of France is Paris." }]
},
{
"role": "user",
"parts": [{ "text": "What about Germany?" }]
}
]
}流式响应
使用 streamGenerateContent 端点获取流式响应。服务端将以 JSON 数组的形式逐块返回数据。
Tip
流式响应适合实时聊天场景，可以在模型生成时即时显示部分结果，提升用户体验。
模型列表
以下是当前支持的模型：
完整模型信息请查看 模型页面。
定价
Goon API 按 Token 用量计费，不同模型价格不同。费用根据输入和输出 Token 分别计算：
- 输入 Token：您发送给模型的文本内容消耗的 Token
- 输出 Token：模型生成的回复内容消耗的 Token
详细价格请参考上方的模型列表，或访问 模型页面。
错误码
代码示例
cURL
bash
Loading...Python
python
Loading...JavaScript (Node.js)
javascript
Loading...
Warning
请不要在客户端代码（如浏览器前端）中直接使用 API Key，以防泄露。建议通过后端服务调用 API。