Search docs

Search the TryOnCloud API docs

API-Referenz

Fehler

Jeder Fehlercode, was er bedeutet und ob ein erneuter Versuch unternommen werden sollte.

Code-Beispiele, Endpunkte und Fehlercodes sind in jeder Sprache identisch.

Jeder Fehler ist ein JSON-Objekt mit einer für Menschen lesbaren error-Meldung und einem stabilen code. Die Verzweigung sollte anhand des code erfolgen, nicht anhand der Meldung.

json
{ "error": "No credits left. Top up your developer wallet to continue.", "code": "NO_CREDITS" }

Fehler erzeugen

HTTPCodeWas ist passiert?Noch einmal versuchen?
400BAD_INPUTDer Text konnte nicht gelesen werdenNein, korrigiere die Anfrage.
400NO_PERSONPersonenbild fehlt, ist unlesbar oder hat ein nicht unterstütztes FormatNein, bitte sende ein gültiges Bild
400NO_GARMENTDas Bild des Kleidungsstücks fehlt, ist unlesbar oder die garment_url-Adresse ist gesperrtNein, bitte sende ein gültiges Bild oder eine öffentliche https-URL
401NO_KEYKein X-API-KEY-HeaderNein
401INVALID_KEYSchlüssel falsch oder widerrufenNein, schau mal nach dem Schlüssel im Armaturenbrett.
402NO_CREDITSGekaufte Credits aufgebrauchtNein, Credits kaufen
402QUOTA_EXCEEDEDFreigrenze ausgeschöpftNein, Credits kaufen
402KEY_LIMIT_REACHEDDieser API-Schlüssel hat sein monatliches Guthabenlimit erreicht. Der Textkörper enthält die Felder used und limitNein, warte bis zum 1. (UTC) oder verwende einen Schlüssel mit einem höheren Limit
402FREE_TRIAL_USEDDie kostenlose Testversion wurde auf diesem Gerät bereits genutzt.Nein, Credits kaufen
403DEVICE_BANNEDDieses Gerät wurde wegen Missbrauchs gesperrtNein, wenden Sie sich an den Support
400BAD_IDEMPOTENCY_KEYDer Idempotency-Key ist leer, zu lang oder enthält Leerzeichen.Nein, korrigiere die Kopfzeile.
409IDEMPOTENCY_IN_PROGRESSEine Anfrage mit diesem Schlüssel wird noch bearbeitet. Es fallen keine Kosten an.Ja, nach Retry-After
409IDEMPOTENCY_REPLAYDieser Schlüssel hat bereits funktioniert. Es wurde nichts berechnet.Nein, in der ersten Antwort war das Bild enthalten.
409IDEMPOTENCY_MISMATCHDieser Schlüssel wurde mit verschiedenen Bildern verwendetNein, benutze einen neuen Schlüssel.
413IMAGE_TOO_LARGEEin Bild ist größer als 15 MBNein, erst verkleinern
422CONTENT_FILTEREDDurch die Inhaltsmoderation gesperrt. Guthaben zurückerstattetNein, verwende andere Bilder
429RATE_LIMITEDZu viele AnfragenJa, nach Retry-After Sekunden
500GENERATION_FAILEDDer Motor ist ausgefallen. Der Kaufpreis wurde erstattet.Ja, einmal

Asynchrone Aufträge und Stapelverarbeitung

HTTPCodeWas ist passiert?Noch einmal versuchen?
400BAD_WEBHOOK_URLwebhook_url ist keine öffentliche https-URLNein, korrigiere die URL
400BATCH_TOO_LARGEMehr als 500 Artikel bzw. mehr als 10 im TestmodusNein, teile den Batch auf
402ASYNC_NEEDS_CREDITSAsynchrone Aufträge und Stapelverarbeitungen verbrauchen gekaufte GuthabenNein, kaufe Credits oder verwende POST /generate
429TOO_MANY_JOBSAuf dem Konto laufen bereits 50 asynchrone JobsJa, nach Retry-After
500JOB_CREATE_FAILED, BATCH_CREATE_FAILEDKonnte nicht erstellt werden. Guthaben zurückerstattetJa

Ein Auftrag, der nach seiner Annahme fehlschlägt, meldet im Auftrag selbst und im Webhook generation.failed den Fehlercode error.code: CONTENT_FILTERED, GENERATION_FAILED oder INPUT_FETCH_FAILED (eine Bild-URL konnte nicht heruntergeladen werden). Das Guthaben wird zurückerstattet. Stornierte Batch-Elemente werden mit CANCELLED angezeigt.

Weitere Endpunkte

EndpunktHTTPCodeNoch einmal versuchen?
GET /credits500CREDITS_UNAVAILABLEJa
GET /results/:id404NOT_FOUND (unbekannt, gehört nicht Ihnen oder ist älter als 7 Tage)Nein
DELETE /customers/:id500DELETE_FAILED (es wurde nichts gelöscht)Ja
DELETE /results/:id404NOT_FOUNDNein
DELETE /results/:id500DELETE_FAILEDJa

Empfohlene Handhabung

js
async function tryOn(form) {
  for (let attempt = 1; attempt <= 2; attempt++) {
    const res = await fetch("https://www.tryoncloud.com/api/v1/generate", {
      method: "POST",
      headers: { "X-API-KEY": process.env.TRYONCLOUD_API_KEY },
      body: form,
      signal: AbortSignal.timeout(120_000),
    })
    if (res.ok) return Buffer.from(await res.arrayBuffer())

    const { code, error } = await res.json()
    if (code === "RATE_LIMITED") {
      await new Promise((r) => setTimeout(r, Number(res.headers.get("Retry-After") || 5) * 1000))
      continue
    }
    if (code === "GENERATION_FAILED" && attempt === 1) continue // refunded, retry once
    throw new Error(`${code}: ${error}`) // 4xx: fix input or buy credits, do not loop
  }
  throw new Error("GENERATION_FAILED twice")
}
Warnung: Versuchen Sie niemals, einen 402-Fehler in einer Schleife erneut abzufragen. Dies bedeutet, dass das Guthaben des Kontos aufgebraucht ist.