Search docs

Search the TryOnCloud API docs

Referencia de la API

Errores

Cada código de error, qué significa y si hay que volver a intentarlo.

Los ejemplos de código, los puntos finales y los códigos de error son los mismos en todos los idiomas.

Cada error está en formato JSON y contiene un campo error legible para el usuario y un code estable. Toma decisiones en función del code, no del mensaje.

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

Generar errores

HTTPcódigo¿Qué pasó?¿Lo intentas de nuevo?
400BAD_INPUTNo se ha podido leer el cuerpo del mensajeNo, corrige la solicitud.
400NO_PERSONFalta la imagen de la persona, es ilegible o no tiene un formato compatibleNo, envía una imagen válida
400NO_GARMENTFalta la imagen de la prenda, es ilegible o la URL garment_url está bloqueadaNo, envía una imagen válida o una URL pública https
401NO_KEYNo hay encabezado X-API-KEYNo
401INVALID_KEYClave incorrecta o revocadaNo, comprueba la llave en el salpicadero.
402NO_CREDITSCréditos comprados agotadosNo, comprar créditos
402QUOTA_EXCEEDEDSe ha agotado la asignación gratuitaNo, comprar créditos
402KEY_LIMIT_REACHEDEsta clave de API ha alcanzado su límite de crédito mensual. El cuerpo del mensaje incluye used y limitNo, espera hasta el día 1 (UTC) o utiliza una clave con un límite más alto
402FREE_TRIAL_USEDLa prueba gratuita ya se ha utilizado en este dispositivo.No, comprar créditos
403DEVICE_BANNEDEste dispositivo ha sido bloqueado por uso indebidoNo, ponte en contacto con el servicio de asistencia
400BAD_IDEMPOTENCY_KEYIdempotency-Key está vacío, es demasiado largo o contiene espaciosNo, corrige el encabezado.
409IDEMPOTENCY_IN_PROGRESSTodavía hay una solicitud con esta clave en curso. No se ha cobrado nada.Sí, después de Retry-After
409IDEMPOTENCY_REPLAYEsta clave ya ha funcionado. No se ha cobrado nada.No, la primera respuesta incluía la imagen
409IDEMPOTENCY_MISMATCHEsta clave se utilizó con diferentes imágenesNo, utiliza una clave nueva.
413IMAGE_TOO_LARGEUna imagen ocupa más de 15 MBNo, primero hay que reducir la escala
422CONTENT_FILTEREDBloqueado por motivos de moderación de contenidos. Se ha reembolsado el importe.No, utiliza imágenes diferentes
429RATE_LIMITEDDemasiadas solicitudesSí, tras Retry-After segundos
500GENERATION_FAILEDEl motor ha fallado. Se ha devuelto el importe.Sí, una vez

Tareas asíncronas y lotes

HTTPcódigo¿Qué pasó?¿Lo intentas de nuevo?
400BAD_WEBHOOK_URLwebhook_url no es una URL pública httpsNo, corrige la URL
400BATCH_TOO_LARGEMás de 500 artículos, o más de 10 en modo de pruebaNo, divide el lote
402ASYNC_NEEDS_CREDITSLas tareas asíncronas y los lotes consumen los créditos adquiridosNo, compra créditos o utiliza POST /generate
429TOO_MANY_JOBSYa hay 50 tareas asíncronas en ejecución en la cuentaSí, después de Retry-After
500JOB_CREATE_FAILED, BATCH_CREATE_FAILEDNo se ha podido crear. Se han devuelto los créditos.Sí

Un trabajo que falla tras haber sido aceptado muestra el código de eerror.code, tanto en el propio trabajo como en el webhook generation.failed: CONTENT_FILTERED, GENERATION_FAILED o INPUT_FETCH_FAILED (no se ha podido descargar la URL de una imagen). Se reembolsa el crédito correspondiente. Los elementos del lote cancelados muestran el estado CANCELLED.

Otros criterios de valoración

Punto finalHTTPcódigo¿Lo intentas de nuevo?
GET /credits500CREDITS_UNAVAILABLESí
GET /results/:id404NOT_FOUND (desconocido, no es tuyo o tiene más de 7 días)No
DELETE /customers/:id500DELETE_FAILED (no se ha borrado nada)Sí
DELETE /results/:id404NOT_FOUNDNo
DELETE /results/:id500DELETE_FAILEDSí

Manipulación recomendada

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")
}
Advertencia: Nunca vuelvas a intentar un 402 en un bucle. Significa que la cuenta se ha quedado sin créditos.