Fehlervertrag#
Fehler verwenden { error: { message, type, code } }. Wiederholen Sie niemals unbegrenzt.
| HTTP | Code | Was zu tun ist |
|---|---|---|
| 400 | invalid_request | JSON, erforderliche Felder oder Tokenlimits korrigieren. |
| 401 | invalid_api_key | Schlüssel und Bearer-Header überprüfen; bei Widerruf rotieren. |
| 402 | insufficient_balance | Qualifizierende bestätigte Aufladung, verfügbares Guthaben und Schlüsselbudget überprüfen; jede neue Aufladung muss mindestens 100 USD betragen. |
| 403 | model_not_allowed | Schlüssel-Zulassungsliste aktualisieren oder ein erlaubtes Modell wählen. |
| 404 | model_not_found | /v1/models abrufen und eine exakte ID verwenden. |
| 409 | pending_reconciliation | Warten Sie auf die Nutzungsabstimmung, bevor Sie den Vorgang wiederholen. |
| 413 | request_too_large | Eingabe aufteilen oder größeren Kontext verwenden. |
| 422 | unsupported_feature | Wählen Sie eine Bereitstellung, die die Funktion unterstützt. |
| 429 | quota_exceeded | Retry-After beachten, falls angegeben, und begrenzte Wiederholungen verwenden; kein öffentliches kostenloses Testkontingent wird angeboten. |
| 502 | upstream_error | Mit begrenztem Backoff wiederholen; Status überprüfen. |
| 503 | service_unavailable | Dienststatus und Modellverfügbarkeit überprüfen, bevor Sie wiederholen. |
Doppelte Arbeit vermeiden#
Gehen Sie nicht davon aus, dass eine Inferenzanfrage kostenlos war, weil die Verbindung abgebrochen ist. Überprüfen Sie Ihre Nutzungsaufzeichnungen. Einzahlungen sind durch die Anbieter-Transaktionsidentität unabhängig idempotent.
Hilfe erhalten#
Verwenden Sie den Support-Leitfaden, um den fehlgeschlagenen Schritt zu diagnostizieren und einen Bericht mit dem Fehlercode, der UTC-Zeit, dem Modell und einer synthetischen Reproduktion zu erstellen. Das lokale Berichtstool sendet kein Ticket. Halten Sie Zugangsdaten und Kundeninhalte aus dem Bericht heraus.
Anfragebeispiel
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
}'