Поверніть запит на правильний шлях.

Перевірте статус сервісу, потім розділіть проблеми доступу до облікового запису, автентифікації API, виявлення моделей, інференсу та оплати. Наявність моделі в каталозі не встановлює її живого доступу: GET /v1/models перелічує підключені розгортання.

503 service_unavailable означає, що необхідний сервіс не може прийняти запит. Перевірте статус сервісу та довідник API перед повторною спробою; повторні запити не можуть увімкнути недоступний сервіс. Для виділеного GPU зачекайте підтвердженого забезпечення. Для платежів дотримуйтесь інструкцій замовлення та записаного статусу верифікації; оновлення замовлення не додає кредит.

Зафіксуйте HTTP-статус, а також code і message помилки. Перевірте налаштовану базову URL-адресу API, точний ідентифікатор моделі та версію клієнта, перш ніж змінювати логіку застосунку.

• 401: перевірте заголовок Bearer і чи не було відкликано ключ. Не вносьте повний ключ до журналів.
• 403: оберіть модель, дозволену списком дозволених моделей ключа.
• 400 або 413: перевірте JSON, обов’язкові поля, ліміт виводу та сукупний бюджет контексту вводу/виводу.
• 402: перевірте, чи має обліковий запис підтверджене кваліфікаційне поповнення на суму щонайменше 100 USD, потім перевірте доступний кредит і бюджет вибраного ключа; кваліфікованим обліковим записам не потрібно підтримувати баланс у розмірі 100 USD.
• 429: якщо надано заголовок Retry-After, дотримуйтеся його, використовуйте обмежені повторні спроби та перевірте застосовні ліміти сервісу; щоденної безкоштовної пробної квоти немає.
• 502 або 503: перевірте доступність і повідомлення про помилку перед обмеженою повторною спробою.

Посібник із помилок і ліміти пояснюють шляхи відновлення. Новий запит може створювати нову роботу; не вважайте, що повторні спроби клієнта дедуплікуються.

Закрита вкладка браузера, тайм-аут або обірваний потік не доводять, що генерація зупинилася. Збережіть будь-який ідентифікатор відповіді та останній кадр використання, якщо його отримано. Останній кадр використання може надійти після finish_reason вибору; мережевий фрагмент не обов'язково є повною подією.

409 pending_reconciliation, або помилка вищого рівня після відправлення, може залишити кредит зарезервованим до отримання авторитетних даних про використання. Уникайте надсилання дубльованих запитів для зняття блокування. Порівняйте час UTC, модель та ім'я ключа з використанням у консолі та збережіть деталі запиту для узгодження. Час зняття не гарантується.

Для проблеми з оплатою запишіть посилання на замовлення, актив, мережу, суму та видимий статус. Ніколи не надсилайте ще один платіж лише тому, що перший очікує на обробку. Виведення коштів на гаманець наразі недоступне. Скасування платного замовлення GPU до активації повертає платіж на баланс облікового запису WeightsAPI; воно не переказує кошти на гаманець.

Корисний звіт містить операцію, часову мітку UTC, шлях кінцевої точки, ідентифікатор моделі, SDK або інтеграцію та версію, налаштування потокової передачі, ліміт вихідних токенів, статус/помилку, очікуваний результат і фактичний результат. Вказуйте референс відповіді або транзакції лише за наявності; наразі шлюз не надає ідентифікатор підтримки для кожної помилки.

Додайте найменший синтетичний приклад, який відтворює проблему. Замініть реальні розмови, записи клієнтів і приватні документи вигаданим текстом. Вкажіть відповідну кількість повторних спроб і чи повторюється проблема в різних запитах. Знімки екрана мають показувати помилку та контекст після видалення облікових даних, балансів або ідентифікаторів, які ви не збираєтеся передавати.

Для замовлення виділеного GPU вкажіть посилання на замовлення, конфігурацію та видимий статус оплати або надання. Очікуване замовлення не є активною машиною.

Ніколи не вказуйте секрет API, заголовок Authorization, сесійний файл cookie, приватний ключ гаманця, фразу відновлення або повний файл середовища. Назви ключа або навмисно скороченого префікса достатньо, щоб розрізняти застосунки. Публічні референси транзакцій можуть усе одно пов’язувати активність із гаманцем; діліться лише тим, що потрібно для розслідування.

Якщо ключ було скомпрометовано, створіть заміну, оновіть застосунок і відкликайте старий ключ. Відкликання блокує нові допуски; раніше допущені запити обробляються звичайно. Див. автентифікацію щодо роботи з ключами.

Скопіюйте та перегляньте свій звіт, потім збережіть його разом із відповідним посиланням на запит або замовлення. Копіювання не надсилає заявку. Офіційні контакти підтримки та години роботи не опубліковані; використовуйте лише підтверджений канал для надсилання звіту.

Цільові показники відповіді, контакти для ескалації та сервісні кредити не встановлено. Не включайте у звіт облікові дані та конфіденційний вміст клієнта.