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. |
Пов’язані посилання