Gemini API（generateContent）の使い方

POST https://api.laozhang.ai/v1beta/models/{model}:generateContent

​

認証情報とモデルの選択

export LAOZHANG_API_KEY="YOUR_LAOZHANG_API_KEY"

​

テキストを生成する

curl --fail-with-body --max-time 120 \
  "https://api.laozhang.ai/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{"text": "「connected」とだけ返信してください"}]
    }]
  }'

-H "x-goog-api-key: $LAOZHANG_API_KEY"

python -m pip install google-genai

import os
from google import genai

client = genai.Client(
    api_key=os.environ["LAOZHANG_API_KEY"],
    http_options={
        "base_url": "https://api.laozhang.ai",
        "api_version": "v1beta",
        "timeout": 120_000,
    },
)
response = client.models.generate_content(
    model="gemini-3.8-flash",
    contents="「connected」とだけ返信してください",
)
print(response.text)

​

回答をストリーミングする

​

リクエストの構造

​

画像を含める

import base64
import json
from pathlib import Path

request = {
    "contents": [{
        "role": "user",
        "parts": [
            {"text": "この画像に写っているものを説明してください。"},
            {"inlineData": {
                "mimeType": "image/png",
                "data": base64.b64encode(Path("input.png").read_bytes()).decode("ascii"),
            }},
        ],
    }],
}
Path("gemini-request.json").write_text(json.dumps(request), encoding="utf-8")

curl --fail-with-body --max-time 120 \
  "https://api.laozhang.ai/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @gemini-request.json

​

PDFや音声ファイルを送る

import base64
import json
from pathlib import Path

request = {
    "contents": [{
        "role": "user",
        "parts": [
            {"inlineData": {
                "mimeType": "application/pdf",
                "data": base64.b64encode(Path("invoice.pdf").read_bytes()).decode("ascii"),
            }},
            {"text": "請求書番号、請求金額の合計、支払期日を教えてください。"},
        ],
    }],
}
Path("gemini-file-request.json").write_text(json.dumps(request), encoding="utf-8")

curl --fail-with-body --max-time 120 \
  "https://api.laozhang.ai/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @gemini-file-request.json

import os
from pathlib import Path
from google import genai
from google.genai import types

client = genai.Client(
    api_key=os.environ["LAOZHANG_API_KEY"],
    http_options={
        "base_url": "https://api.laozhang.ai",
        "api_version": "v1beta",
        "timeout": 120_000,
    },
)
response = client.models.generate_content(
    model="gemini-3.8-flash",
    contents=[
        types.Part.from_bytes(
            data=Path("audio.mp3").read_bytes(),
            mime_type="audio/mp3",
        ),
        "この音声を文字起こしし、そのあと1文で要約してください。",
    ],
)
print(response.text)

​

動画を理解させる

{"inlineData": {"mimeType": "video/mp4", "data": "<BASE64_DATA>"}}

{"fileData": {"fileUri": "https://www.youtube.com/watch?v=9hE5-98ZeCg", "mimeType": "video/mp4"}}

• ローカルの動画を送る、または動画のURLを分析する。
• 動画をタイムスタンプ付きのチャプターに分ける、または構造化されたJSONを返す。
• videoMetadata で区間を切り出す、またはフレームレートを変える。
• 動画を比較する、回答をストリーミングする、OpenAI SDKで呼び出す。

​

レスポンスを読み取る

{
  "candidates": [{
    "content": {
      "role": "model",
      "parts": [{"text": "connected"}]
    },
    "finishReason": "STOP"
  }]
}

​

会話を続ける

​

トラブルシューティング

• 401： APIキーと認証ヘッダーを確認してください。アカウント管理用のAccessTokenではなく、モデル用のAPIキーを使います。
• 404、またはモデルが見つからない： v1beta、正確なモデルID、トークングループでのGeminiネイティブの利用権限を確認してください。
• 400： contents、parts、メッセージのロール、メディアのエンコード、エラーに挙げられた任意の設定を確認してください。
• テキストのないレスポンス： candidates、finish reason、ブロックのフィードバック、テキスト以外のコンテンツを確認してください。
• 「Cannot fetch content from the provided URL」の400： 画像や動画のURLを直接ダウンロードできません。ログイン不要で、サイトの robots.txt にブロックされていない公開の直リンクを使うか、inlineData でファイルを送ってください。
• 413： リクエスト本文が大きすぎます。リクエスト全体を20MB以内に収め、大きなファイルは fileData でリンクを渡してください。
• ファイルのアップロードでWebページまたは404が返る： File APIは利用できません。代わりに inlineData か fileData のURLを使ってください。
• cURLでは動くがSDKでは失敗する： SDKのベースURLとAPIバージョンを確認してください。最終的なURLには、/v1beta/models/ が1回だけ含まれるはずです。

​

よくある質問

​

Gemini APIの料金は？ Googleアカウントは必要？

• gemini-4-argon：入力$2、出力$10
• gemini-3.8-flash：入力$0.75、出力$3.75
• gemini-2.5-flash：入力$0.3、出力$2.4

​

OpenAI互換のエンドポイントで送れるメディアは？

• 画像：image_url にURLまたはBase64のデータURLを入れて送ります。画像理解APIを参照してください。
• 動画：video_url にBase64のデータURLを入れて送ります。OpenAI SDKで呼び出すを参照してください。
• file パートのPDFと input_audio パートの音声は破棄されます。リクエストは200を返しますが、モデルがファイルを見ないまま回答することがあります。代わりに、このページの inlineData で送ってください。

​

GeminiモデルでResponses APIは使えますか？

​

GoogleのFile APIには対応していますか？

• /upload/v1beta/files のアップロードエンドポイント
• files/... による参照
• SDKの client.files.upload()

​

メディア入力はどう課金されますか？

​

VeoやNano Banana Proをネイティブで呼び出せますか？

• Nano Banana Pro： gemini-3-pro-image は、ネイティブの generateContent で利用できます。Nano Banana Proを参照してください。
• Veo： 2026年9月28日時点で、Veoは公開モデルカタログに載っておらず、ネイティブの predictLongRunning リクエストは利用可能なチャネルがないというエラーを返します。動画生成にはWan 2.7かSeedance 2.0を使ってください。

​

AI StudioとVertex AIのどちらですか？

• モデルID、提供終了日、安全ポリシーは、Googleのdeprecationsページなど、Gemini APIドキュメントに従います。
• リクエストは、AI Studio形式の v1beta パスを使い、Vertexのプロジェクトやロケーションは使いません。
• 上流の障害が疑われるときは、Gemini APIのインシデントについてAI Studioのステータスページを確認してください。

​

関連ドキュメント

• 動画理解API
• Google generateContentリファレンス
• Google Gen AI Python SDK
• OpenAIプロトコル：Chat Completions
• モデルカタログと料金
• モデルへのアクセスと権限
• API接続ガイド