Помилки та повторні спроби
Аналізуйте HTTP-статус і тіло JSON-помилки разом. Зберігайте будь-який ідентифікатор запиту або посилання, повернутий сервісом; це дозволить службі підтримки знайти відповідний запис, не отримуючи ваш запит (промпт) або повний ключ.
Коди стану
| Код | Значення | Дія |
|---|---|---|
400 | Недійсний JSON, поле, параметр або відхилений запит | Виправте запит; не повторюйте його без змін |
401 | Відсутній, недійсний, протермінований або відкликаний ключ | Перевірте Authorization: Bearer <key> та цільове середовище |
402 | Баланс ключа не покриває ціну завдання (аналітика компанії, відео) | Поповніть баланс, а потім надішліть запит ще раз |
403 | Обліковий запис або ключ не може використовувати запитуваний продукт або маршрут | Перевірте GET /v1/models та увімкнені продукти для облікового запису |
404 | Неправильний маршрут або недоступний ресурс | Перевірте актуальну документацію та ідентифікатор |
413 | Тіло запиту завелике | Зменште або розділіть вхідні дані |
422 | Підтримуваний маршрут відхилив надіслану структуру | Прочитайте опис проблем і виправте тіло запиту |
429 | Досягнуто ліміту запитів, потужності або облікового запису, або бюджет ключа вичерпано | Зачекайте та повторіть спробу зі зростаючою затримкою; якщо бюджет вичерпано, спершу поповніть баланс |
500, 502, 503 | Тимчасова проблема на боці сервісу | Повторіть спробу обмежену кількість разів, а потім зверніться до служби підтримки |
Виняток — API завдань на генерацію зображень (/api/v1/jobs/*): він відповідає зі статусом HTTP 200 і передає код у тілі, {"code": 422, "msg": "…", "data": null}. Див. Генерація зображень.
Політика повторних спроб
Повторюйте запити лише у відповідь на 429, тимчасові 5xx та при короткочасних збоях мережі. Використовуйте невелику максимальну кількість спроб, загальний тайм-аут, зростаючі затримки (наприклад, 1, 2 і 4 секунди) та невелику випадкову варіацію, коли багато воркерів можуть виконувати повторні спроби одночасно.
Не повторюйте без змін запити, що повернули 400, 401, 402, 403, 404, 413 або 422. Перерване з'єднання вимагає обережності: запит, можливо, вже був виконаний і використав кредит, тому автоматичний дублікат може створити додаткову роботу та витрати.
Що логувати
Записуйте приблизний час і часовий пояс, публічну модель, маршрут, статус, ідентифікатор запиту або посилання, а також псевдонім ключа, його префікс або останні чотири символи. Ніколи не логуйте та не надсилайте повний ключ, паролі, конфіденційні запити (промпти), трасування стека або внутрішні імена.
Якщо обмежена кількість повторних спроб не дає результату, зверніться до support@omev.be, надавши очищений від чутливих даних приклад та записані ідентифікатори.