Kontrakt błędów#
Błędy używają { error: { message, type, code } }. Nigdy nie ponawiaj w nieskończoność.
| HTTP | Kod | Co zrobić |
|---|---|---|
| 400 | invalid_request | Popraw JSON, wymagane pola lub limity tokenów. |
| 401 | invalid_api_key | Sprawdź klucz i nagłówek Bearer; jeśli klucz został unieważniony, zastąp go nowym. |
| 402 | insufficient_balance | Sprawdź kwalifikujące potwierdzone doładowanie, dostępne środki i budżet klucza; każde nowe doładowanie musi wynosić co najmniej 100 USD. |
| 403 | model_not_allowed | Zaktualizuj listę modeli dozwolonych dla tego klucza lub wybierz dozwolony model. |
| 404 | model_not_found | Pobierz /v1/models i użyj dokładnego identyfikatora. |
| 409 | pending_reconciliation | Poczekaj na uzgodnienie użycia przed ponowieniem operacji. |
| 413 | request_too_large | Podziel dane wejściowe lub użyj większego kontekstu. |
| 422 | unsupported_feature | Wybierz wdrożenie obsługujące tę funkcję. |
| 429 | quota_exceeded | Uwzględnij Retry-After, jeśli podano, i użyj ograniczonych ponowień; nie oferuje się publicznego bezpłatnego limitu próbnego. |
| 502 | upstream_error | Ponów z ograniczonym odstępem; sprawdź status. |
| 503 | service_unavailable | Sprawdź status usługi i dostępność modeli przed ponowieniem. |
Unikaj duplikowania pracy#
Nie zakładaj, że żądanie wnioskowania było bezpłatne, ponieważ połączenie zostało zerwane. Sprawdź rejestry użycia. Depozyty są niezależnie idempotentne według tożsamości transakcji dostawcy.
Uzyskaj pomoc#
Użyj przewodnika wsparcia, aby zdiagnozować krok, który zawodzi, i przygotować raport z kodem błędu, czasem UTC, modelem i syntetyczną reprodukcją. Lokalne narzędzie raportowania nie wysyła zgłoszenia. Nie umieszczaj w raporcie danych uwierzytelniających ani treści klienta.
Przykład żądania
curl https://weightsapi.com/v1/chat/completions \
-H "Authorization: Bearer $WEIGHTSAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Qwen/Qwen3-32B",
"messages": [
{
"role": "user",
"content": "Hello!"
}
],
"stream": true
}'