Format natif Gemini

• Modèle de routage : POST /v1beta/models/{model}:{action}
• Prend en charge generateContent et streamGenerateContent
• La réponse réussie est le protocole brut Gemini

Exemple de requête

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": "你好，介绍一下自己"
          }
        ]
      }
    ]
  }'

Exemple de réponse réussie

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "你好！我是一个由 Google 模型协议兼容接入的 AI 助手。"
          }
        ]
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "promptFeedback": {
    "safetyRatings": []
  },
  "usageMetadata": {
    "promptTokenCount": 4,
    "candidatesTokenCount": 18,
    "totalTokenCount": 22
  }
}

Exemple de réponse d'erreur

{
  "error": {
    "code": 400,
    "message": "Invalid argument",
    "status": "INVALID_ARGUMENT"
  }
}

Authentification

• En-tête de requête : Authorization: Bearer YOUR_API_KEY
• L'authentification ici reste la clé de passerelle Magick API, et non l'exposition directe de la clé Google au client

Paramètres de chemin

model

• Type : string

• Obligatoire : Oui

  Par exemple : gemini-2.5-pro, gemini-2.5-flash.

action

• Type : string

• Obligatoire : Oui

  Actions courantes vérifiées dans le projet actuel :

• generateContent

• streamGenerateContent

Corps de la requête

Le corps de la requête conserve la structure JSON native Gemini, les champs courants incluent :

• contents
• systemInstruction
• tools
• toolConfig
• generationConfig
• safetySettings

Note de compatibilité

• Si vous souhaitez utiliser un corps de requête au style OpenAI, veuillez plutôt utiliser « Modèle universel / Interface de conversation universelle »