汎用モデル
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 キーをクライアントに直接公開するものではありません
パスパラメータ
model
-
型：
string -
必須：はい
例：
gemini-2.5-pro、gemini-2.5-flash。
action
-
型：
string -
必須：はい
現在のプロジェクトで検証済みの一般的なアクション：
-
generateContent -
streamGenerateContent
リクエストボディ
リクエストボディは Gemini ネイティブ JSON 構造を維持し、よく使われるフィールドは以下の通りです：
contentssystemInstructiontoolstoolConfiggenerationConfigsafetySettings
互換性に関する注意
- OpenAI スタイルのリクエストボディを使用したい場合は、「汎用モデル / 汎用会話インターフェース」をご利用ください。
最終更新