> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 利用可能な CometAPI モデルを一覧表示する

> モデルカタログ endpoint で利用可能な CometAPI モデルを一覧表示し、モデルディレクトリを使って機能と料金を確認します。

公開 `GET /api/models` カタログ endpoint を呼び出して、利用可能なモデルを一覧表示します。返された model ID を API リクエストに使用し、その後モデルディレクトリで機能と料金の詳細を確認します。

## モデルカタログを呼び出す

次のリクエストで利用可能なモデルを一覧表示できます。

```bash theme={null}
curl https://api.cometapi.com/api/models
```

レスポンスにはモデルレコードが含まれます。

```json theme={null}
{
  "success": true,
  "page": 0,
  "page_size": 0,
  "total": 301,
  "data": [
    {
      "id": "gpt-image-2",
      "provider": "OpenAI",
      "model_type": "image",
      "features": [
        "text-to-image"
      ],
      "pricing": {
        "currency": "USD / M Tokens",
        "input": 4,
        "output": 24,
        "per_request": null,
        "per_second": null
      },
      "api_doc_url": "https://apidoc.cometapi.com/api/image/openai/images"
    }
  ]
}
```

## Python でのモデル一覧

次の Python 例では、カタログから model ID を出力します。

```python theme={null}
import requests

response = requests.get("https://api.cometapi.com/api/models", timeout=30)
response.raise_for_status()

models = response.json()["data"]
for model in models:
    print(model["id"])
```

出力は model ID の一覧です。

```text theme={null}
your-model-id
another-model-id
```

## model ID を使う

次の例では、カタログ内の 1 つの model ID を使ってリクエストを送信します。

```bash theme={null}
curl https://api.cometapi.com/v1/chat/completions \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "messages": [
      {
        "role": "user",
        "content": "Say hello."
      }
    ]
  }'
```

レスポンスでは選択した model ID が使用されます。

```json theme={null}
{
  "model": "your-model-id",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "Hello."
      }
    }
  ]
}
```

## よくあるエラー

| Error                                | Fix                                                                                       |
| ------------------------------------ | ----------------------------------------------------------------------------------------- |
| カタログを料金データとして扱っている                   | 料金と機能の詳細にはモデルディレクトリを使用してください。                                                             |
| 古い model ID を再利用している                 | デプロイ時または起動時にカタログを取得してください。                                                                |
| `/api/models` と `/v1/models` を混同している | 公開カタログには `/api/models` を使用してください。OpenAI 互換のモデル一覧形式が必要な場合にのみ、認証付きの `/v1/models` を使用してください。 |
| モデルタイプに対して誤った endpoint を使っている        | モデルの機能を API リファレンスページに対応させてください。                                                          |

## 関連リンク

* [Models ページ](/ja/overview/models)
* [モデルディレクトリ](https://www.cometapi.com/models/)
* [料金](https://www.cometapi.com/pricing/)
* [テキストモデル](/api/text)
* [画像モデル](/api/image)
* [動画モデル](/api/video)
* [音声モデル](/api/audio)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "TechArticle",
        "@id": "https://apidoc.cometapi.com/guides/how-to-list-available-models",
        "headline": "利用可能なモデルを一覧表示するにはどうすればよいですか？",
        "description": "公開モデルカタログエンドポイントで利用可能な CometAPI モデルを一覧表示し、モデルディレクトリを使用して機能と料金を確認します。",
        "url": "https://apidoc.cometapi.com/guides/how-to-list-available-models",
        "author": {
          "@type": "Organization",
          "name": "CometAPI"
        },
        "publisher": {
          "@type": "Organization",
          "name": "CometAPI",
          "url": "https://www.cometapi.com"
        }
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI ドキュメント",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "ガイド",
            "item": "https://apidoc.cometapi.com/guides/use-cometapi-with-openai-sdk"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "利用可能なモデルを一覧表示するにはどうすればよいですか？",
            "item": "https://apidoc.cometapi.com/guides/how-to-list-available-models"
          }
        ]
      }
    ]
    }
    `}
</script>