Referenz · Fehler

Photta API-Fehler Jeder Typ und was zu tun ist

In aller Kürze

Jeder Fehler der Photta API hat dieselbe Struktur: ein Status, ein `error.type`, eine Nachricht und eine `request_id`. Führen Sie bei 429 nach Ablauf des Retry-After-Headers und bei 5xx mit Backoff einen Retry durch; beheben Sie 400, 401 und 402 im eigenen Code.

API-Key anfordernDokumentation lesen
  • Fehler: 7 Fehlertypen
  • Retry-After: Retry-After: 30s
  • Limits: 600 Anfragen/Min.

Jeder Zahlenwert auf dieser Seite stammt aus der Photta-API-Dokumentation · geprüft

Fehlertypen

Die vollständige Liste aus der API-Dokumentation.

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.

Die Struktur eines Fehlers

Derselbe Envelope an jedem Endpoint, unabhängig vom konkreten Fehler.

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

Fehlerbehandlung

  • Retry-After beachten

    Ein 429 enthält einen Retry-After-Header. Warten Sie diese Anzahl an Sekunden und wiederholen Sie den Request dann mit exponentiellem Backoff — ein sofortiger Retry verschiebt das nächste Fenster nur weiter nach hinten.

  • Fehlschläge erstatten credits zurück

    Eine Generierung, die nach der Annahme fehlschlägt, erstattet ihre credits automatisch zurück, sodass ein Retry nicht doppelt abrechnet.

  • Geben Sie die Request-ID an

    Jede Antwort enthält eine `request_id`. Protokollieren Sie diese. Es ist für den Support der schnellste Weg, einen bestimmten Fehler unter Tausenden zu finden.

  • 409 ist ein Warteschlangen-Signal

    Ein Konflikt bedeutet, dass das Limit Ihres Tarifs für gleichzeitige Batches erreicht ist. Pollen Sie den bereits aktiven Batch, bis er abgeschlossen ist, und übermitteln Sie ihn dann erneut — vermeiden Sie unnötige Loops.

Fragen zu API-Fehlern

Wie sieht ein Error-Body aus?

Ein `error`-Objekt mit einem `type` und einer `message`, zusammen mit der `request_id`. Der Typ ist stabil und maschinenlesbar; die Nachricht ist für Menschen gedacht und kann sich ändern.

Welche Fehler lohnen einen Retry?

429 nach Ablauf der Retry-After-Sekunden und 5xx mit exponentiellem Backoff. Ein 400, 401 oder 402 schlägt auf dieselbe Weise fehl, bis sich auf Ihrer Seite etwas ändert.

Was bedeutet ein 402?

`insufficient_credits_error` — das Konto verfügt nicht über genügend credits für den Call oder für die gesamte Reservierung in einem Batch. Es wird nichts generiert und nichts berechnet.

Wie melde ich einen Fehler?

Senden Sie die `request_id`, den Endpoint und den Zeitstempel. Dieses Tripel identifiziert den genauen Call; das Bild selbst wird für die Suche nicht benötigt.

Endpoints und Referenzen

Jeder Zahlenwert auf dieser Seite stammt aus der Photta-API-Dokumentation · geprüft

Testen Sie die API in fünf Minuten

Generieren Sie einen Photta-API-Schlüssel, fügen Sie das obige cURL-Snippet ein, und Sie erhalten Ihr erstes Bild am Model, noch bevor der Kaffee fertig gebrüht ist.

Konto erstellen und API-Key anfordernAPI
  • 7 Fehlertypen
  • Retry-After: 30s
  • 600 Anfragen/Min.