Consultar modelos disponibles API

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.

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

1
curl --fail-with-body --connect-timeout 10 --max-time 30 \
2
  https://1zheai.com/v1/models \
3
  -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:

1
{
2
  "object": "list",
3
  "data": [{"id": "gpt-5.6-sol", "object": "model"}]
4
}

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:

1
curl --fail-with-body https://1zheai.com/v1/models \
2
  -H "x-api-key: $ONEZHE_API_KEY" \
3
  -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

Copia el ID completo desde data[].id, conservando mayúsculas, minúsculas, guiones y sufijos de fecha.
Verifica el tipo de interfaz de ese modelo en el catálogo de modelos de la consola.
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.

Para las series de modelos y recomendaciones de selección, consulta modelos compatibles.