Усунення проблем

Почніть із симптому, потім перейдіть до виправлення. Більшість збоїв спричинені базовою URL-адресою, ключем, ID моделі або балансом.

Таблиця за симптомами

Автентифікація

Відкликаний ключ повертає повідомлення, у якому вказано префікс ключа:

{
  "status": 401,
  "code": "UNAUTHORIZED",
  "message": "API Key has been revoked (keyPrefix=...)"
}

Контрольний список:

• Заголовок має вигляд Authorization: Bearer <key> для Model API та Felo APIs.
• Data API також приймає X-API-Key: <key>.
• Ключ не взято в лапки, і немає завершального символу нового рядка від скопійованої змінної середовища.
• У розгорнутому середовищі змінна справді встановлена; ключ, який працює локально, може бути відсутнім у продакшені.
• Ключ не було видалено або змінено. Видалений або змінений ключ неможливо показати знову; створіть новий.

Про створення ключів і ліміти див. Автентифікація.

Пастки базової URL-адреси

Дві типові помилки:

1. Додавання /chat/completions до базової URL-адреси, яку SDK уже розширює.
2. Установлення базової URL-адреси Anthropic як https://openapi.felo.ai/api/v1. SDK додає /v1/messages, тому запит стає /api/v1/v1/messages.

Проблеми з ID моделі

ID моделей — це публічні ID з каталогу, а не внутрішні назви вищого постачальника чи відображувана назва.

• Знайдіть ID на сторінці моделей або в GET /api/v1/models.
• Переконайтеся, що модель підтримує протокол, який ви викликаєте (supported_protocols).
• Якщо ви прив'язали канал, переконайтеся, що цей канал опубліковано та запущено для цієї моделі. Недоступний канал не є резервним варіантом.

Див. Канали та маршрутизація постачальників.

Проблеми з потоковою передачею

• Установіть stream: true у тілі запиту, а не як параметр запиту.
• Читайте тіло відповіді як потік. Очікування повної відповіді зводить нанівець потокову передачу.
• Деякі проксі та безсерверні платформи буферизують відповіді. Вимкніть буферизацію для маршруту, який проксіює запит.
• Chat Completions передає choices[0].delta, а не choices[0].message. Остаточний вміст надходить багатьма фрагментами.
• Потік може завершитися без чистої термінальної події, якщо з'єднання розірвано. Вважайте розірване з'єднання незавершеною відповіддю.

Проблеми з асинхронними завданнями

• Опитуйте endpoint статусу, що належить родині завдань. Робочі процеси Felo використовують GET /v2/tasks/{task_id}/status; завдання відео та зображень моделей використовують власні endpoint генерації.
• Зупиняйтеся на кожному термінальному статусі, зокрема на збоях і завершеннях строку дії, а не лише на успіху.
• Зворотні виклики для відео та зображень наразі ігноруються. Не чекайте на webhook.
• URL-адреса результату може бути короткочасною. Запросіть свіжу URL-адресу з endpoint статусу, якщо завантаження втратило чинність.
• Перевірте завдання, перш ніж надсилати повторно. Повторне надсилання запущеного завдання створює дублікат, і обидва оплачуються.

Див. Асинхронні завдання.

Проблеми з Data API

• Дотримуйтеся точного шляху методу з довідника Data API.
• Тіла запитів залежать від постачальника. Поле, яке працює для одного постачальника, не гарантовано працює для іншого.
• Помилка постачальника може надходити всередині відповіді 4xx із повідомленням, специфічним для постачальника. Записуйте в журнал request_id і тіло відповіді.

Нагадування про безпеку

• Ніколи не вставляйте API-ключ у код браузера, пакет мобільного застосунку або публічний репозиторій. Тримайте його на сервері та проксіюйте запити.
• Не записуйте в журнал повний ключ. Якщо потрібно його ідентифікувати, записуйте префікс.
• Негайно змініть ключ, якщо він міг бути скомпрометований.

Перш ніж звертатися до підтримки

Зберіть:

1. Endpoint і метод HTTP.
2. Код стану HTTP, code і request_id.
3. ID моделі або ID завдання.
4. Часову позначку із зазначенням часового поясу.
5. Мінімальне тіло запиту без секретів.

Надішліть це до підтримки разом з електронною поштою облікового запису. Не додавайте повний API-ключ.

Пов'язані розділи

• Помилки, обмеження та повторні спроби
• Протоколи та SDK
• Оплата та кредити
• Автентифікація