---
title: "利用可能なモデルのAPIクエリ"
description: "GET /v1/models の2つのレスポンス形式、モデルIDの読み取り、およびモデルの可視性と実際に呼び出し可能であることの違い。"
headingIds: {"OpenAI 形式":"section-1","Anthropic 形式":"section-2","クエリ結果の使い方":"section-3","リストが空の場合、またはモデルが欠落している場合":"section-4"}
---

<aside className="docs-publication" data-pagefind-ignore>

ドキュメントは [1ZheAI](https://1zheai.com/en/editorial/#publisher) が管理しています。[出典と訂正](https://1zheai.com/en/editorial/)。

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

</aside>
まずモデルを確認し、次にリクエストを作成します。`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. [コンソールのモデルカタログ](https://1zheai.com/model-catalog?lng=ja)で、そのモデルのインターフェース型を照合します。
3. 最小限のテキストリクエストで検証し、その後、画像、ツール、その他のパラメータを段階的に追加します。

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

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

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

モデルシリーズと選択の推奨事項は[サポートされているモデル](/ja/docs/models/)を参照してください。