CometAPI の Auto API とは？
CometAPI Auto API は、各リクエストごとに固定のモデル名を指定しなくても、適切な AI モデルへ自動でルーティングできるインテリジェントなモデルルーティング用エンドポイントです。GPT、Claude、Gemini などの個別モデルを選ぶ代わりに、model=auto を指定すると、CometAPI がリクエストの特性と要件に基づいて適切なモデルを自動的に選択します。
より高い応答品質を重視するワークロードでは、auto-high を使用できます。auto と auto-high はいずれも固定の AI モデルではなく、ルーティングオプションです。
このアプローチにより、アプリケーション側は一貫した API を利用しつつ、モデル選択は CometAPI が裏側で処理します。
Auto API のパラメータと仕様
Auto API は、対応する CometAPI エンドポイントがサポートする API リクエスト構造と同一の形式を使用します。主な違いは model パラメータの値です。
| Parameter | Type | Description |
|---|---|---|
| model | string | auto または auto-high を指定 |
| messages | array | 会話メッセージ |
| stream | boolean | サポートされている場合はストリーミングを有効化 |
| tools | array | ツール定義 |
| response_format | object | 構造化出力の設定 |
| Image input | object/array | サポートされている場合の画像コンテンツ |
| File input | object/array | サポートされている場合のファイルコンテンツ |
| Reasoning parameters | object/string | 選択されたモデルがサポートする推論関連の設定 |
Auto API はどのように機能しますか？
リクエストが model=auto または model=auto-high を使用する場合、CometAPI はまずリクエストの特性を評価します。特性には、クライアント種別、画像やファイルの有無、推定入力長、ツールの使用、構造化出力の要件、ストリーミング、推論関連パラメータなどが含まれます。
これらの特性に基づいて、リクエストは適切なルーティングシナリオにマッチングされます。CometAPI はその後、設定された品質レベル、モデルの可用性、優先度、重み、ユーザーグループの権限、機能、価格、チャネルの可用性に応じて、対応するモデルプールから適格なモデルを選択します。
モデルが選択されると、リクエストは CometAPI の通常のチャネルルーティングシステムを通過します。したがって、Auto ルーティングは「どのモデルがリクエストを処理すべきか」を決定し、チャネルルーティングは「どの利用可能なプロバイダチャネルがそのモデルリクエストを処理するか」を決定します。
Auto ルーティングはチャネルを自動作成したり、既存のチャネル設定を迂回したりしません。モデルは、リクエストを正常に処理するために必要な価格設定とチャネルルートの構成を備えている必要があります。
そのため、API レスポンスで返される model は、リクエストで指定したモデルと異なる場合があります。たとえば、model=auto を使用したリクエストでは、model フィールドに実際のモデル名が返されることがあります。これは想定どおりの動作であり、ルーターによって最終的に選択されたモデルを示します。
Auto と Auto-High の違いは？
auto と auto-high は同じインテリジェントルーティングの概念を用いますが、狙う品質レベルが異なります。
Auto は汎用のルーティングオプションです。応答品質、コスト、速度、可用性のバランスを現実的に最適化することを意図しており、日常的なほとんどのアプリケーションでのデフォルト選択として適しています。
Auto-High は、より強力なモデルと高品質な応答を重視するユーザー向けに設計されています。複雑な推論、高度なコーディング、詳細分析など、品質重視のワークロードに適しています。
auto-high は、すべてのリクエストが特定のプレミアムモデル 1 つに送られることを意味しません。auto と同様に、リクエストの特性に応じて、設定済みの高品質モデルプールから動的にモデルを選択します。
| Feature | auto | auto-high |
|---|---|---|
| Purpose | 汎用の自動ルーティング | より高品質な自動ルーティング |
| Model selection | 自動 | 自動 |
| Fixed model | いいえ | いいえ |
| Primary focus | コスト・速度・可用性・機能のバランス | 高品質モデルの選択 |
| Best for | 一般的な本番ワークロード | 複雑または品質重視のワークロード |
| Model can vary | はい | はい |
要するに、バランスの取れたデフォルトが欲しい場合は auto、応答品質をより重視する場合は auto-high を使用してください。
ユースケース
一般的な AI アプリケーション
Auto は、チャットボット、コンテンツ生成、要約、分類、カスタマーサポートなどの汎用 AI アプリケーションに便利です。開発者は、毎回固定のモデル選択戦略を維持する必要がありません。
コーディングと開発
コーディング系のアプリケーションは Auto ルーティングの恩恵を受けられます。コーディング関連のリクエストは、ソフトウェアエンジニアリングタスク用に構成されたモデルへ振り向けられます。これは、コーディングアシスタント、IDE 連携、コード生成、デバッグ、コードレビュー、開発エージェントに有用です。
複雑な分析と推論
auto-high は、モデルコストの最小化よりも応答品質を重視するタスクに適しています。例として、技術分析、複雑な推論、リサーチタスク、詳細なドキュメント分析、高度なエージェントワークフローなどが挙げられます。
マルチモーダルアプリケーション
構成されたルーティングルールと候補モデルがサポートしている場合、Auto は画像やファイルを含むリクエストを、それらを処理可能なモデルへルーティングできます。
高ボリュームのアプリケーション
多様な種類のリクエストを大量に処理するアプリケーションにも Auto は有用です。アプリケーションコード内にモデル選択ロジックを実装・維持する代わりに、CometAPI による集中管理のモデル選択を利用できます。
Auto API の制限事項は？
Auto は、すべてのリクエストが同一モデルで処理されることを保証しません。モデル選択は動的であるため、ルーティング条件や設定の変化に伴い、基盤となるモデルは変わり得ます。
また、Auto は最安値を保証するものではありません。最も安価なモデルを選ぶのではなく、インテリジェントなモデル選択を目的としています。
もう 1 つの制限として、モデル固有の機能は異なる場合があります。モデルによって、コンテキスト長、ツール、画像入力、構造化出力、その他の機能のサポート状況が異なります。そのため、Auto は候補モデルの機能情報が正確に設定されている場合に最も効果的です。
最後に、モデルが選択されたからといって、リクエストが必ず成功する保証はありません。選択されたモデルには、対象ユーザーグループ向けの利用可能なチャネルルートが必要です。適切なチャネルが利用できない場合、Auto がモデルを正常に特定しても、リクエストは失敗する可能性があります。
Auto は異なるタイプのリクエストをどのように扱いますか？
Auto の主な利点は、開発者が一般的なリクエストタイプごとに個別のモデル選択ロジックを手動で維持する必要がないことです。
通常のテキストリクエストはデフォルトのモデルプールで処理できます。コーディングリクエストはコーディング指向のモデルプールに振り向けられます。大きなコンテキストが必要なリクエストは、必要な入力サイズをサポートするモデルにマッチングされます。画像リクエストは、ビジョン機能を備えたモデルにルーティングできます。
これにより、同じ API エンドポイントで異なるアプリケーションシナリオをサポートしつつ、クライアント側の実装をシンプルに保てます。
CometAPI Auto API を使う利点は？
Auto の主な利点は、アプリケーションロジックをモデル選択ロジックから分離できることです。
自動ルーティングがない場合、開発者は各リクエストをどのモデルで処理するかを判断し、モデルが利用不能、高コスト、特定のワークロードに不向きになった際のフォールバック戦略を維持する必要があります。
Auto を使えば、アプリケーションは安定したルーティング識別子を使用しつつ、基盤のモデル戦略は中央管理で運用できます。
このアプローチは、マルチモデルのアプリケーションを簡素化し、モデル変更のデプロイを容易にし、アプリケーション内で維持すべきモデル固有のルーティングロジックを減らせます。
複数の AI プロバイダを利用し、モデル機能が急速に変化するチームにとって、この抽象化は特に有用です。
Auto API と特定モデルの比較
| Feature | Auto | Specific Model |
|---|---|---|
| Automatic model selection | はい | いいえ |
| Fixed model identity | いいえ | はい |
| Application simplicity | 高い | 中程度 |
| Model control | 低い | 高い |
| Flexibility | 高い | 低い |
| Predictability | 低い | 高い |
| Suitable for mixed workloads | はい | モデルによる |
| Suitable for reproducible testing | 限定的 | はい |
| Best for | 動的な本番ワークロード | モデル特化のアプリケーション |
CometAPI Auto API の使い方
CometAPI Auto API は、OpenAI 互換の Chat Completions API で動作するよう設計されています。特定の基盤モデルを選ぶ必要はありません。model パラメータに auto または auto-high を設定すると、CometAPI がリクエストに基づいて適切なモデルを自動選択します。
ステップ 1: API へのアクセスを取得
cometAPI にログインします。まだユーザーでない場合は、まず登録してください。CometAPI コンソール にサインインします。インターフェースのアクセス認証 API キーを取得します。個人センターの API トークンで「Add Token」をクリックし、トークンキー: sk-xxxxx を取得して送信します。
ステップ 2: Auto API にリクエストを送る
“auto" または "auto-high” エンドポイントを選択して API リクエストを送信し、リクエストボディを設定します。リクエストメソッドとリクエストボディは当社ウェブサイトの API ドキュメントから取得できます。利便性のために Apifox テストも提供しています。<YOUR_API_KEY> は、アカウントの実際の CometAPI キーに置き換えてください。
違いはシンプルです:
auto— 一般的なワークロード向けのバランスの取れた選択。auto-high— より高品質なモデル選択を優先。
どちらも固定の基盤モデルを表すものではありません。
ステップ 3: CometAPI Auto はどのようにモデルを選択しますか？
model=auto または model=auto-high でリクエストを送ると、CometAPI はまずリクエストの特性を特定し、最も適合するルーティングシナリオを決定します。システムは、クライアント種別、画像やファイルの有無、推定入力コンテキスト長、ツール使用、構造化出力の要件、ストリーミング、その他サポート機能などの要素を考慮します。
適切なルーティングレーンを特定した後、CometAPI は対応する auto または auto-high モデルプールから候補モデルを選定します。無効化されている、ユーザーグループで利用不可、リクエストと非互換、必要なコンテキストや機能をサポートしない、といったモデルは除外されます。残った候補は、設定されたルーティングの優先度、重み、可用性に従って評価されます。
選定されたモデルは、CometAPI の既存のチャネルルーティングシステムに渡され、そのモデルとユーザーグループに利用可能なチャネルが見つけられます。結果として、最終的なモデルは事前に固定されているとは限らず、リクエストおよび現在のルーティング設定に応じて変わり得ます。