利用可能なモデルのAPIクエリ

ドキュメントは 1ZheAI が管理しています。出典と訂正。

エラーを見つけましたか？ページのアドレスと説明を添えてサポートに連絡してください。API キーやアカウント情報は送信しないでください。

まずモデルを確認し、次にリクエストを作成します。GET https://1zheai.com/v1/models は、現在のキー、グループ、およびモデル制限の下で可視なモデルを返します。推論リクエストを送信する必要はありません。

OpenAI 形式

bash

curl --fail-with-body --connect-timeout 10 --max-time 30 \
  https://1zheai.com/v1/models \
  -H "Authorization: Bearer $ONEZHE_API_KEY"

以下は簡略化した構造の概要です。リストは実際の返却値に従います。

json

{
  "object": "list",
  "data": [{"id": "gpt-5.6-sol", "object": "model"}]
}

jq をインストールしている場合、リクエストの後に | jq -r '.data[].id' を追加すると、1行に1つのモデルIDが表示されます。公開価格APIの model_name とここでの id を混同しないでください。

Anthropic 形式

以下の2つのリクエストヘッダーを使用すると、同じパスがAnthropicスタイルのデータを返します。

bash

curl --fail-with-body https://1zheai.com/v1/models \
  -H "x-api-key: $ONEZHE_API_KEY" \
  -H "anthropic-version: 2023-06-01"

data[].id、data[].display_name、および has_more に注目してください。認証方式を切り替えたら、もう一方のレスポンス構造で解析し続けないでください。

クエリ結果の使い方

1. data[].id から完全なIDをコピーし、大文字・小文字、ハイフン、日付サフィックスを保持します。
2. コンソールのモデルカタログで、そのモデルのインターフェース型を照合します。
3. 最小限のテキストリクエストで検証し、その後、画像、ツール、その他のパラメータを段階的に追加します。

モデルリストはリアルタイムのヘルスチェックではなく、すべてのパラメータ制限も含みません。モデルは可視ですが一時的に利用可能なアップストリームがない場合、リクエストは失敗する可能性があります。公式サイトのHTTP可用性監視が、すべてのモデルが成功裏に推論できることを意味するわけではありません。

リストが空の場合、またはモデルが欠落している場合

キーのモデル制限とグループを確認してください。公開価格ページに掲載されているモデルが、すべてのキーに対して開かれているとは限りません。401の場合はまずキーの状態を確認し、403の場合はアクセス条件を確認してください。詳細な手順はエラーコードとトラブルシューティングを参照してください。

モデルシリーズと選択の推奨事項はサポートされているモデルを参照してください。