Перейти до основного вмісту

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.

Додайте fallback для model, зберігаючи у вашому застосунку невеликий впорядкований список model ID і переходячи до наступної model лише тоді, коли збій можна повторити або він специфічний для model. Не повторюйте спроби для некоректно сформованих запитів; виправте помилки 400, 401 і invalid request errors, перш ніж звертатися до іншої model.

Реалізуйте впорядкований fallback

Наведений нижче приклад Python перебирає model ID по черзі та зупиняється на помилках, які не можна повторити:
import os
import time
from openai import OpenAI, APIError, RateLimitError

client = OpenAI(
    api_key=os.environ["COMETAPI_KEY"],
    base_url="https://api.cometapi.com/v1",
)

models = ["your-primary-model-id", "your-fallback-model-id"]

for model in models:
    try:
        completion = client.chat.completions.create(
            model=model,
            messages=[
                {
                    "role": "user",
                    "content": "Summarize CometAPI in one sentence.",
                }
            ],
        )
        print(completion.choices[0].message.content)
        break
    except RateLimitError:
        time.sleep(2)
        continue
    except APIError as error:
        status_code = getattr(error, "status_code", None)
        if status_code in {500, 503, 504, 524}:
            time.sleep(2)
            continue
        raise
else:
    raise RuntimeError("All configured model fallbacks failed.")
Успішна відповідь надходить від першої model, яка завершує виконання:
{
  "model": "your-fallback-model-id",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "CometAPI gives developers one API surface for multiple model providers."
      }
    }
  ]
}

Виберіть fallback models

Наведений нижче запит виводить список доступних model ID, які ви можете оцінити для fallback:
curl https://api.cometapi.com/api/models
Відповідь містить записи model:
{
  "success": true,
  "page": 0,
  "page_size": 0,
  "total": 301,
  "data": [
    {
      "id": "deepseek-v4-pro",
      "provider": "DeepSeek",
      "model_type": "text",
      "features": [
        "text-to-text"
      ],
      "pricing": {
        "currency": "USD / M Tokens",
        "input": 0.416,
        "output": 0.832,
        "per_request": null,
        "per_second": null
      },
      "api_doc_url": "https://apidoc.cometapi.com/api/text/chat"
    }
  ]
}

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

ПомилкаВиправлення
Fallback приховує недійсні запитиНе використовуйте fallback для помилок 400, 401 або invalid request errors.
Models мають різні формати виводуНормалізуйте відповідь у вашому застосунку перед поверненням її користувачам.
Fallback збільшує вартістьОцініть вартість для кожної model, перш ніж додавати її до списку fallback.
Забагато паралельних fallbackПробуйте fallback послідовно, якщо тільки ваш продукт не потребує паралельного racing.

Пов’язані посилання

Last modified on May 28, 2026