Inhalte generieren

Verwenden Sie die Gemini-Anfrage- und Antwortformate mit einem Modell, das von der Gemini Models API zurückgegeben wird. ProtoJSON lowerCamelCase und die entsprechenden proto snake_case Feldnamen werden akzeptiert. Unterstützte optionale Felder und Werte hängen vom ausgewählten Modell ab.

PfadparameterCopy Anchor Link

AbfrageparameterCopy Anchor Link

AuthentifizierungCopy Anchor Link

Gemini-Endpunkte unterstützen mehrere Authentifizierungsmethoden:

• ?key=YOUR_API_KEY Abfrageparameter
• x-goog-api-key: YOUR_API_KEY Header
• Authorization: Bearer YOUR_API_KEY Header

AnfragekörperCopy Anchor Link

Jedes oben gezeigte lowerCamelCase-Feld kann auch in der offiziellen proto snake_case-Schreibweise verwendet werden, zum Beispiel system_instruction, generation_config, safety_settings, tool_config, cached_content, file_data.file_uri und inline_data.mime_type.

Unterstützte MethodenCopy Anchor Link

Die Gemini-kompatible API umfasst das Auflisten/Abrufen von Modellen, generateContent, streamGenerateContent, countTokens, embedContent und batchEmbedContents. Gemini Interactions und Live sind nicht verfügbar.

AntwortCopy Anchor Link

curl -X POST "https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro:generateContent?key=sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [{"text": "Hello, Gemini!"}]
      }
    ],
    "generationConfig": {
      "temperature": 0.7,
      "maxOutputTokens": 1024
    }
  }'

Beispiel für Vision-InputCopy Anchor Link

Für multimodale Gemini-Anfragen platzieren Sie Medien innerhalb von contents[].parts[] unter Verwendung von Inline-Bytes oder URL-basierten Dateireferenzen.

Unterstützte Medienkategorien im öffentlichen Gemini-Vertrag:

• image
• audio
• video

Für Inline-Medien verwenden Sie entweder inlineData oder inline_data und übergeben Sie Base64-kodierte Dateibytes.

Für URL-basierte Medien verwenden Sie entweder fileData oder file_data und übergeben Sie eine öffentliche https-URL.

Beispiel für Video-InputCopy Anchor Link

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Please describe this video." },
        {
          "fileData": {
            "mimeType": "video/mp4",
            "fileUri": "https://example.com/demo.mp4"
          }
        }
      ]
    }
  ]
}

Beispiel für Audio-InputCopy Anchor Link

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Please describe this audio." },
        {
          "fileData": {
            "mimeType": "audio/mpeg",
            "fileUri": "https://example.com/demo.mp3"
          }
        }
      ]
    }
  ]
}

Beispiel für Image-InputCopy Anchor Link

Verwenden Sie Inline-Bildbytes:

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Please describe this image." },
        {
          "inlineData": {
            "mimeType": "image/jpeg",
            "data": "/9j/4AAQSkZJRgABAQ..."
          }
        }
      ]
    }
  ]
}

Verwenden Sie eine Bild-URL:

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Please describe this image." },
        {
          "fileData": {
            "mimeType": "image/jpeg",
            "fileUri": "https://example.com/demo.jpg"
          }
        }
      ]
    }
  ]
}

Beispiel für Audio-InputCopy Anchor Link

Verwenden Sie eine Audio-URL:

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Transcribe and summarize this audio." },
        {
          "file_data": {
            "mime_type": "audio/mpeg",
            "file_uri": "https://example.com/sample.mp3"
          }
        }
      ]
    }
  ]
}

Beispiel für Video-InputCopy Anchor Link

Verwenden Sie eine Video-URL:

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Describe this video briefly." },
        {
          "fileData": {
            "mimeType": "video/mp4",
            "fileUri": "https://example.com/sample.mp4"
          }
        }
      ]
    }
  ]
}

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {"text": "Hello! How can I assist you today?"}
        ]
      },
      "finishReason": "STOP",
      "safetyRatings": [
        {"category": "HARM_CATEGORY_HARASSMENT", "probability": "NEGLIGIBLE"}
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 5,
    "candidatesTokenCount": 10,
    "totalTokenCount": 15
  }
}

Zugehörige SchnittstellenCopy Anchor Link

Lesen Sie die aktuellen Modelldetails des ausgewählten Modells, bevor Sie eine andere Schnittstelle verwenden. Verfügbarkeit und Anfragefelder hängen vom Modell ab.

Die Token-Zählung erfordert einen API-Schlüssel und wird nicht in Rechnung gestellt. Die zurückgegebene Eingabeanzahl ist eine Schätzung für die Planung; verwenden Sie die endgültige Antwortnutzung und den Abrechnungsdatensatz für die tatsächliche Berechnung.

countTokens: contents / generateContentRequest

embedContent: content, taskType, title, outputDimensionality

batchEmbedContents: requests