Hata sözleşmesi#
Hatalar { error: { message, type, code } } kullanır. Asla süresiz yeniden denemeyin.
| HTTP | Kod | Ne yapmalı |
|---|---|---|
| 400 | invalid_request | JSON, zorunlu alanlar veya token sınırlarını düzeltin. |
| 401 | invalid_api_key | Anahtarı ve Bearer başlığını kontrol edin; iptal edildiyse döndürün. |
| 402 | insufficient_balance | Uygun onaylanmış yüklemeyi, kullanılabilir krediyi ve anahtar bütçesini kontrol edin; her yeni yükleme en az 100 USD olmalıdır. |
| 403 | model_not_allowed | Anahtar izin listesini güncelleyin veya izin verilen bir model seçin. |
| 404 | model_not_found | /v1/models'i getirin ve tam bir kimlik kullanın. |
| 409 | pending_reconciliation | İşlemi yeniden denemeden önce kullanım mutabakatını bekleyin. |
| 413 | request_too_large | Girdiyi bölün veya daha büyük bir bağlam kullanın. |
| 422 | unsupported_feature | Özelliği destekleyen bir dağıtım seçin. |
| 429 | quota_exceeded | Varsa Retry-After'a uyun ve sınırlı yeniden denemeler kullanın; halka açık ücretsiz deneme kotası sunulmaz. |
| 502 | upstream_error | Sınırlı geri çekilme ile yeniden deneyin; durumu kontrol edin. |
| 503 | service_unavailable | Yeniden denemeden önce hizmet durumunu ve model kullanılabilirliğini kontrol edin. |
Yinelenen işlerden kaçının#
Bağlantı koptuğu için bir çıkarım isteğinin ücretsiz olduğunu varsaymayın. Kullanım kayıtlarınızı kontrol edin. Yatırma işlemleri, sağlayıcı işlem kimliğine göre bağımsız olarak idempotenttir.
Yardım alın#
Başarısız adımı teşhis etmek ve hata kodu, UTC saati, model ve sentetik bir yeniden oluşturma içeren bir rapor hazırlamak için destek rehberini kullanın. Yerel rapor aracı bir talep göndermez. Kimlik bilgilerini ve müşteri içeriğini raporun dışında tutun.
İstek örneği
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
}'