`GET /v1/models`

Consulta el recurso propio seleccionado o el estado del flujo sin iniciar una generación.

Ejemplo de solicitud#

curl 'https://platform.tongai.io/v1/models' \  -H "Authorization: Bearer $TONG_API_KEY"

Configuración

curl --version

Autenticació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.

catalog:read

Parámetros#

modelstringOpcional

Elige un ID de modelo público de Tong del descubrimiento actual.

operationstringOpcional

Selecciona un flujo compatible con el modelo elegido.

Cuerpo de solicitud#

Este endpoint no tiene cuerpo de solicitud.

Esquema de respuesta#

Respuesta

JSON

{  "workflows": []}

`HTTP 200`

application/json

text_modelsobject[]Opcional

Mostrar campos anidados

idstringObligatorio

namestringObligatorio

context_tokensintegerObligatorio

Máximo: 9007199254740991.

max_output_tokensintegerObligatorio

Máximo: 9007199254740991.

unitstringObligatorio

Valores permitidos"THOUSAND_TOKENS"

input_creditsstringObligatorio

Una cadena decimal con seis decimales, por ejemplo 1.250000.

output_creditsstringObligatorio

Una cadena decimal con seis decimales, por ejemplo 1.250000.

cached_input_creditsstringObligatorio

Una cadena decimal con seis decimales, por ejemplo 1.250000.

cache_write_creditsstringObligatorio

Una cadena decimal con seis decimales, por ejemplo 1.250000.

pricingstringObligatorio

Valores permitidos"display_maximum"

requires_exact_quotebooleanObligatorio

Valores permitidostrue

workflowsobject[]Obligatorio

Elementos máximos: 10000.

Mostrar campos anidados

operationstringObligatorio

modelstringObligatorio

namestringObligatorio

model_namestringObligatorio

resolutionstring | nullObligatorio

unitstringObligatorio

creditsstring | nullObligatorio

Una cadena decimal con seis decimales, por ejemplo 1.250000.

base_creditsstring | nullObligatorio

Una cadena decimal con seis decimales, por ejemplo 1.250000.

requires_exact_quotebooleanOpcional

Valor predeterminado: false.

pricingstringOpcional

Valores permitidos"configuration_quote""display_rate"

Valor predeterminado: "display_rate".

discount_percentnumberObligatorio

Mínimo: 0.

Máximo: 100.

Errores y límites#

HTTP	Error	Recuperación
`400`	Solicitud no válida`REQUEST_INVALID`	Corrige los campos indicados por el error antes de reintentar.
`401`	Credencial no válida`CREDENTIAL_INVALID`	Comprueba la credencial, su vencimiento y si fue revocada.
`402`	Créditos insuficientes`INSUFFICIENT_CREDITS`	Añade créditos a la cuenta de la credencial y continúa el trabajo guardado.
`403`	Permiso denegado`SCOPE_REQUIRED`	Usa una credencial con los permisos necesarios y acceso al recurso seleccionado.
`404`	Recurso no disponible`RESOURCE_UNAVAILABLE`	Comprueba el ID del recurso y que pertenezca a la cuenta autorizada.
`409`	Conflicto de intención`IDEMPOTENCY_CONFLICT`	Reutiliza una intención solo con su solicitud original. Usa un nuevo UUID para otra acción.
`429`	Límite de solicitudes alcanzado`RATE_LIMITED`	Espera el intervalo de Retry-After antes de reintentar la misma solicitud.
`503`	No disponible temporalmente`DEPENDENCY_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.