著者注:2026年11月は新モデルのリリースが集中しました。この記事では、1つの入口でモデルを切り替え、エンドポイントごとに接続し、各チャネルの請求を個別に計算する方法を説明します。
11月に入ってまだ3週間ですが、Googleはすでに3つのGemini 4モデルを相次いで発表しています。11月10日にCarbon、11月12日にHydrogen、11月18日にNeonです。画像やコーディングなどの分野でも、新しいモデルが続々とニュースに登場しています。新しいモデルを試したい開発者にとって面倒なのは、呼び出しコードが書けないことではなく、各社がそれぞれ独自のSDK、認証、課金基準を持っていることです。この記事では、より手間のかからない方法を紹介します。1つの入口でモデルを切り替え、請求はチャネルごとに分けて確認する。
これは「新モデル全部入り」の宣伝リストではありません。ニュースに登場するモデルと、プラットフォーム上ですでに呼び出せるモデルは、本文では分けて記述します。たとえばニュースに登場するMAI Image 2.7は、現時点でAPIYIのラインナップには入っていないため、本文では呼び出し可能なモデルとして扱いません。
核心的な価値:この記事を読み終えると、まずどこでモデル一覧を確認すればよいか、どのモデルIDに切り替えるかをどう決めるか、モデルの種類ごとにどのエンドポイントを使うか、そして1つのモデルの単価で請求全体を見積もってしまうことをどう避けるかがわかります。本文で扱うモデルと価格は、すべてAPIYI apiyi.comの2026-11-20時点のモデルリストと価格APIに基づきます。

11月の新モデル接続の核心ポイント
新しいモデルが集中的に登場する時期に最もミスが起きやすいのは、次の3つの場面です。ニュースで発表されたモデル名をそのまま「もう利用できるモデル名」と勘違いする、エンドポイントを間違える、そして1つの単価で全体のコストを試算してしまう。以下の表では、この3つとそれぞれの対処法をまとめています。
| ポイント | 説明 | メリット |
|---|---|---|
| まずモデル一覧表と照合する | プラットフォームのモデル一覧表と価格APIを基準にし、ニュースで発表されたモデル名と実際に呼び出せるモデル名を分けて記録する | 発表会で聞いたモデル名をそのまま使って呼び出し、エラーになるのを避けられる |
| モデルを変える=モデルIDを変える+エンドポイントを確認する | 同じ base_url の下で model パラメータを変更し、chat、messages、responses、gemini のどれを使うかを確認する |
ベンダーごとにSDKを書き分ける必要がない |
| 請求はチャネルごとに分けて確認する | モデルごと、エンドポイントごとに入力・出力・キャッシュ読み取りのトークンを個別に記録する | 単価が数倍違うモデルが平均化されず、コストを追跡できる |
| プロモーション価格には終了日がある | 一部の新しいモデルには期間限定のプロモーション価格があり、期限後は公式の標準価格に変わる | 来月の予算を事前に見積もり、値上げで計画が乱されないようにできる |
新モデル接続の重点解説:ニュースのモデル名 ≠ 販売中のモデル名
接続の第一歩はコードを書くことではなく、販売中のモデルを確認することです。APIYI のモデル一覧表のアドレスは docs.apiyi.com/models.md で、本記事が参照したバージョンは 2026-11-19 10:59(UTC+8)に更新されています。ほかに機械可読な価格API https://api.apiyi.com/api/pricing があり、バージョン識別子は shell-api-modelmak-v1 です。両者の更新タイミングは同期しないことがあり、たとえば gemini-4-neon はこの版の一覧表にはまだ登場していませんが、価格APIには完全な価格フィールドがすでに存在します。そのため「呼び出せるかどうか」を判断する際は、一覧表と価格APIの両方を確認し、どちらかに記録があれば、小さなリクエストを一度送って確かめることをおすすめします。
逆のケースにも注意が必要です。MAI Image 2.7 は最近のニュースに出ている画像モデルですが、APIYI の現在の一覧表と価格APIには MAI-Image-2.6 と MAI-Image-2.6-Flash しかなく、2.7 はありません。つまり、MAI Image 2.7 はまだ販売されていません。このモデルはできるだけ早く販売開始する予定で、その際のモデル名と価格はプラットフォームのモデルリストを基準とします。また、Kling、Muse、gemini-4-flash-lite は現在、一覧表と価格APIのどちらにも見つかりません。プランを計画する際には、これらを含めないでください。

11月の新モデルと掲載状況の対照
以下の表では、11月のニュースで言及されたモデルと、2026-11-20 時点の掲載状況を一つずつ対応させています。表には資料から確認できる情報のみを記載し、確認できていない内容については推測していません。
| モデル | ニュース情報 | APIYI の掲載状況(2026-11-20) | モデルID |
|---|---|---|---|
| Gemini 4 Carbon | 2026-11-10 リリース、長期的で難度の高いタスク向け | 一覧表と料金APIで確認可能 | gemini-4-carbon |
| Gemini 4 Hydrogen | 2026-11-12 リリース、高速な日常向けグレード | 一覧表と料金APIで確認可能 | gemini-4-hydrogen |
| Gemini 4 Neon | 2026-11-18 リリース、能力は中間 | 料金APIには掲載済み、本版の一覧表には未掲載 | gemini-4-neon |
| Gemini 4 Argon | — | 一覧表で確認可能 | gemini-4-argon |
| MAI Image 2.7 | ニュースで言及された画像モデル | 未掲載、できるだけ早く掲載予定 | プラットフォームのリストを参照 |
| MAI Image 2.6 / 2.6 Flash | — | 確認可能、1回ごとの課金 | MAI-Image-2.6 / MAI-Image-2.6-Flash |
Gemini 4 の3グレードの位置づけは、次のように理解すれば簡単です。Carbon は長いワークフローや難度の高いタスクを重視し、Hydrogen は速度を追求して高頻度の日常呼び出しに適し、Neon はその中間に位置します。モデル選定では、まずタスクの難易度でグレードを選び、そのうえで価格を確認する。この順序のほうが、単純に最も安いものを選ぶより確実です。
11月の新モデルをすぐに使い始める:1つの入口でモデルを切り替える
最小限の例:2つのパラメータを変えるだけでモデルを切り替え
APIYI は OpenAI 互換インターフェースを提供しています。新しいモデルを接続する際、変更が必要になるのはほとんどの場合 base_url と model の2か所だけです。OpenAI 公式 Python SDK を例に、最小限の手順は次のとおりです。
- SDK をインストール:
pip install openai - クライアントを作成:
client = openai.OpenAI(api_key="YOUR_API_KEY", base_url="https://api.apiyi.com/v1") - 会話を開始:
client.chat.completions.create(model="gemini-4-hydrogen", messages=[{"role": "user", "content": "Hello!"}]) - 結果を取得:
response.choices[0].message.content
Hydrogen から Carbon に切り替えたい場合、model="gemini-4-hydrogen" を model="gemini-4-carbon" に変えるだけで、クライアント、認証、メッセージ構造はそのまま使えます。これが「1つの入口でモデルを切り替える」という意味です。モデルの変更は通常、モデル ID を変えてエンドポイントを確認するだけで済み、各社ごとに SDK を書き分ける必要はありません。
接続の全体像を見る(エンドポイントの切り替えとチャネル別の記録を含む)
実際のプロジェクトでは、「モデル ID → エンドポイント」のマッピングをコード内に散在させず、設定にまとめることをおすすめします。
1. 設定項目 `MODEL_ROUTES` を定義し、各レコードに `model`、`endpoint`、`price_key` の3つのフィールドを含めます。たとえば `gemini-4-neon` は `chat`、`claude-fable-5-2` は `messages`、`gpt-6.2-astra` は `responses` に対応します。
2. `call_model(model, prompt)` 関数をラップします。`endpoint` に応じて `client.chat.completions.create`、`client.responses.create` を呼び出すか、Anthropic SDK で Messages 形式のリクエストを送ります(base_url は上記と同じ)。
3. 各リクエストのレスポンスが返ったら、レスポンスの `usage` フィールドから入力、出力、キャッシュの token を読み取り、`model+endpoint` をチャネルキーとしてローカル台帳に書き込みます。
4. 毎日定期的に価格取得 API を1回リクエストし、`model_ratio`、`completion_ratio`、`cache_ratio` に基づいて単価を換算し、台帳の token 数と掛け合わせて、チャネルごとの推定費用を算出します。
5. 呼び出しに失敗した場合は `model` とエラーメッセージを記録します。モデルが存在しないというメッセージが出た場合は、まずモデル一覧を確認し直し、闇雲にリトライしないでください。
こうすれば、新しいモデルがリリースされた後は `MODEL_ROUTES` に1行設定を追加するだけで、ビジネスコードは変更不要です。
🚀 クイックスタートの提案:まず APIYI apiyi.com で登録し、新規ユーザー向けの無料テスト枠を受け取って、Hydrogen のような日常用途のモデルで一連の流れを動作確認し、その後 Neon、Carbon に切り替えて効果を比較しましょう。全体のプロセスで必要なのは1つの APIキーだけです。
新モデルのエンドポイント対応表:すべてのモデルを chat に詰め込むのはやめよう
「1つの入口」は「1つのエンドポイント」を意味しません。すでに呼び出せるテキストモデルは、それぞれサポートするエンドポイントが異なります。モデルを切り替える際は、この点を必ず確認してください。
| モデルシリーズ | モデル ID の例 | 利用可能なエンドポイント | 説明 |
|---|---|---|---|
| Gemini 4 シリーズ | gemini-4-carbon / gemini-4-neon / gemini-4-hydrogen |
chat または gemini | chat は OpenAI 互換の /v1/chat/completions、gemini は Gemini ネイティブ形式です。具体的なパスはプラットフォームのドキュメントに従ってください |
| Claude Fable 5.2 | claude-fable-5-2 / claude-fable-5-2-thinking |
chat または messages | messages は Anthropic スタイルの /v1/messages です |
| GPT-6.2 Astra | gpt-6.2-astra |
responses を推奨 | /v1/responses 経由を推奨します |
| MAI Image 2.6 | MAI-Image-2.6 / MAI-Image-2.6-Flash |
画像生成 | 1回ごとの課金です。呼び出し方法はプラットフォームのドキュメントに従ってください |
実際の運用では、チームに chat 形式ベースのコードが大量にある場合、Gemini と Claude はまず chat エンドポイントをそのまま利用でき、移行コストが最も低くなります。ベンダー固有のネイティブ機能が必要になったときに、gemini または messages エンドポイントへ切り替えてください。GPT-6.2 Astra は、直接 responses エンドポイントで接続することを推奨します。習慣に引っ張られて無理に chat に当てはめないようにしましょう。
11月の新モデル請求:チャネル別に見る
まずは料金インターフェースの読み方を学ぶ
APIYI の料金インターフェースは倍率で価格を表示します。換算ルールは次のとおりです。
- 入力単価 =
model_ratio × 2(単位:ドル/100万トークン、model_ratioが 1 のとき$2 / 1Mに相当) - 出力単価 = 入力単価 ×
completion_ratio - キャッシュ読み取り単価 = 入力単価 ×
cache_ratio
gemini-4-neon を例に見てみましょう。料金インターフェースでは model_ratio 1.5、completion_ratio 5、cache_ratio 0.05 が示されており、換算すると入力は $3 / 1M、出力は $15 / 1M、キャッシュ読み取りは $0.15 / 1M となり、Google の表示価格と一致します。この換算方法を覚えておけば、新しいモデルが登場したときも https://api.apiyi.com/api/pricing から自分で単価を計算できるので、記事の更新を待つ必要はありません。
各チャネルの価格対照(2026-11-20 時点で確認)

📊 データソースについて:上の図と下の表の価格は、APIYI(apiyi.com)のモデル一覧表と価格APIから取得しています。確認日は 2026-11-20 で、その後の変更はプラットフォームのリアルタイム一覧を優先してください。
| チャネル(モデル ID) | 入力 | キャッシュ読み込み | 出力 | 備考 |
|---|---|---|---|---|
gemini-4-hydrogen |
$1.5 / 1M |
$0.075 / 1M |
$7.5 / 1M |
日常向けの高速枠 |
gemini-4-carbon |
$2 / 1M |
$0.1 / 1M |
$10 / 1M |
Google の 2026-11-30 時点の導入価格に対応 |
gemini-4-argon |
$2 / 1M |
$0.1 / 1M |
$10 / 1M |
モデル一覧表から取得 |
gemini-4-neon |
$3 / 1M |
$0.15 / 1M |
$15 / 1M |
価格APIから取得 |
claude-fable-5-2 / -thinking |
$8 / 1M |
$0.2 / 1M |
$40 / 1M |
2つの ID は同一価格 |
gpt-6.2-astra(第1段階) |
$8 / 1M |
$0.4 / 1M |
$40 / 1M |
272000 token 超は下記参照 |
MAI-Image-2.6 |
1回あたり $0.12 |
— | — | 画像 |
MAI-Image-2.6-Flash |
1回あたり $0.06 |
— | — | 画像 |
この表には、個別に説明が必要な点が2つあります。
1つ目は GPT-6.2 Astra の長いコンテキストにおける段階料金です。モデル一覧表には、272000 token を超えると入力が $16 / 1M になると記載されています。価格APIではさらに、272000 token を超える場合の出力は $60 / 1M、キャッシュ読み込みは $0.8 / 1M で計算されると示されています。非常に長いコンテキストを詰め込む業務がある場合は、必ず段階ごとに分けて見積もり、第1段階の価格をすべてのリクエストに当てはめないようにしてください。
2つ目は Gemini 4 Carbon の導入価格です。現在の価格は Google の 2026-11-30 までの導入価格に対応しており、Google の 12 月 1 日以降の標準価格は入力 $4 / 1M、出力 $20 / 1M です。プラットフォームの今後の価格は APIYI のモデル一覧を基準としますので、12 月の予算を立てる際はこの差額分をあらかじめ見込んでおくことをおすすめします。
なぜ1社の単価だけでは全体を語れないのか
上表から分かるように、同じ100万トークンの出力でも、Hydrogen は $7.5、Claude Fable 5.2 と GPT-6.2 Astra の最初のティアは $40 で、5倍以上の差があります。チームが同時に3つや4つのモデルを動かしている場合、1つの「平均単価」や特定の1社の単価だけを見ていると、コストを大幅に過小評価したり過大評価したりしやすくなります。より確実な方法は、「モデルID+エンドポイント」をチャネルキーとし、チャネルごとに入力・出力・キャッシュ読み取りのトークンを個別に記録し、それぞれの単価を掛けてから最後に合計することです。
また、統一エントリポイントが解決するのは接続コストであり、すべてのモデルが必ず安くなるという意味ではない点にも注意が必要です。上表にある複数の Gemini 4 モデルの価格は Google の定価と同じです。お得かどうかは、一概に判断するのではなく、チャネルごとに実際の利用量と比較して評価すべきです。
💰 コストのヒント:モデル選定の比較を行う際は、APIYI apiyi.com で同じテストサンプル群を使って Hydrogen、Neon、Carbon をそれぞれ呼び出し、チャネルごとにトークン消費量を記録して、各チャネルの実際の1回あたりのコストを算出し、そのうえでメインモデルを決めるとよいでしょう。
よくある質問 FAQ
Q1:「1つの入口でモデルを切り替える」とはどういう意味ですか?
すべてのモデルが同じ base_url と同一の APIキーを共有するという意味です。モデルを切り替えるときは `model` パラメータのモデルIDを変更し、そのモデルが対応するエンドポイントを確認してください。ベンダーごとに個別登録したり、SDKを個別に導入したりする必要はありません。
Q2:ニュースで発表されたばかりのモデルは、そのまま呼び出せますか?
必ずしもそうとは限りません。発表とラインナップへの追加は別の話です。2026-11-20 を例にすると、MAI Image 2.7 はニュースにのみ登場しており、APIYI のラインナップには `MAI-Image-2.6` と `MAI-Image-2.6-Flash` しかありません。2.7 はまだ追加されておらず、できるだけ早く追加予定です。呼び出し前にはモデル総表と価格APIを確認し、モデルIDが存在することを確かめてから接続してください。
Q3:Gemini 4 の Carbon、Hydrogen、Neon はどう選べばよいですか?
タスクの難易度でグレードを選びます。長い連鎖を伴う高難度タスクには Carbon、高頻度で速度重視の日常的な呼び出しには Hydrogen、その中間は Neon です。3モデルはそれぞれ11月10日、12日、18日にリリースされ、価格も異なります。同じサンプル群で比較したうえで主力モデルを決めるとよいでしょう。
Q4:総表に gemini-4-neon が見つからない場合、まだ使えないのでしょうか?
総表だけで判断しないでください。2026-11-19 版の総表には `gemini-4-neon` がありませんが、価格APIでは完全な倍率が提供されており、換算すると入力 `$3 / 1M`、出力 `$15 / 1M`、キャッシュ読み取り `$0.15 / 1M` です。2つの情報には時間差があるため、価格APIと実際の少額テスト結果を優先してください。
Q5:これら11月の新モデルを API 経由で素早く呼び出すには?
次の手順で操作することをおすすめします:
1. APIYI(apiyi.com)でアカウントを登録し、APIキーと新規ユーザー向けの無料テスト枠を取得
2. モデル総表と価格APIを確認し、目的のモデルIDを特定
3. base_url をプラットフォームの OpenAI 互換アドレスに設定し、上記のエンドポイント対照表に従って chat、messages、responses、gemini を選ぶ
4. まず短いリクエストを送り、利用可能であることを確認してから業務に接続
Q6:同じ Claude Fable 5.2 でも、chat 経由と messages 経由で価格は違うのでしょうか?
参考資料では `claude-fable-5-2` と `claude-fable-5-2-thinking` の価格は同じで、いずれも入力 `$8 / 1M`、キャッシュ読み取り `$0.2 / 1M`、出力 `$40 / 1M` です。資料にはエンドポイント別の価格設定はありません。ただし記録時には、エンドポイントをチャネルキーの一部として扱うことをおすすめします。問題の切り分けや後日の照合がしやすくなります。
Q7:統一入口は必ず公式直結より安いのでしょうか?
そう断言はできません。統一入口の主な価値は、接続するインターフェースを減らし、認証と課金の入口を統一できることです。価格はチャネルごとに確認する必要があり、たとえば `gemini-4-neon` の価格は Google の表示価格と一致しています。より安くなるかどうかは、利用するモデルの組み合わせと使用量によって決まります。チャネルごとに自分でコストを計算してください。
Q8:事前に計画しておくべき既知の制限はありますか?
主に3点です。第一に、一部の新型モデルはまだ追加されておらず、たとえば MAI Image 2.7、Kling、Muse、`gemini-4-flash-lite` は現在確認できません。第二に、紹介価格には期限があり、Gemini 4 Carbon に対応する Google の紹介価格は11月30日までです。第三に、GPT-6.2 Astra は 272000 トークンを超えると段階的な課金になります。こうした状況に直面したときは、まずプラットフォームのリストに合わせて計画を調整し、その後コードを修正してください。
11月の新モデル接続 核心ポイント Key Takeaways
- まずモデル棚卸し、それからコード:モデル一覧表と価格APIを基準にします。ニュースで報じられた型番と、実際に呼び出せる型番は分けて記録しましょう
- 型番の切り替えは2か所だけ:同じ base_url の下でモデルIDを変更し、そのうえでエンドポイント種別を確認します
- エンドポイントは正しく対応付ける:Gemini は chat または gemini、Claude は chat または messages、GPT-6.2 Astra は responses がおすすめです
- 倍率が読めれば価格も計算できる:
model_ratio × 2が入力単価で、これに出力・キャッシュの倍率を掛けます - 請求はチャネルごとに分ける:「モデルID+エンドポイント」をキーにして個別に記録します。1つの単価をすべてに当てはめるのは避けましょう
- 期限と段階制に注意:Carbon の紹介価格、Astra の 272000 token 段階はいずれも予算に影響します
- 導入の進め方:APIYI で1つのキーから無料枠を受け取り、まずは日常ユースのモデルで動かし、その後横並びで比較します
まとめ:11月は新モデルが集中、1つの入口で型番を切り替え、請求はチャネルごとに確認
11月のように新モデルが集中する時期に大切なのは、ニュースを1本ずつ追いかけることではなく、決まった手順を確立することです。
- 型番リストと照合する:一覧表と価格APIの両方を確認します。ニュースに出ている MAI Image 2.7 はまだ提供が始まっていないため、リリース計画には書き込まないようにしましょう。
- モデルIDを変え、エンドポイントを確認する:1つの base_url で複数ベンダーのモデルを扱えます。エンドポイント対応表に従って chat、messages、responses、gemini を選びます。
- 請求はチャネルごとに見る:モデルごと、エンドポイントごとに token と費用を個別に計算し、あわせて紹介価格の期限や長いコンテキストの段階制にも気を配ります。
この流れを一度固めてしまえば、次に新しいモデルが公開されたときは、設定にモデルIDを1行追加し、価格APIを一度確認するだけで、接続とコスト評価が完了します。APIYI(apiyi.com)の新規ユーザー向け無料枠でまず1つのチャネルを通し、そこから Gemini 4、Claude Fable 5.2、GPT-6.2 Astra を順に比較対象へ加えていくのがおすすめです。
📚 参考資料
-
Google 公式ブログ – Gemini 4 Neon 公開のお知らせ:Gemini 4 シリーズのモデル紹介
- リンク:
blog.google/innovation-and-ai/models-and-research/gemini-models/introducing-gemini-4-neon - 説明:Carbon、Hydrogen、Neon の位置づけと公開時期を確認するための資料です
- リンク:
-
APIYI モデル総合表と料金インターフェース:モデルと価格を照合する際の参照元
- リンク:本文「ニュースのモデル名 ≠ 販売中のモデル名」の節を参照
- 説明:総合表と料金インターフェースはバージョンが同期していない可能性があるため、2か所を見比べて確認することをおすすめします
作者: APIYI 技術チーム
技術交流:APIYI のウェブサイトトップページからお気軽にお問い合わせください。その他の接続ドキュメントは docs.apiyi.com ドキュメントセンターでご覧いただけます
