Як переглянути доступні моделі?

Переглядайте доступні моделі, викликавши публічний endpoint каталогу GET /api/models. Використовуйте повернуті model ID для API-запитів, а потім перевіряйте деталі можливостей і цін у директорії моделей.

Виклик каталогу моделей

Наведений нижче запит показує доступні моделі:

curl https://api.cometapi.com/api/models

Відповідь містить записи моделей:

{
  "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 з каталогу:

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:

your-model-id
another-model-id

Використання model ID

Наведений нижче приклад надсилає запит з одним model ID із каталогу:

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:

{
  "model": "your-model-id",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "Hello."
      }
    }
  ]
}

Поширені помилки

Помилка	Як виправити
Використання каталогу як джерела даних про ціни	Використовуйте директорію моделей для деталей щодо цін і можливостей.
Повторне використання застарілих model ID	Отримуйте каталог під час розгортання або запуску.
Плутанина між `/api/models` і `/v1/models`	Використовуйте `/api/models` для публічного каталогу. Використовуйте автентифікований `/v1/models` лише тоді, коли вам потрібна форма списку моделей, сумісна з OpenAI.
Неправильний endpoint для типу моделі	Зіставляйте можливості моделі зі сторінкою довідки API.