通用模型
Gemini 原生格式
使用 Gemini 原生路径和原生请求体；支持 generateContent 与 streamGenerateContent；成功响应为 Gemini 原始 JSON。
- 路由模板：
POST /v1beta/models/{model}:{action} - 支持
generateContent和streamGenerateContent - 成功响应为 Gemini 原始协议
请求示例
curl --request POST \
--url https://api.magickapi.com/v1beta/models/gemini-2.5-pro:generateContent \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "你好，介绍一下自己"
}
]
}
]
}'成功响应示例
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{
"text": "你好！我是一个由 Google 模型协议兼容接入的 AI 助手。"
}
]
},
"finishReason": "STOP",
"index": 0
}
],
"promptFeedback": {
"safetyRatings": []
},
"usageMetadata": {
"promptTokenCount": 4,
"candidatesTokenCount": 18,
"totalTokenCount": 22
}
}错误响应示例
{
"error": {
"code": 400,
"message": "Invalid argument",
"status": "INVALID_ARGUMENT"
}
}认证
- 请求头：
Authorization: Bearer YOUR_API_KEY - 这里的鉴权仍然是 Magick API 的网关密钥，不是直接把 Google Key 暴露给客户端
路径参数
model
-
类型：
string -
必填：是
例如：
gemini-2.5-pro、gemini-2.5-flash。
action
-
类型：
string -
必填：是
当前项目已验证的常用动作：
-
generateContent -
streamGenerateContent
请求体
请求体保持 Gemini 原生 JSON 结构，常用字段包括：
contentssystemInstructiontoolstoolConfiggenerationConfigsafetySettings
兼容说明
- 如果你想使用 OpenAI 风格请求体，请改用“通用模型 / 通用对话接口”
最后更新于