API de gestión de modelos

GET

api

models

curl --request GET \
  --url https://aihubmix.com/api/v1/models \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {}
  ],
  "model_id": "<string>",
  "model_name": "<string>",
  "developer_id": 123,
  "desc": "<string>",
  "vendor": "<string>",
  "types": "<string>",
  "features": "<string>",
  "input_modalities": "<string>",
  "output_modalities": "<string>",
  "endpoints": "<string>",
  "max_output": 123,
  "context_length": 123,
  "release_date": "<string>",
  "last_updated": "<string>",
  "open_weights": true,
  "schema_checked": true,
  "pricing": {},
  "pricing.input": 123,
  "pricing.output": 123,
  "pricing.cache_read": 123,
  "pricing.cache_write": 123,
  "pricing.tiers": [
    {}
  ],
  "reasoning": true,
  "tool_call": true,
  "reasoning_options": [
    {}
  ],
  "interleaved": {},
  "variant_of": "<string>",
  "variant_kind": "<string>",
  "retire_stage": "<string>",
  "deprecated_at": "<string>",
  "retired_at": "<string>",
  "successor_model": "<string>",
  "promotion": {},
  "promotion.name": "<string>",
  "promotion.off_percent": 123,
  "promotion.time_type": "<string>"
}

Nueva versión de la API

Obtener información de los modelos

Endpoint: GET https://aihubmix.com/api/v1/models Descripción: Recupera información detallada de todos los modelos disponibles.

Descripción de los campos del objeto de modelo

Información básica

array

Array con la lista de información de los modelos

string

Identificador único del modelo, el valor que se usa como parámetro model al llamar a la API

string

Nombre para mostrar del modelo

integer

Número del desarrollador del modelo dentro de la plataforma; se puede usar junto con el parámetro de consulta developer_id para filtrar

string

Descripción de la funcionalidad del modelo (en inglés)

string

Identificador del fabricante del modelo (por ejemplo openai, anthropic, zhipu). Es una numeración independiente de developer_id. Campo opcional; si está ausente, la información no está registrada

string

Tipo de modelo, valores separados por comas. Valores admitidos: llm (modelo de lenguaje grande), image_generation (generación de imágenes), video (generación de video), tts (síntesis de voz), stt (voz a texto), embedding (embeddings), rerank (reordenación), ocr (reconocimiento de texto), search (búsqueda), 3d (generación 3D)

string

Funciones admitidas, valores separados por comas. Valores admitidos: thinking (razonamiento), tools (llamada a herramientas), function_calling (llamada a funciones), web (búsqueda), deepsearch (búsqueda profunda), long_context (contexto largo), structured_outputs (salidas estructuradas)

string

Modalidades de entrada admitidas, valores separados por comas. Valores admitidos: text (texto), image (imagen), audio (audio), video (video), pdf

string

Modalidades de salida admitidas, valores separados por comas. Valores admitidos: text (texto), image (imagen), audio (audio), video (video). Campo opcional; si está ausente, la información no está anotada

string

Protocolos de API disponibles para el modelo, valores separados por comas. Valores admitidos: chat_completions (API Chat Completions), responses (API Responses), claude_api (API Claude Messages), gemini_api (API Gemini). Un valor vacío indica que aún no está anotado

integer

Número máximo de tokens de salida

integer

Tamaño de la ventana de contexto (número máximo de tokens de entrada)

string

Fecha de lanzamiento del modelo, en formato YYYY-MM-DD o YYYY-MM. Campo opcional; si está ausente, la información no está registrada

string

Fecha de la última actualización del modelo; si no hay registro de actualizaciones in situ, coincide con release_date. Campo opcional

boolean

Indica si los pesos del modelo están disponibles para descarga y despliegue propio. false indica que el desarrollador declara de forma explícita que no publica los pesos. Campo opcional; si está ausente, la información no está registrada

boolean

Indica si la plataforma ha completado la verificación de la estructura de los parámetros de solicitud de este modelo

Precios

object

Objeto con la información de precios; todos los precios se expresan en dólares estadounidenses por 1 millón (1M) de tokens

number

Precio de los tokens de entrada (USD / 1M tokens)

number

Precio de los tokens de salida (USD / 1M tokens)

number

Precio de lectura desde caché (USD / 1M tokens, campo opcional)

number

Precio de escritura en caché (USD / 1M tokens, campo opcional)

array

Array de precios por tramos, campo opcional. Cada elemento contiene un objeto tier (type con valor fijo context, size es el umbral de tokens de contexto) y los precios input, output, cache_read y cache_write de ese tramo. Cuando la longitud de contexto de la solicitud supera size, se factura con el precio de ese tramo; los campos input, output y demás del nivel superior corresponden al tramo predeterminado

Capacidades de razonamiento y herramientas

boolean

Indica si el modelo tiene capacidad de razonamiento; es un valor booleano derivado de la normalización de features. Campo opcional; si está ausente, la información no está anotada y la ausencia no implica que el modelo no lo admita

boolean

Indica si el modelo admite la llamada a herramientas; es un valor booleano derivado de la normalización de features. Campo opcional; si está ausente, la información no está anotada y la ausencia no implica que el modelo no lo admita

array

Array de configuraciones de los niveles de razonamiento, campo opcional. Cada elemento incluye type, con los valores: toggle (el razonamiento se puede activar o desactivar), effort (control por niveles; values lista los niveles disponibles y default es el nivel predeterminado), budget_tokens (control por presupuesto de tokens)

object

Medio por el que cada protocolo de API devuelve el contenido de razonamiento, campo opcional; si está ausente, la información no está registrada. Las claves son nombres de protocolo (anthropic.messages, openai.chat_completions, openai.responses, google.gemini) y el valor es true (ese protocolo puede devolver el contenido de razonamiento) o {"field": "reasoning_content"} (el contenido de razonamiento se devuelve mediante ese campo). Consulte la clave correspondiente al protocolo que utilice en su llamada

Variantes y ciclo de vida

string

ID del modelo base, campo opcional. Cuando está presente indica que el model_id actual y el modelo base son el mismo modelo, y solo difieren en el nivel o el preajuste dentro de la plataforma

string

Tipo de variante, aparece junto con variant_of. Valores admitidos: pricing-tier (nivel de precio), channel-tier (nivel de acceso), mode-preset (preajuste de modo), deprecated-alias (alias obsoleto)

string

Etapa del ciclo de vida del modelo, siempre presente en la respuesta. Valores admitidos: active (en servicio normal), deprecated (retirada anunciada, aún se puede llamar). Los modelos que ya dejaron de prestar servicio no aparecen en la respuesta de este endpoint

string

Fecha del anuncio de retirada (formato ISO 8601). Solo se devuelve en la etapa deprecated

string

Fecha prevista de fin de servicio (formato ISO 8601). Campo opcional; solo puede devolverse en la etapa deprecated

string

ID del modelo de reemplazo recomendado para la migración. Campo opcional; solo puede devolverse en la etapa deprecated

Promociones por tiempo limitado

object

Información de la promoción por tiempo limitado, campo opcional; está ausente cuando no hay promoción

string

Nombre de la promoción

integer

Porcentaje de descuento; por ejemplo, 10 indica un 10% de descuento

string

Tipo de regla temporal de la promoción. Valores admitidos: absolute (intervalo de tiempo absoluto; véanse start y end del objeto absolute), daily (franjas horarias fijas cada día; véase daily.ranges), weekly (franjas horarias fijas cada semana; véanse weekdays y ranges del array weekly; weekdays sigue la codificación ISO 8601, el lunes es 1 y el domingo es 7)

Ejemplos de solicitud

import requests

# API Endpoint
url = "https://aihubmix.com/api/v1/models"

response = requests.get(url)
print(response.json())

params = {
    "type": "llm",                   
	"modalities": "text",
	"model": "gpt-5",
	"features": "thinking",
    "sort_by": "context_length",
    "sort_order": "desc"    
}
response = requests.get(url, params=params)
print(response.json())

fetch('https://aihubmix.com/api/v1/models')
  .then(response => response.json())
  .then(data => console.log(data));

const params = new URLSearchParams({
  type: 'llm',
  modalities: 'text',
  model: 'gpt-5',
  features: 'thinking',
  sort_by: 'context_length',
  sort_order: 'desc' 
});

fetch(`https://aihubmix.com/api/v1/models?${params}`)
  .then(response => response.json())
  .then(data => console.log(data));

curl -X GET "https://aihubmix.com/api/v1/models"

curl -X GET "https://aihubmix.com/api/v1/models?type=llm&modalities=text&model=gpt-5&features=thinking&sort_by=context_length&sort_order=desc"

Descripción de los parámetros de la solicitud (para filtrado)

string

Tipo de modelo. Valores admitidos: llm (modelo de lenguaje grande), image_generation (generación de imágenes), video (generación de video), tts (síntesis de voz), stt (voz a texto), embedding (embeddings), rerank (reordenación), ocr (reconocimiento de texto), search (búsqueda), 3d (generación 3D)

string

Modalidades de entrada. Valores admitidos: text (texto), image (imagen), audio (audio), video (video), pdf. Admite consultas de varias modalidades (separadas por comas)

string

Búsqueda difusa por nombre de modelo (admite coincidencia parcial)

string

Funciones del modelo. Valores admitidos: thinking (razonamiento), tools (llamada a herramientas), function_calling (llamada a funciones), web (búsqueda), deepsearch (búsqueda profunda), long_context (contexto largo), structured_outputs (salidas estructuradas). Admite consultas de varias funciones (separadas por comas)

string

Filtrado por protocolo de API. Valores admitidos: chat_completions, responses, claude_api, gemini_api. Admite consultas de varios valores (separados por comas)

integer

Filtrado por número de desarrollador del modelo; el número se indica en el campo de respuesta developer_id

string

Filtrado por etiqueta de modelo, por ejemplo coding (modelos de programación)

boolean

Con el valor true, devuelve solo los modelos cuya estructura de parámetros de solicitud ya fue verificada por la plataforma (es decir, los modelos cuyo campo de respuesta schema_checked es true)

string

Campo de ordenación. Valores admitidos:
• model_ratio: ordena por relación coste-eficacia
• context_length: ordena por longitud de contexto
• coding: prioriza los modelos de programación
• order: ordena por el orden predeterminado

string

Dirección de ordenación. Valores admitidos:
• asc (ascendente)
• desc (descendente)

Ejemplo de respuesta exitosa

{
    "data": [
        {
            "model_id": "gpt-6-astra",
            "model_name": "GPT 6 Astra",
            "developer_id": 12,
            "desc": "GPT-6 Astra is OpenAI's newest and most intelligent model, with industry-leading performance in computer operations, web browsing, software engineering, scientific research, and professional work.",
            "pricing": {
                "cache_read": 1,
                "cache_write": 12.5,
                "input": 10,
                "output": 50,
                "tiers": [
                    {
                        "cache_read": 2,
                        "cache_write": 25,
                        "input": 20,
                        "output": 75,
                        "tier": {
                            "size": 272000,
                            "type": "context"
                        }
                    }
                ]
            },
            "types": "llm",
            "features": "tools,thinking,structured_outputs",
            "input_modalities": "text,image",
            "endpoints": "chat_completions,responses",
            "max_output": 128000,
            "context_length": 1050000,
            "release_date": "2026-09-05",
            "last_updated": "2026-09-05",
            "output_modalities": "text",
            "reasoning": true,
            "tool_call": true,
            "reasoning_options": [
                {
                    "type": "effort",
                    "values": ["low", "medium", "high", "xhigh", "max"],
                    "default": "medium"
                }
            ],
            "interleaved": {
                "openai.responses": true
            },
            "vendor": "openai",
            "open_weights": false,
            "schema_checked": false,
            "retire_stage": "active"
        },
        {
            "model_id": "glm-5.3",
            "model_name": "GLM 5.3",
            "developer_id": 5,
            "desc": "GLM-5.3 is Z.AI's coding and agentic reasoning model, built for complex software engineering, long-running agent tasks, vulnerability analysis, and other demanding workloads.",
            "pricing": {
                "cache_read": 0.2817,
                "input": 1.1268,
                "output": 3.9438
            },
            "types": "llm",
            "features": "thinking,tools,function_calling,structured_outputs",
            "input_modalities": "text",
            "endpoints": "",
            "max_output": 131072,
            "context_length": 1048576,
            "release_date": "2026-08-14",
            "last_updated": "2026-08-14",
            "output_modalities": "text",
            "reasoning": true,
            "tool_call": true,
            "reasoning_options": [
                {
                    "type": "toggle"
                },
                {
                    "type": "effort",
                    "values": ["low", "high", "max"],
                    "default": "max"
                }
            ],
            "interleaved": {
                "anthropic.messages": true,
                "openai.chat_completions": {
                    "field": "reasoning_content"
                }
            },
            "vendor": "zhipu",
            "open_weights": true,
            "schema_checked": false,
            "promotion": {
                "name": "GLM-5.3 limited-time special offer",
                "off_percent": 10,
                "time_type": "daily",
                "daily": {
                    "ranges": ["00:00-23:59"]
                }
            },
            "retire_stage": "active"
        }
    ],
    "message": "",
    "success": true
}

Ejemplos de escenarios de uso

GET https://aihubmix.com/api/v1/models?type=llm

GET https://aihubmix.com/api/v1/models?tag=coding&sort_by=context_length&sort_order=desc

GET https://aihubmix.com/api/v1/models?model=gpt-5

GET https://aihubmix.com/api/v1/models?type=llm&modalities=text,image&features=function_calling&sort_by=model_ratio&sort_order=asc

GET https://aihubmix.com/api/v1/models?sort_by=coding

GET https://aihubmix.com/api/v1/models?endpoints=claude_api

GET https://aihubmix.com/api/v1/models?schema_checked=true

Nota: Al usar la ordenación inteligente para modelos de programación, el sistema muestra primero los modelos etiquetados con coding, y los demás modelos se muestran en el orden predeterminado.

Optimización del rendimiento

Mecanismo de caché

Política de caché: caché HTTP, con una duración de 300 segundos (5 minutos)
Control de caché: Cache-Control: private, max-age=300, stale-while-revalidate=300
Validación de contenido: admite validación mediante hash de contenido con ETag

Ejemplo de uso de la caché

# Conditional request using ETag
curl -H "If-None-Match: \"abc123...\"" \
     https://aihubmix.com/api/v1/models

Si el contenido no se ha actualizado, el servidor devuelve un código de estado 304 Not Modified.

Manejo de errores

{
  "success": false,
  "message": "Invalid request parameter format"
}

{
  "success": false,
  "message": "Internal server error, please try again later"
}

Notas importantes

Integridad de datos: este endpoint devuelve todos los modelos que cumplen los criterios, sin paginación
Compatibilidad de tipos: admite la asignación automática entre identificadores de tipo nuevos y antiguos
- t2t ↔ llm
- t2i ↔ image_generation
- t2v ↔ video
- reranking ↔ rerank
Lógica de filtrado: las condiciones de filtrado múltiples se combinan con un Y lógico (AND)
Regla de ordenación: cuando no se especifica un método de ordenación, los modelos se organizan en el orden predeterminado del sistema
Ciclo de vida: los modelos con retire_stage en deprecated siguen siendo invocables con normalidad; se recomienda consultar los campos successor_model y retired_at para planificar la migración con antelación. Los modelos que ya dejaron de prestar servicio no aparecen en la lista devuelta
Campos opcionales: cuando un campo marcado como opcional está ausente, la información correspondiente no está anotada o registrada; la ausencia no implica que el modelo carezca de esa capacidad

Versión heredada de la API

⚠️ Nota: Los siguientes son endpoints de la API heredada. Se recomienda utilizar la nueva versión de la API para obtener mejor rendimiento y funcionalidades.

Obtener la lista de modelos

Endpoint: GET /v1/models

Si el usuario ha iniciado sesión, recupera la lista de modelos disponibles para el grupo del usuario. Si no se ha iniciado sesión, recupera la lista del grupo default.
Si la cabecera contiene un campo Authorization, consulta la lista de modelos configurados para el token correspondiente.

Ejemplo de respuesta:

{
  "data": [
    {
      "id": "gpt-4o-mini",
      "object": "model",
      "created": 1626777600,
      "owned_by": "OpenAI",
      "permission": [
        {
          "id": "modelperm-LwHkVFn8AcMItP432fKKDIKJ",
          "object": "model_permission",
          "created": 1626777600,
          "allow_create_engine": true,
          "allow_sampling": true,
          "allow_logprobs": true,
          "allow_search_indices": false,
          "allow_view": true,
          "allow_fine_tuning": false,
          "organization": "*",
          "group": null,
          "is_blocking": false
        }
      ],
      "root": "gpt-4o-mini",
      "parent": null
    }
  ]
}

Respuesta

Código de estado	Significado	Descripción	Modelo de datos
200	OK	ninguno	En línea

Estructura de datos de la respuesta

Código de estado 200

Nombre	Tipo	Obligatorio	Descripción
» data	[object]	true	ninguno
»» id	string	true	ID del modelo
»» object	string	true	`model`
»» created	integer	true	Marca temporal de creación
»» owned_by	string	true	Desarrollador
»» permission	[object]¦null	true	ninguno
»»» id	string	true	ninguno
»»» object	string	true	ninguno
»»» created	integer	true	ninguno
»»» allow_create_engine	boolean	true	ninguno
»»» allow_sampling	boolean	true	ninguno
»»» allow_logprobs	boolean	true	ninguno
»»» allow_search_indices	boolean	true	ninguno
»»» allow_view	boolean	true	ninguno
»»» allow_fine_tuning	boolean	true	ninguno
»»» organization	string	true	ninguno
»»» group	null	true	ninguno
»»» is_blocking	boolean	true	ninguno
»» root	string	true	Nombre del modelo raíz
»» parent	null	true	Modelo padre

Obtener información del modelo

Endpoint: GET /v1/models/:model

Parámetros de la solicitud

Nombre	Ubicación	Tipo	Obligatorio	Descripción
model	path	string	true	ID del modelo

Ejemplo de respuesta:

200 Response

{
  "id": "string",
  "object": "string",
  "created": 0,
  "owned_by": "string",
  "permission": [
    {
      "id": "string",
      "object": "string",
      "created": 0,
      "allow_create_engine": true,
      "allow_sampling": true,
      "allow_logprobs": true,
      "allow_search_indices": true,
      "allow_view": true,
      "allow_fine_tuning": true,
      "organization": "string",
      "group": null,
      "is_blocking": true
    }
  ],
  "root": "string",
  "parent": null
}

Respuesta

Código de estado	Significado	Descripción	Modelo de datos
200	OK	ninguno	En línea

Estructura de datos de la respuesta

Código de estado 200

Nombre	Tipo	Obligatorio	Descripción
id	string	true	ID del modelo
object	string	true	`model`
created	integer	true	Marca temporal de creación
owned_by	string	true	Desarrollador
permission	[object]	true	ninguno
» id	string	false	ninguno
» object	string	false	ninguno
» created	integer	false	ninguno
» allow_create_engine	boolean	false	ninguno
» allow_sampling	boolean	false	ninguno
» allow_logprobs	boolean	false	ninguno
» allow_search_indices	boolean	false	ninguno
» allow_view	boolean	false	ninguno
» allow_fine_tuning	boolean	false	ninguno
» organization	string	false	ninguno
» group	null	false	ninguno
» is_blocking	boolean	false	ninguno
root	string	true	Nombre del modelo raíz
parent	null	true	Modelo padre

Última actualización: 2026-09-18

⌘I

API de gestión de modelos

curl --request GET \
  --url https://aihubmix.com/api/v1/models \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {}
  ],
  "model_id": "<string>",
  "model_name": "<string>",
  "developer_id": 123,
  "desc": "<string>",
  "vendor": "<string>",
  "types": "<string>",
  "features": "<string>",
  "input_modalities": "<string>",
  "output_modalities": "<string>",
  "endpoints": "<string>",
  "max_output": 123,
  "context_length": 123,
  "release_date": "<string>",
  "last_updated": "<string>",
  "open_weights": true,
  "schema_checked": true,
  "pricing": {},
  "pricing.input": 123,
  "pricing.output": 123,
  "pricing.cache_read": 123,
  "pricing.cache_write": 123,
  "pricing.tiers": [
    {}
  ],
  "reasoning": true,
  "tool_call": true,
  "reasoning_options": [
    {}
  ],
  "interleaved": {},
  "variant_of": "<string>",
  "variant_kind": "<string>",
  "retire_stage": "<string>",
  "deprecated_at": "<string>",
  "retired_at": "<string>",
  "successor_model": "<string>",
  "promotion": {},
  "promotion.name": "<string>",
  "promotion.off_percent": 123,
  "promotion.time_type": "<string>"
}

Endpoints de modelo

API de plataforma

API de gestión de modelos

Nueva versión de la API

Obtener información de los modelos

Descripción de los campos del objeto de modelo

Información básica

Precios

Capacidades de razonamiento y herramientas

Variantes y ciclo de vida

Promociones por tiempo limitado

Ejemplos de solicitud

Descripción de los parámetros de la solicitud (para filtrado)

Ejemplo de respuesta exitosa

Ejemplos de escenarios de uso

Optimización del rendimiento

Mecanismo de caché

Ejemplo de uso de la caché

Manejo de errores

Notas importantes

Versión heredada de la API

Obtener la lista de modelos

Respuesta

Estructura de datos de la respuesta

Obtener información del modelo

Parámetros de la solicitud

Respuesta

Estructura de datos de la respuesta

​Nueva versión de la API

​Obtener información de los modelos

​Descripción de los campos del objeto de modelo

​Información básica

​Precios

​Capacidades de razonamiento y herramientas

​Variantes y ciclo de vida

​Promociones por tiempo limitado

​Ejemplos de solicitud

​Descripción de los parámetros de la solicitud (para filtrado)

​Ejemplo de respuesta exitosa

​Ejemplos de escenarios de uso

​Optimización del rendimiento

​Mecanismo de caché

​Ejemplo de uso de la caché

​Manejo de errores

​Notas importantes

​Versión heredada de la API

​Obtener la lista de modelos

​Respuesta

​Estructura de datos de la respuesta

​Obtener información del modelo

​Parámetros de la solicitud

​Respuesta

​Estructura de datos de la respuesta

Nueva versión de la API

Obtener información de los modelos

Descripción de los campos del objeto de modelo

Información básica

Precios

Capacidades de razonamiento y herramientas

Variantes y ciclo de vida

Promociones por tiempo limitado

Ejemplos de solicitud

Descripción de los parámetros de la solicitud (para filtrado)

Ejemplo de respuesta exitosa

Ejemplos de escenarios de uso

Optimización del rendimiento

Mecanismo de caché

Ejemplo de uso de la caché

Manejo de errores

Notas importantes

Versión heredada de la API

Obtener la lista de modelos

Respuesta

Estructura de datos de la respuesta

Obtener información del modelo

Parámetros de la solicitud

Respuesta

Estructura de datos de la respuesta