GET /v1/assets/{id}
Consulta el recurso propio seleccionado o el estado del flujo sin iniciar una generación.
Ejemplo de solicitud#
curl 'https://platform.tongai.io/v1/assets/aaaaaaaaaaaaaaaaaaaaaaaa' \ -H "Authorization: Bearer $TONG_API_KEY"Configuración
curl --versionAutenticación#
Usa una clave API en tu servidor para tu cuenta, u OAuth para la cuenta de cada cliente. Nunca envíes claves en instrucciones ni argumentos.
assets:readParámetros#
idstringObligatorioUn ID hexadecimal de 24 caracteres.
Cuerpo de solicitud#
Este endpoint no tiene cuerpo de solicitud.
Esquema de respuesta#
{}HTTP 200
application/jsonobjectErrores y límites#
| HTTP | Error | Recuperación |
|---|---|---|
400 | Solicitud no válidaREQUEST_INVALID | Corrige los campos indicados por el error antes de reintentar. |
401 | Credencial no válidaCREDENTIAL_INVALID | Comprueba la credencial, su vencimiento y si fue revocada. |
402 | Créditos insuficientesINSUFFICIENT_CREDITS | Añade créditos a la cuenta de la credencial y continúa el trabajo guardado. |
403 | Permiso denegadoSCOPE_REQUIRED | Usa una credencial con los permisos necesarios y acceso al recurso seleccionado. |
404 | Recurso no disponibleRESOURCE_UNAVAILABLE | Comprueba el ID del recurso y que pertenezca a la cuenta autorizada. |
409 | Conflicto de intenciónIDEMPOTENCY_CONFLICT | Reutiliza una intención solo con su solicitud original. Usa un nuevo UUID para otra acción. |
429 | Límite de solicitudes alcanzadoRATE_LIMITED | Espera el intervalo de Retry-After antes de reintentar la misma solicitud. |
503 | No disponible temporalmenteDEPENDENCY_UNAVAILABLE | Espera Retry-After y reintenta con la misma intención. Consulta la operación guardada tras un tiempo de espera. |
AutenticaciónLas claves API cobran a la cuenta propietaria. OAuth permite a cada usuario conectado usar sus créditos.Errores y límites de solicitudesComprende los errores, reintenta de forma segura y recupera generaciones fallidas.Solicitudes y registrosUna solicitud aceptada no es una generación terminada. Sigue el trabajo hasta que el resultado esté listo.