RL RanceLee Tutorials
← Tutorialsへ戻る

APIの呼び出し方とAPIプラットフォームの選び方

ここまでAPI、トークン、Temperatureといった中核的な概念を説明してきました。次は実践編です。実際にAPIを呼び出すにはどうすればいいのでしょうか？

多くの人はAPIを神秘的に感じていますが、いくつかの重要な要素を押さえれば、APIの呼び出しはオンラインショッピングと同じくらい簡単です。この章では、ステップバイステップで解説します。

API呼び出しの3つの中核要素

どのツールやプラットフォームを使うにしても、AI APIを呼び出すには以下の3つが必要です。

1. APIキー

APIキー = あなたの身分証明書

銀行でお金を引き出すときにキャッシュカードの暗証番号が必要なように、APIを呼び出すにはAPIキーが必要です。「これは私です。サービスを提供してください」と証明するためのものです。

APIキーはどんなもの？

通常は、長い文字列の英数字です。例：

sk-REPLACE_WITH_YOUR_API_KEY

重要な注意点：

  • APIキーは非公開です。他人と共有しないでください。
  • キーが漏れると、他人があなたのアカウントでAPIを呼び出せます（あなたの費用で）。
  • 誤って漏らした場合は、すぐにプラットフォーム上で古いキーを削除し、新しいキーを生成してください。

2. ベースURL

ベースURL = レストランの住所

出前を注文するとき、レストランの場所を知る必要があります。APIを呼び出すときは、サーバーの場所を知る必要があります。

よくあるベースURL：

  • OpenAI: https://api.openai.com/v1
  • Anthropic Claude: https://api.anthropic.com/v1
  • Google Gemini: https://generativelanguage.googleapis.com/v1
  • DeepSeek: https://api.deepseek.com/v1

サードパーティのプラットフォームはURLが異なりますが、形式は似ています。

3. モデル名

モデル名 = 注文したい料理

レストランで「豚の角煮をください」と言うように、APIを呼び出すときは「GPT-5.2を使いたい」と言います。

よくあるモデル名：

  • OpenAI: gpt-5.2, gpt-5.2-chat-latest
  • Claude: claude-opus-4.5, claude-sonnet-4.5
  • Gemini: gemini-3-pro, gemini-3-flash
  • DeepSeek: deepseek-chat, deepseek-coder

完全なAPI呼び出しの例

これら3つを組み合わせると、最もシンプルなAPI呼び出しは次のようになります。

import openai

# 1. Set the API Key
openai.api_key = "sk-proj-YOUR_API_KEY"

# 2. Set the Base URL (if you use a third-party platform)
openai.base_url = "https://api.openai.com/v1"

# 3. Call the selected model
response = openai.chat.completions.create(
    model="gpt-5.2",  # Model Name
    messages=[
        {"role": "user", "content": "Hello"}
    ]
)

print(response.choices[0].message.content)

複雑に見えますか？ 心配しないでください。後で紹介するプラットフォームには、もっと簡単な方法があります。

公式API vs サードパーティプラットフォーム

具体的なプラットフォームを紹介する前に、重要な概念を明確にしておきましょう。公式APIとサードパーティプラットフォームの違いは何でしょうか？

公式API

公式API = OpenAI、Anthropic、Googleから直接購入

メリット：

  • 安定性が最も高く、公式サーバーに直接接続
  • 全機能が利用可能で、新機能もすぐにサポート
  • セキュリティが最も高く、データがサードパーティを経由しない

デメリット：

  • 海外のクレジットカードが必要
  • VPNが必要（ChatGPT、Claude、Gemini）
  • 比較的高価格
  • 登録に障壁がある場合がある

サードパーティプラットフォーム

サードパーティプラットフォーム = 再販業者から購入

サードパーティプラットフォームは、まず公式からAPI枠を購入し、それをあなたに再販します。

メリット：

  • 国内決済対応（Alipay、WeChat Pay、UnionPay）
  • VPN不要
  • 通常、中国語のインターフェースとカスタマーサービスあり
  • 1つのプラットフォームで複数のAIを呼び出せる（OpenAI、Claude、Geminiなど）
  • 無料クレジットを提供するプラットフォームもある

デメリット：

  • 安定性が公式に劣る場合がある
  • 公式より価格が少し高い場合がある（ただし安い場合もある）
  • セキュリティはプラットフォームへの信頼が必要
  • 機能のアップデートが公式より遅れる場合がある

どちらを選ぶべきか？

公式を選ぶべき人：

  • 海外のクレジットカードを持っている
  • 安定したVPNを持っている
  • データセキュリティを重視する
  • 最新の機能が必要

サードパーティを選ぶべき人：

  • 海外の支払い手段がない
  • VPNがない
  • 国内決済を使いたい
  • 1つのプラットフォームで複数のAIを呼び出したい

プラットフォームのおすすめ（国内2つ＋海外2つ）

以下に、私がおすすめする4つのAPIプラットフォームを紹介します。国内2つ、海外2つで、さまざまなニーズをカバーします。

1. DeepSeek公式（国内、公式プラットフォーム）

ウェブサイト： https://platform.deepseek.com

プラットフォームタイプ： 公式プラットフォーム

おすすめの理由：

  • 公式プラットフォームで安定・信頼性が高い
  • DeepSeek V3.2の性能はGPT-5に迫る
  • 中国国内から高速アクセス可能、VPN不要
  • 登録が簡単、電話番号のみ
  • 価格が非常に安く、コストパフォーマンスが高い

APIキー取得手順：

  1. https://platform.deepseek.com を開く
  2. 右上の「ログイン/登録」をクリック
  3. 電話番号でアカウント登録
  4. ログイン後、左側の「API Keys」をクリック
  5. 「Create API Key」をクリック
  6. キーをコピー（一度しか表示されないので保存してください）
  7. 左側の「インターフェースドキュメント」をクリックしてURLとモデル名を確認

呼び出しパラメータ：

  • ベースURL: https://api.deepseek.com
  • モデル名: deepseek-chat（チャット）、deepseek-reasoner（推論）
  • APIキー: 先ほどコピーしたキー

2. Volcano Engine（国内、公式プラットフォーム＋サードパーティ）

ウェブサイト： https://console.volcengine.com/ark

プラットフォームタイプ： 公式プラットフォーム（ByteDance傘下）

おすすめの理由：

  • ByteDance公式プラットフォームで安定・信頼性が高い
  • Doubaoシリーズモデルに対応
  • 国内決済対応（Alipay、WeChat Pay、UnionPay）
  • 手頃な価格でコストパフォーマンスが高い
  • Doubao独自モデルに加え、DeepSeek V3.2、GLM 4.7など多くの国内オープンソースモデルも呼び出せる

利用手順：

  1. https://console.volcengine.com/ark を開く
  2. 電話番号でVolcano Engineアカウントを登録
  3. 「Ark大規模言語モデル」コンソールに入る
  4. 実名認証を完了（身分証明書が必要）
  5. 「APIキー管理」をクリック
  6. 新しいAPIキーを作成
  7. キーをコピーして保存
  8. 左側の「アクティベーション管理」をクリックし、使用したいモデルを選択
  9. 新しいページで必要なモデル名をコピー（同じモデルでもプラットフォームによって名前が異なる場合があるので注意）
  10. アクティベーション管理ページに戻り、ステータスが「アクティブ」になっているか確認。なっていなければ右側をクリックしてモデル権限をアクティベート

呼び出しパラメータ：

  • ベースURL: https://ark.cn-beijing.volces.com/api/v3
  • モデル名: doubao-pro-32k、doubao-lite-32kなど
  • APIキー: 作成したキー

新規ユーザー特典：

  • 登録時に無料クレジット
  • スクリーンショット上部のアクティビティに参加してさらに無料クレジットを獲得可能。私は毎日余るほど持っています。

3. Google AI Studio（海外、公式プラットフォーム）

ウェブサイト： https://aistudio.google.com

プラットフォームタイプ： 公式プラットフォーム

おすすめの理由：

  • Google公式プラットフォーム
  • 無料クレジットあり（制限あり）
  • Gemini 3はトップクラスの性能
  • 安定・信頼性が高い
  • 非常に長いコンテキスト（200万トークン）に対応
  • Webインターフェースで直接無料で使用可能、コーディング不要

また、Web版を無料で使う方法

コードを書きたくない場合、Google AI Studioには非常に便利なWebチャットインターフェースがあり、Gemini 3 ProやGemini 3 Flashなどのモデルを直接使用できます。実質的に有料のGeminiユーザーになったようなものです。

利用手順：

  1. https://aistudio.google.com を開く
  2. Googleアカウントでログイン（VPNが必要）
  3. 左側の「Playground」をクリック
  4. 右上でモデルを選択：
    • gemini-3-pro: 最良のモデル、複雑なタスクに適する
    • gemini-3-flash: 高速モデル、日常会話に適する
    • その他の実験的モデルも利用可能
  5. 入力ボックスに質問を直接入力し、「Run」をクリックするとAIが回答

高度な機能（Web版）：

1. ファイルのアップロード

  • 入力ボックス右側の+アイコンをクリック
  • 画像、PDF、ドキュメントなどをアップロード可能
  • マルチモーダル理解に対応

2. パラメータの調整

  • 右側で先ほど説明したパラメータを調整可能
  • 調整できる項目：
    • Temperature（創造性）
    • Top P
    • 最大出力トークン数
    • セーフティ設定

Web版のメリット：

  • コーディング不要
  • ソフトウェアのインストール不要
  • ブラウザで直接使用
  • ユーザーフレンドリーなインターフェース、全機能搭載
  • クイックテストや日常利用に最適

Web版はこんな人におすすめ：

  • コードが書けない完全な初心者
  • Geminiの能力をすぐに試したい人
  • 日常的なチャットや質問
  • ドキュメントや画像などのマルチモーダルタスク

APIキーの取得（上級者向け）

本題に戻り、APIキーの取得方法です。

APIキー取得手順：

  1. AI Studioページで、左側の「APIキーを取得」をクリック
  2. 「APIキーを作成」をクリック
  3. 生成されたAPIキーを作成してコピー
  4. Playgroundに戻り、右側でモデル名を選択してコピー

呼び出しパラメータ：

  • ベースURL: https://generativelanguage.googleapis.com/v1beta
  • モデル名: gemini-3-flash-preview
  • APIキー: コピーしたキー

無料枠の制限

重要！Google AI Studioはデフォルトで無料枠を使用します。制限は以下の通りです（2026年1月時点、変更される可能性あり）：

  • 1分あたりのリクエスト数（RPM）: 15
  • 1日あたりのリクエスト数（RPD）: 1500
  • 1分あたりのトークン数（TPM）: 100万トークン

詳細な制限はこちら：https://ai.google.dev/gemini-api/docs/rate-limits?hl=en

無料枠で足りるか？

  • Webチャット: 十分すぎる
  • たまにAPIを呼び出す: 十分
  • 大量の自動呼び出し: 足りない可能性あり

制限を解除するには？クラウドクレジットをリンクする

Google Cloudは新規ユーザーに10ドルの無料クレジットを提供しています。 これをAI Studioにリンクすると、より高い制限を解除できます。Google Cloudアカウントの設定方法については、ネットで「Google Cloud 無料クレジット」を検索すれば多くのチュートリアルがあります。ここでは割愛します。

リンク手順：

  1. AI StudioでAPIインターフェースに戻り、「課金を設定」をクリック
  2. 先ほど作成したGoogle Cloudの課金アカウントをリンク

リンク後のメリット：

  • レート制限が大幅に向上（RPMが1000以上に）
  • 無料クレジットは引き続き有効
  • 10ドルあれば、強力なflashモデルで長期間使用可能
  • Web版とAPIの両方でより高い割り当てを享受

4. OpenRouter（海外、サードパーティプラットフォーム）

ウェブサイト： https://openrouter.ai

プラットフォームタイプ： サードパーティプラットフォーム

おすすめの理由：

  • 1つのプラットフォームで主要なAIすべてを呼び出せる（GPT、Claude、Geminiなど）
  • 価格が透明で、公式より安い場合もある
  • Alipay決済対応（中国ユーザーに便利）
  • クレジットカードと暗号通貨決済に対応
  • 無料モデルで試用可能
  • ほぼすべての利用可能なモデルを呼び出せる
  • ランキングが信頼できる

APIキー取得手順：

  1. https://openrouter.ai を開く
  2. 右上の「Sign In」をクリックし、GoogleまたはGitHubでログイン
  3. ログイン後、右上のアバターをクリックし、「Keys」を選択
  4. 「Create Key」をクリック
  5. キーに名前を付けて作成をクリック
  6. 生成されたキーをコピー
  7. 検索ボックスで目的のモデルを検索し、名前をコピー

呼び出しパラメータ：

  • ベースURL: https://openrouter.ai/api/v1
  • モデル名:
    • GPT-5.2: openai/gpt-5.2
    • Claude Opus 4.5: anthropic/claude-opus-4.5
    • Gemini 3 Pro: google/gemini-3-pro
    • 無料モデル: meta-llama/llama-3.1-8b-instruct:free
  • APIキー: 作成したキー

チャージ方法：

  • Alipay（最も便利）
  • クレジットカード
  • 暗号通貨（USDCなど）

価格面のメリット：

  • 一部のモデルは公式より10～20％安い
  • 価格が透明で、ウェブサイトで直接確認可能
  • プロバイダー間で競争があり、最安値を選べる

無料オプション：

  • 一部のモデルは完全無料（:freeと表示）
  • 新規ユーザーは無料クレジットで試用可能
  • まず無料モデルでテストできる

モデルランキング

  • ランキングページでは、プラットフォーム上のモデル呼び出しデータを確認でき、ランキングは非常に信頼性が高い。

その他の無料プラットフォーム

スペースの都合上、他にも無料で使えるプラットフォームをいくつか紹介します。

Cerebras（超高速推論）

ウェブサイト： https://cloud.cerebras.ai

特徴：

  • 非常に高速な推論（世界最速と謳う）
  • 無料のLlamaモデル呼び出しを提供
  • 登録が簡単、GitHubでログインするだけ

NVIDIA NIM（NVIDIA公式）

ウェブサイト： https://build.nvidia.com

特徴：

  • NVIDIA公式AIプラットフォーム
  • 複数の無料モデルを提供
  • テストや開発に適する

どちらのプラットフォームも無料クレジットを提供しています。興味があれば登録して試してみてください。

まとめ

3つの中核要素：

  1. APIキー
  2. ベースURL
  3. モデル名

おすすめの4つのプラットフォーム：

  1. DeepSeek公式（公式） - 中国国内で最も低コストな選択肢
  2. Volcano Engine（公式＋サードパーティ） - 国内プラットフォーム、ほとんどの国内オープンソースモデルを呼び出せる
  3. Google AI Studio（公式） - 海外で最も優れた無料選択肢（Cloud Credits併用）、Webで直接使用可能
  4. OpenRouter（サードパーティ） - オールインワンプラットフォーム、Alipay対応