Referans · Hatalar

Photta API hataları tüm tipler ve yapılması gerekenler

Tek cümlede

Her Photta API hatası aynı yapıyı döndürür: bir durum, bir `error.type`, bir mesaj ve bir `request_id`. Retry-After başlığından sonra 429'u ve artan aralıklarla (backoff) 5xx'i yeniden deneyin; 400, 401 ve 402 hatalarını kendi kodunuzda düzeltin.

API anahtarı alınDokümantasyonu okuyun
  • Hatalar: 7 hata türü
  • Retry-After: Retry-After: 30s
  • Sınırlar: 600 istek/dk

Bu sayfadaki her veri şuradan alınmıştır: Photta API dokümantasyonu · kontrol edildi

Hata tipleri

API dokümantasyonunda yayınlanan tam liste.

400invalid_request_error
The request is malformed or contains invalid parameters.
401authentication_error
The API key is missing, invalid, or expired.
402insufficient_credits_error
Your account does not have enough credits.
404not_found_error
The requested resource does not exist.
409conflict_error
The request conflicts with current state — e.g. your concurrent-batch cap is reached.
429rate_limit_error
Too many requests. Slow down and retry.Retry-After: 30
500api_error
An internal server error occurred. Retry later.

Bir hatanın yapısı

Ne ters giderse gitsin, her endpoint'te aynı zarf yapısı.

{
  "error": {
    "type": "rate_limit_error",
    "message": "Rate limit exceeded."
  },
  "request_id": "req_xxxxxxxx"
}

Hataları yönetme

  • Retry-After değerine uyun

    Bir 429 yanıtı Retry-After başlığı taşır. O kadar saniye bekleyin, ardından üstel geri çekilme (exponential backoff) ile yeniden deneyin — hemen yeniden denemek bir sonraki pencereyi yalnızca daha ileriye öteler.

  • Hatalar credits iadesi yapar

    Kabul edildikten sonra başarısız olan bir üretim credits miktarını otomatik olarak iade eder, böylece yeniden deneme çift ücretlendirmez.

  • İstek kimliğini (request id) belirtin

    Her yanıt bir `request_id` taşır. Bunu günlüğe kaydedin (log). Destek ekibinin binlercesi arasından belirli bir hatayı bulmasının en hızlı yoludur.

  • 409 bir kuyruk sinyalidir

    Bir çakışma, planınızın eşzamanlı toplu işlem (batch) sınırına ulaşıldığı anlamına gelir. Gönderilen ve süren toplu işlemi sonuçlanana kadar poll edin, ardından yeniden gönderin — döngüye girmeyin (spin).

API hataları hakkında sorular

Hata gövdesi (error body) neye benzer?

`request_id` ile birlikte `type` ve `message` içeren bir `error` nesnesi. Type kararlıdır ve makinelerce okunabilir; message ise insanlar içindir ve değişebilir.

Hangi hataları yeniden denemeye değer?

Retry-After saniyesi kadar bekledikten sonra 429 ve üstel geri çekilme ile 5xx. Bir 400, 401 veya 402, sizin tarafınızda bir şey değişene kadar aynı şekilde başarısız olur.

402 ne anlama gelir?

`insufficient_credits_error` — hesap, çağrı için veya bir toplu işlemdeki tüm rezervasyon için yeterli credits barındırmıyor. Hiçbir şey üretilmez ve hiçbir ücret alınmaz.

Bir hatayı nasıl bildiririm?

`request_id`, endpoint ve zaman bilgisini gönderin. Bu üçlü, tam çağrıyı tanımlar; onu aramak için görselin kendisine gerek yoktur.

Endpoint'ler ve referanslar

Bu sayfadaki her veri şuradan alınmıştır: Photta API dokümantasyonu · kontrol edildi

API'yi beş dakikada deneyin

Bir Photta API key oluşturun, yukarıdaki cURL kod parçacığını yapıştırın; kahveniz demlenmeden önce model üzerindeki ilk görselinizi alın.

Bir hesap oluşturun ve API anahtarı alınAPI
  • 7 hata türü
  • Retry-After: 30s
  • 600 istek/dk