Gemini ネイティブ

コンテンツの生成

Google Gemini API 形式を使用してコンテンツを生成します

POST
/v1beta/models/{model}:generateContent

モデル一覧の取得で返されたモデルを使用して、Gemini のリクエストおよびレスポンス形式を利用します。ProtoJSON の lowerCamelCase および対応する proto の snake_case フィールド名に対応しています。サポートされるオプションのフィールドと値は、選択したモデルによって異なります。

パスパラメータ

modelstringpath必須

モデル名(例: gemini-2.5-pro、gemini-3.5-flash)。

クエリパラメータ

keystringquery

API キー(ヘッダー認証の代替)。

認証

Gemini エンドポイントは複数の認証方法をサポートしています:

  • ?key=YOUR_API_KEY クエリパラメータ
  • x-goog-api-key: YOUR_API_KEY ヘッダー
  • Authorization: Bearer YOUR_API_KEY ヘッダー

リクエストボディ

contentsarray必須

parts と任意の role を含む会話コンテンツ。メディアパートには inlineData / inline_data または fileData / file_data を使用します。TokenLab によって作成されたファイルおよびキャッシュ ID は、それらを所有する Workspace 内でのみ使用できます。

systemInstructionobject

モデルに対するシステム指示。

generationConfigobject

temperature、topP、topK、maxOutputTokens、stopSequences、candidateCount、responseModalities、responseMimeType、responseSchema、および thinkingConfig などの生成設定。対応する snake_case の名前も受け入れられます。サポートされる値と組み合わせはモデルによって異なります。

safetySettingsarray

セーフティフィルター設定。

toolsarray

functionDeclarations などの Gemini ツール。サポートされるツールのタイプはモデルによって異なります。

toolConfigobject

functionCallingConfig などのツール設定。

cachedContentstring

キャッシュされたコンテンツの作成で作成されたキャッシュコンテンツの名前(例: cachedContents/abc123)。これを作成した Workspace 内でのみ機能します。

上記に示すすべての lowerCamelCase フィールドは、公式の proto snake_case 表記(例: system_instruction、generation_config、safety_settings、tool_config、cached_content、file_data.file_uri、inline_data.mime_type)を使用することもできます。

サポートされるメソッド

Gemini 互換 API には、モデル一覧の取得、モデルの取得、generateContent、streamGenerateContent、countTokens、Files、およびキャッシュされたコンテンツが含まれます。Gemini の Interactions および Live は利用できません。

呼び出す前に、モデルのモデルの取得レスポンスを確認してください。supportedGenerationMethods にそのモデルが受け入れるアクションがリストされています。

レスポンス

candidatesarray

生成されたコンテンツ候補。

usageMetadataobject

トークン使用量情報。

リクエスト

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
    }
  }'

エラー

  • 400 INVALID_ARGUMENT: ボディが無効であるか、モデルが Gemini リクエストを受け付けません。
  • 401 UNAUTHENTICATED: API キーが見つからないか無効です。
  • 402 RESOURCE_EXHAUSTED: このリクエストに対する残高が不足しています。
  • 503 UNAVAILABLE: 現在モデルに対して利用可能なルートがありません。後で再試行してください。

メディア入力

メディアは、インラインの Base64 バイト(inlineData または inline_data)またはパブリックな https URL(fileData または file_data)として contents[].parts[] 内に配置します。画像、音声、動画がサポートされています。

画像

インライン画像バイトを使用する場合:

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

画像 URL を使用する場合:

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

音声

音声 URL を使用する場合(ここでは proto の snake_case 名を使用):

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

動画

動画 URL を使用する場合:

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

レスポンス

Response
{
  "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
  }
}

トークンカウントと埋め込み

トークン数のカウント(POST /v1beta/models/{model}:countTokens)には API キーが必要ですが、課金はされません。計画にカウント結果を活用してください。生成リクエストの料金は、そのレスポンスの usageMetadata から算出されます。

埋め込みモデルには埋め込みの作成(POST /v1/embeddings)を使用します。embedContent または batchEmbedContents の呼び出しは、モデルの取得レスポンスの supportedGenerationMethods にそれらがリストされているモデルに対してのみ行ってください。

認証

AuthorizationBearer <token>

APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。

場所: header

パスパラメータ

model*string

モデル名 (例: gemini-2.5-pro)

クエリパラメータ

key?string

APIキー (ヘッダー認証の代替)

ヘッダー

X-TokenLab-Delivery-Policy?string

リクエストごとの配信ポリシー。APIキーおよびWorkspaceのデフォルト設定を上書きします。自動的にまず TokenLab Verified を試行し、出力、リクエストの受け入れ、または永続的なリソース作成の前に、一度だけ Official に切り替える場合があります。

指定できる値

  • "auto"
  • "verified"
  • "official"

リクエストボディ

application/json

ネイティブGemini GenerateContentリクエスト。ProtoJSONのlowerCamelCaseと元のprotoのsnake_caseの両方が受け入れられ、保持されます(混在リクエストを含む)。1つのフィールドに対して両方の綴りが存在する場合、TokenLabはそれらをマージしたり、ローカルの優先順位を選択したりしません。不明なフィールドはベストエフォートで転送されます。

レスポンス

application/json

application/json

application/json

application/json

application/json

application/json