---
title: "Consultar modelos disponibles API"
description: "Los dos formatos de respuesta de GET /v1/models, la lectura de los ID de modelo, y la diferencia entre la visibilidad de un modelo y su disponibilidad real para invocarlo."
headingIds: {"Formato OpenAI":"section-1","Formato Anthropic":"section-2","Cómo usar los resultados de la consulta":"section-3","Lista vacía o faltan modelos":"section-4"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentación mantenida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fuentes y correcciones](https://1zheai.com/en/editorial/).

¿Encontraste un error? [Contacta con soporte](mailto:support@1zheai.com) indicando la dirección de la página y una descripción. No envíes claves de API ni credenciales de cuenta.

</aside>
Primero consulta los modelos, luego escribe la solicitud. `GET https://1zheai.com/v1/models` devuelve los modelos visibles bajo la clave actual, el grupo y las restricciones de modelo, sin necesidad de enviar una solicitud de inferencia.

## Formato OpenAI

```bash
curl --fail-with-body --connect-timeout 10 --max-time 30 \
  https://1zheai.com/v1/models \
  -H "Authorization: Bearer $ONEZHE_API_KEY"
```

A continuación se muestra un esquema simplificado de la estructura; la lista depende de lo que se devuelva realmente:

```json
{
  "object": "list",
  "data": [{"id": "gpt-5.6-sol", "object": "model"}]
}
```

Cuando está instalado `jq`, puedes añadir `| jq -r '.data[].id'` después de la solicitud, mostrando un ID de modelo por línea. No confundas el `model_name` de la interfaz pública de precios con el `id` de aquí.

## Formato Anthropic

Al usar las siguientes dos cabeceras de solicitud, la misma ruta devuelve datos al estilo de Anthropic:

```bash
curl --fail-with-body https://1zheai.com/v1/models \
  -H "x-api-key: $ONEZHE_API_KEY" \
  -H "anthropic-version: 2023-06-01"
```

Presta atención a `data[].id`, `data[].display_name` y `has_more`. Después de cambiar el método de autenticación, no sigas analizando la respuesta con la estructura del otro formato.

## Cómo usar los resultados de la consulta

1. Copia el ID completo desde `data[].id`, conservando mayúsculas, minúsculas, guiones y sufijos de fecha.
2. Verifica el tipo de interfaz de ese modelo en el [catálogo de modelos de la consola](https://1zheai.com/model-catalog?lng=es).
3. Valida con una solicitud de texto mínimo y luego añade gradualmente imágenes, herramientas u otros parámetros.

La lista de modelos no es una comprobación de salud en tiempo real ni incluye todas las restricciones de parámetros. Un modelo puede estar visible pero, si temporalmente no hay un upstream disponible, la solicitud aún puede fallar; el monitoreo de disponibilidad HTTP del sitio oficial tampoco significa que todos los modelos puedan inferir con éxito.

## Lista vacía o faltan modelos

Verifica las restricciones de modelo y el grupo de la clave; los modelos mostrados en la página pública de precios no necesariamente están abiertos a cada clave. Para 401, primero revisa el estado de la clave; para 403, revisa las condiciones de acceso; consulta los pasos detallados en [códigos de error y solución de problemas](/es/docs/troubleshooting/).

Para las series de modelos y recomendaciones de selección, consulta [modelos compatibles](/es/docs/models/).