Referensi · Error

Error Photta API setiap tipe dan langkah yang harus diambil

Ringkasan singkat

Setiap kegagalan Photta API mengembalikan format yang sama: status, `error.type`, pesan, dan `request_id`. Coba ulang 429 setelah header Retry-After dan 5xx dengan backoff; perbaiki 400, 401, dan 402 di kode Anda sendiri.

Dapatkan API keyBaca dokumentasi
  • Error: 7 tipe error
  • Retry-After: Retry-After: 30s
  • Batasan: 600 requests/min

Setiap angka di halaman ini bersumber dari dokumentasi API Photta · diperiksa

Tipe error

Daftar lengkap yang dipublikasikan oleh dokumentasi API.

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.

Format sebuah error

Struktur pembungkus yang sama di setiap endpoint, apa pun masalah yang terjadi.

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

Menangani kegagalan

  • Patuhi Retry-After

    Respons 429 menyertakan header Retry-After. Tunggu sekian detik tersebut, lalu coba lagi dengan exponential backoff — mencoba kembali seketika hanya akan menggeser window berikutnya semakin jauh.

  • Kegagalan mengembalikan credits

    Generasi yang gagal setelah diterima akan mengembalikan credits secara otomatis, sehingga percobaan ulang tidak membebankan biaya ganda.

  • Sertakan ID permintaan

    Setiap respons menyertakan `request_id`. Catat ini dalam log. Ini adalah cara tercepat bagi tim support untuk menemukan satu kegagalan spesifik di antara ribuan lainnya.

  • 409 adalah sinyal antrean

    Konflik berarti batas batch konkuren pada paket Anda telah tercapai. Lakukan polling pada batch yang sedang berjalan hingga selesai, lalu kirim ulang — jangan melakukan perulangan tanpa henti.

Pertanyaan seputar error API

Seperti apa struktur body error?

Objek `error` dengan `type` dan `message`, bersama dengan `request_id`. Nilai type bersifat stabil dan dapat dibaca oleh mesin; pesan ditujukan untuk manusia dan dapat berubah.

Error mana saja yang layak dicoba kembali?

429 setelah menunggu durasi detik pada Retry-After, dan 5xx dengan exponential backoff. Status 400, 401, atau 402 akan terus gagal dengan cara yang sama sampai ada perubahan di sisi Anda.

Apa arti dari 402?

`insufficient_credits_error` — akun tidak memiliki credits yang cukup untuk pemanggilan tersebut, atau untuk seluruh reservasi dalam satu batch. Tidak ada yang digenerasikan dan tidak ada biaya yang dikenakan.

Bagaimana cara melaporkan kegagalan?

Kirimkan `request_id`, endpoint, dan waktunya. Tiga kombinasi tersebut mengidentifikasi pemanggilan secara tepat; gambar itu sendiri tidak diperlukan untuk mencarinya.

Endpoint dan referensi

Setiap angka di halaman ini bersumber dari dokumentasi API Photta · diperiksa

Coba API dalam lima menit

Buat Photta API key, tempel cuplikan cURL di atas, dan Anda akan mendapatkan gambar on-model pertama sebelum kopi selesai diseduh.

Buat akun dan dapatkan API keyAPI
  • 7 tipe error
  • Retry-After: 30s
  • 600 requests/min