著者注:新しいモデルが集中してリリースされるときは、まず型番が掲載されているかを確認します。掲載済みであればモデルIDを変えるだけです。切り替える前に価格・エンドポイント・グループを突き合わせます。同じ鍵1本でテストを完結できるので、ベンダーごとにアカウントを開く必要はありません。
2026-11-09、Anthropic は Claude Fable 5.2 をリリースしました。その1週間後の 2026-11-16、Alibaba Cloud は Qwen4-Max をモデル掲載リストに登録しました。新しいモデルをアプリに組み込もうとする開発者にとって、難所はたいてい呼び出しコードではなくプロセスにあります。新しいモデルが出るたびに、アカウント登録、APIキーの申請、支払い方法の紐付け、そして設定の書き換えをもう一度やらなければならないからです。本記事では 1本の鍵でモデルIDを切り替える3ステップのテスト手法 を紹介します。同じ呼び出しセットのまま、すでに掲載されている型番をまずテストできるようになります。
これは発表会の焼き直し記事ではありません。本文中の型番と価格は、APIYI(apiyi.com)の型番総合表(ページにはデータ更新日時が 2026-11-16 09:39、UTC+8、出典はシステムのリアルタイム価格インターフェースと明記されています)および各ベンダーのドキュメントに基づいています。独自のベンチマークスコアは提示せず、テスト前に何を確認し、何を変更し、何を突き合わせるべきかだけを説明します。
核心的な価値:本記事を読み終えれば、環境変数に入れた同じ1本の鍵で claude-fable-5-2 と Qwen シリーズの間を切り替えてテストでき、切り替え前に今回のモデル変更が請求にどう影響するかをはっきり確認できます。

新モデルの検証方法:1つのAPIキーでモデルIDを切り替える際の核心ポイント
新しいモデルが次々と登場する中で、最もよくある失敗はコードではなく、「このモデルが本当に呼び出せるのか、どの料金で課金されるのか」を確認しないまま model を書き換えてしまうことです。以下の表は3ステップ検証の骨格で、この後は各項目を順に解説します。
| ステップ | やること | なぜ必要か |
|---|---|---|
| ① 一覧表と料金APIを確認 | モデル一覧表と料金APIで目的のモデルIDを検索 | まず提供中かどうかを確認し、価格はこの行を基準にする |
② 提供中のモデルは model だけ変更 |
base_url とAPIキーはそのまま、model フィールドのみ置き換え |
同じ呼び出し方法で複数のモデルをカバーできる |
| ③ グループ・エンドポイント・キャッシュ読み取りを確認 | 入力価格、出力価格、キャッシュ読み取り、エンドポイント、グループを突き合わせ | モデルを変えると課金が変わり、呼び出しプロトコルも変わる可能性がある |
1つのAPIキーでモデルIDを切り替えられる理由
APIYIのトークンに関するドキュメントには次のように記載されています。トークンにモデルのホワイトリストを設定していない場合は、サイト全体の200以上ある厳選モデルを利用できます。ホワイトリストを設定した場合は、指定したモデルしか呼び出せません。つまり「1つのAPIキーでモデルを切り替える」には前提があります。使用中のトークンが、目的のモデルをホワイトリストの外に締め出していないことです。プロジェクトごとに分離する運用が習慣になっている方も安心してください。ドキュメントでは、プロジェクト別に独立したトークンを作成し、それぞれのクォータ・有効期限・ログを確認できることも説明されています。
もう1つ見落としやすいのがグループという概念です。ドキュメントの説明によれば、グループはリソースチャネルであり、モデルによって必要なグループが異なる場合があります。1つのトークンには最大1つのデフォルトグループと2つのフォールバックグループを設定でき、迷ったときは Default を使います。つまり、モデルIDを切り替えた後に呼び出しが通るかどうかは、そのモデルが提供中かどうかに加えて、そのモデルが属するグループがトークンのグループ設定をカバーしているかも確認する必要があります。

新モデルのテスト手順その1:モデル総表と価格APIを確認する
コードを変更する前に、まず2つの照会を行います。1つはモデル総表 docs.apiyi.com/models.md、もう1つは価格API https://api.apiyi.com/api/pricing です。総表は人間が閲覧して価格比較するのに向いており、価格APIはスクリプトに組み込むのに適しており、CIや設定センターで「この model は価格表に存在するか」を自動検証できます。両方の結論が一致してから、次のステップに進みます。
今週の2つの新モデルを例にすると、照会結果には大きな差があります:
| モデルID | ベンダーの発表状況 | APIYIモデル総表 | 2026-11-17 価格API | テスト推奨 |
|---|---|---|---|---|
claude-fable-5-2 |
Anthropic 2026-11-09 発表 | 掲載あり(別途 claude-fable-5-2-thinking あり) |
あり | model を直接変更してテスト |
qwen4-max |
アリババクラウド 2026-11-16 に上架を記録 | アリババのセクションにはなし | レスポンスに qwen4 なし | まず近いモデルでリンクを疎通させる |
qwen3.8-max |
既存モデル | 掲載あり | あり | Qwenリンクの代替テスト対象として |
もう1つ注意すべき細かい点があります。claude-fable-5-2 はAPIYIのドキュメントに単独のモデル説明ページがなく、対応するURLは404を返します。そのため、価格は総表のこの行のみを根拠とし、他の場所から寄せ集めてはいけません。
🎯 技術的な推奨:「価格APIを確認する」をリリース前のチェック工程にしましょう。設定に新しい model 文字列が現れたら、まずスクリプトでAPIYI apiyi.com の価格APIにリクエストして存在を確認すれば、リリース後に「モデルが存在しません」というエラーを受け取る事態を避けられます。
Claude Fable 5.2 が提供開始:モデルIDを変えるだけで試せます
Anthropic の 2026-11-09 の発表によると、開発者向けのモデルIDは claude-fable-5-2 です。発表では、生成速度が Fable 5.1 より最大 30% 高速で、公式価格は 100万トークンあたり入力 $8、出力 $40 とされています。公式にはオプションの fast mode も用意されており、価格は入力 $16、出力 $80 です。APIYI の一覧表には fast mode の行がないため、fast mode を前提とした設定を書かないようにしてください。
同じ発表では、Fable と Mythos が同じベースを共有していることも説明されています。Fable はすべてのユーザーに開放されていますが、Mythos はライフサイエンスまたはサイバーセキュリティの検証プログラムを通過する必要があります。Anthropic のモデル一覧における現在のモデルは Claude Fable 5.2、Claude Opus 5.5、Claude Sonnet 5.5、Claude Haiku 5.5、そして検証が必要な Mythos 5.2 であり、Fable 5.5 という名前のモデルは存在しません。発表の推奨は次のとおりです。多くのコーディングや知識系タスクはまず Claude Opus 5.5 から始め、不足する場合に Fable へ上げ、より軽いタスクなら Sonnet 5.5 または Haiku 5.5 を使う、という方針です。
APIYI では、claude-fable-5-2 と claude-fable-5-2-thinking はいずれもテキストおよび従量課金制で、入力 $8、出力 $40、キャッシュ読み取り $0.2(100万トークンあたり)です。エンドポイントは chat と messages の両方に対応し、グループは ClaudeCode、Claude_Enterprise、Default、SVIP です。この価格はこれら2つの Fable モデルにのみ適用され、他の Claude モデルの価格を示すものではありません。
Qwen4-Max の検証方法:まずは公開済みの qwen3.8-max で Qwen の呼び出し経路を通す
まずはベンダー側の情報から見ていきましょう。Alibaba Cloud のモデルページに記載されている呼び出し ID は qwen4-max です。入力はテキスト・画像・動画に対応し、出力はテキスト、コンテキスト長は 1,000,000。最大入力 991,808、最大出力 131,072。思考モードでは最大入力 983,616、最大出力 262,144、最大思考連鎖 262,144 となっています。ツール呼び出し、構造化出力、明示的キャッシュ、暗黙的キャッシュに対応し、OpenAI Chat Completions、Responses、Anthropic Messages と互換性がありますが、バッチ推論とモデルチューニングには対応していません。Alibaba Cloud の「モデルの公開と更新」ページでは 2026-11-16 に記録されており、サービス展開の範囲は中国本土です。
価格は出典ごと、通貨ごとに分けて見る必要があり、一つの数値にまとめることはできません。Alibaba Cloud 百炼(Bailian)のモデルページの原文には人民元建ての価格が記載されています。非思考モードと思考モードは同じ価格帯で、中国本土および「グローバル」展開では 100 万トークンあたり入力 10 元、出力 30 元、海外展開では入力 10.938 元、出力 32.813 元です。同じページには 100 万トークンの無料枠も記載されており、有効期間は百炼の開通日、モデルの公開日、申請の承認日のうち最も遅い日から 90 日間です。これは百炼の提示価格と百炼の枠であり、APIYI とは関係ありません。一方、Qwen 公式アカウントの 2026-11-16 の投稿では、別のドル建て価格が示されています。入力 $1.5、出力 $4.5、暗黙的キャッシュ $0.075(100 万トークンあたり)で、API は QwenCloud で提供される旨が説明されています。APIYI では qwen4-max はまだ公開されておらず、できるだけ早く追加する予定です。モデルと価格はプラットフォームのモデル一覧を基準にしてください。
というわけで、Qwen 系の進め方はこうです。まず一覧表にすでにある qwen3.8-max を使って、呼び出し経路、プロンプトテンプレート、パースロジック、課金監視までを一通り動作させます。APIYI での価格は入力 $1.65、出力 $4.95、キャッシュ読み取り $0.20625(100 万トークンあたり)で、エンドポイントは chat と messages、グループは ClaudeCode、Default、SVIP です。qwen4-max が価格 API に現れたら、通常やることは model を書き換えて、ステップ 3 の手順でもう一度確認するだけです。
たった1つのAPIキーでモデルIDを切り替えるクイックスタート
以下ではインラインコードを使って最小構成を説明します。すべての操作で使うAPIキーは1つだけです。
- APIキーは環境変数に置く:たとえば
export APIYI_API_KEY=你的密钥とします。APIキーをリポジトリに書いたり、設定ファイルにコミットしたりしないでください。 - クライアントの初期化は1回だけ:Pythonでは
client = OpenAI(api_key=os.environ["APIYI_API_KEY"], base_url="https://api.apiyi.com/v1")と書けます。対応するChat Completionsのパスは/v1/chat/completionsです。 - モデルIDは設定項目にする:たとえば
MODEL=claude-fable-5-2とし、呼び出し時にはclient.chat.completions.create(model=os.environ["MODEL"], messages=[...])と書きます。 - 切り替えテストでは1か所だけ変更する:
MODELをqwen3.8-maxに変えて同じテストケースを再実行します。base_url、APIキー、メッセージ構造はそのままです。 - 各リクエストのmodelフィールドを記録する:ログに今回使用したモデルIDを明確に記録しておけば、後でコストをモデル別に分解して照合できます。
この方法の利点は、比較テストの変数がモデルそのものだけになることです。同じプロンプト群、同じ解析コードのまま、文字列を1つ変えるだけで異なるモデルの出力差を確認できます。結果をそのまま評価表に取り込めるのも便利です。
🚀 クイックスタート:APIキーをまだお持ちでない場合は、APIYI apiyi.com で登録できます。新規ユーザーには無料のテスト枠が用意されています。「新モデル評価」専用の独立したトークンを先に作成することをおすすめします。利用枠、有効期限、ログを本番環境と分けて管理できます。
モデル ID を切り替える前のステップ3:グループ・エンドポイント・キャッシュ読みを照合する
model フィールドの変更は簡単ですが、それによって2つのことが静かに変わってしまう可能性があります。それが請求額とプロトコルです。以下のチェックリストは、切り替えのたびに一通り確認することをおすすめします:
| 確認項目 | どこを見るか | よくある落とし穴 |
|---|---|---|
| 入力価格 / 出力価格 | 型番総表の該当行 | 同じベンダーでも型番によって価格差が大きく、「同シリーズ」として見積もることはできません |
| キャッシュ読み価格 | 総表のキャッシュ読み列 | 長いシステムプロンプトを使う場面では、キャッシュ読み価格がコストに直接影響します |
| エンドポイント | 総表のエンドポイント列(chat / messages) | コードが /v1/chat/completions を通る場合は、その型番が chat に対応していることを確認する必要があります |
| グループ | 総表のグループ列 + トークンのグループ設定 | モデルによって必要なグループが異なる場合があるため、すべてが Default だと思い込まないこと |
| ホワイトリスト | トークン設定 | トークンにホワイトリストを設定している場合、新しいモデル ID を追加していなければ拒否されます |
今回の2つの型番を並べて見ると、違いがよりはっきりします:

| モデル ID | 価格の出典 | 入力 | 出力 | キャッシュ読み | エンドポイント | 利用可能プラットフォーム |
|---|---|---|---|---|---|---|
claude-fable-5-2 |
APIYI総表 | $8 | $40 | $0.2 | chat、messages | APIYI apiyi.com、Anthropic 公式 |
qwen3.8-max |
APIYI総表 | $1.65 | $4.95 | $0.20625 | chat、messages | APIYI |
qwen4-max |
百煉の型番ページ原文(中国本土 / グローバル) | 10 元 | 30 元 | — | ベンダー側は複数のプロトコルに対応 | Alibaba Cloud 百煉 |
qwen4-max |
Qwen 公式投稿の記述 | $1.5 | $4.5 | 暗黙的キャッシュ $0.075 | — | QwenCloud |
表の価格単位はすべて100万 token あたりです。ドル価格と人民元価格は出典が異なるため、別々に理解してください。換算して合計したり、直接比較したりしないでください。グループも同様に1つずつ確認が必要です:claude-fable-5-2 には Claude_Enterprise グループがありますが、qwen3.8-max にはありません。トークンのデフォルトグループが Claude_Enterprise の場合、Qwen に切り替える際は、そのモデルが属するグループをフォールバックグループに含めておく必要があります。
💡 選択のアドバイス:評価フェーズでは、トークンのデフォルトグループを Default に設定し、テスト対象の型番をカバーする1〜2個のフォールバックグループを用意することをおすすめします。各型番がどのグループに属するかは、APIYI の型番総表を基準にしてください。
よくある質問(FAQ)
Q1:「1本のキーでモデルIDを差し替える」とは具体的に何を指しますか?
base_url、キー、リクエスト構造はそのままにして、`model` フィールドだけを置き換えてモデルを切り替える、という意味です。前提として、対象モデルがすでにプラットフォーム上に登録されており、トークンのホワイトリストでブロックされておらず、所属グループが利用可能である必要があります。
Q2:qwen4-max は今すぐ試せますか?
2026-11-17 時点では、APIYIのモデル一覧表にも価格APIにも `qwen4-max` は掲載されていません。まずは `qwen3.8-max` でQwenの経路を動作確認し、その後は定期的に APIYI apiyi.com の価格APIへ問い合わせて、掲載されたことを確認してから model を切り替えるのがおすすめです。
Q3:百煉の100万トークン無料枠はAPIYIで使えますか?
使えません。それは阿里雲百煉のモデルページに記載されている百煉側の枠であり、百煉でのみ有効です。APIYIには独自の新規ユーザー向け無料テスト枠があり、この2つは別物です。
Q4:Claude Fable 5.2 の fast mode はAPIYI経由で呼び出せますか?
APIYIの一覧表に fast mode の行はなく、提供中なのは `claude-fable-5-2` と `claude-fable-5-2-thinking` です。fast mode の $16 / $80 は Anthropic の公式価格です。
Q5:model を変更したらエラーが出た場合、まず何を確認すべきですか?
次の順に確認してください。モデルが一覧表に載っているか、トークンのホワイトリストに含まれているか、トークンのグループがそのモデルのグループをカバーしているか、エンドポイントが利用するパスに対応しているか。自分で判断できない場合は、APIYI apiyi.com で該当トークンの呼び出しログを確認し、どの項目で拒否されたかを特定できます。
Q6:すべてのモデルで Default グループだけを使えますか?
その前提で考えることはできません。ドキュメントでは不確かな場合に Default を使うことを推奨しつつ、モデルによって必要なグループが異なる場合があるとも明記しています。各モデルのグループは一覧表に従い、必要に応じてフォールバック用のグループを設定してください。
新モデルのテスト方法:1本のキーでモデルIDを切り替える
主なポイント(Key Takeaways)
- まず確認してから変更:モデル一覧表と価格APIの両方で対象IDを確認してから、設定に手を加えます。
- 変更するのは model だけ:すでに稼働中のモデルでは、base_url とAPIキーはそのままにします。
- Fable の価格は別扱い:
claude-fable-5-2の $8 / $40 / キャッシュ読み込み $0.2 は、他の Claude モデルには当てはまりません。 - Qwen はまず旧経路で実行:
qwen3.8-maxでフローを検証し、qwen4-maxが公開されてから切り替えます。 - 通貨は分けて読む:百炼(Bailian)の人民元価格と Qwen の投稿にある米ドル価格は出所が異なるため、1つの数値にまとめないでください。
- グループは1つずつ確認:トークンは最大でデフォルトグループ1つにフォールバックグループ2つであり、すべてが Default にあると決め込まないでください。
まとめ
新しいモデルが一斉に登場するとき、テストの効率を左右するのは「いくつのアカウントを開いたか」ではなく「どんな手順で進めるか」です。
- 一覧表と価格APIを確認:モデルが稼働中であることを確かめ、価格は一覧表の該当行を基準にします。
- 稼働中は model だけ変更:同じキー、同じ呼び出し方法で、複数のベンダーのモデルをカバーできます。
- グループ・エンドポイント・キャッシュ読み込みを確認:モデルを変えると請求内容が変わり、プロトコルが変わることもあるため、切り替え前に項目ごとにチェックします。
今週の状況はまさに2つの経路に対応しています。claude-fable-5-2 はそのままテストでき、Qwen はまず qwen3.8-max で経路を通します。APIYI apiyi.com 経由で1本のキーを使ってこのテストを完了し、その分の労力をモデル自体の評価に残すのがおすすめです。
📚 参考資料
-
APIYI モデル一覧表:価格・エンドポイント・グループを照合する際の根拠
- リンク:
docs.apiyi.com/models.md - 説明:データの更新日時は 2026-11-16 09:39(UTC+8)と記載されており、出典はシステムのリアルタイム価格インターフェースです
- リンク:
-
APIYI のトークンとグループの説明:ホワイトリスト、独立トークン、デフォルトグループとフォールバックグループ
- リンク:
docs.apiyi.com/faq/token-and-groups.md - 説明:「1つのAPIキーでモデルを切り替える」ための前提条件を解説しています
- リンク:
-
Anthropic Claude Fable および Mythos 5.2 の発表:モデルID、公式価格、fast mode
- リンク:
anthropic.com/claude-fable-and-mythos-5-2 - 説明:Mythos の検証要件とモデル選定の推奨事項を掲載しています
- リンク:
-
Anthropic モデル概要:現在の Claude モデル一覧
- リンク:
platform.claude.com/docs/en/about-claude/models/overview - 説明:既存のモデル名を確認できます
- リンク:
-
Alibaba Cloud 百炼(Model Studio)Qwen4-Max モデルページ:仕様、人民元建て価格、百炼の無料枠
- リンク:
help.aliyun.com/zh/model-studio/qwen4-max - 説明:価格と無料枠は百炼ドキュメントの原文です
- リンク:
-
Alibaba Cloud モデルの提供開始と更新:qwen4-max の提供開始日と展開範囲
- リンク:
help.aliyun.com/zh/model-studio/newly-released-models - 説明:記録日時は 2026-11-16
- リンク:
-
Qwen 公式ブログと公式アカウントの投稿:ドル建て価格の記述と QwenCloud
- リンク:
qwen.ai/blog?id=qwen4-max - 説明:ドル建て価格は公式による記述であり、百炼の人民元建て価格とは分けて見る必要があります
- リンク:
作者:APIYI 技術チーム
技術交流:APIYI 公式サイトのトップページからお問い合わせください。そのほかのモデルやグループの説明については、ドキュメントセンターをご覧ください。
