API de Gerenciamento 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>"
}

Nova versão da API

Obter informações dos modelos da plataforma

Endpoint: GET https://aihubmix.com/api/v1/models Descrição: Obtém informações detalhadas de todos os modelos disponíveis.

Descrição dos campos do objeto de modelo

Informações básicas

array

Array com a lista de informações dos modelos

string

Identificador único do modelo, ou seja, o valor do parâmetro model usado ao chamar a API

string

Nome de exibição do modelo

integer

Número do desenvolvedor do modelo dentro da plataforma; pode ser usado com o parâmetro de requisição developer_id para filtrar

string

Descrição das funcionalidades do modelo (em inglês)

string

Identificador do fabricante do modelo (por exemplo openai, anthropic, zhipu). É um sistema de numeração independente de developer_id. Campo opcional; a ausência indica que a informação não foi catalogada

string

Tipo do modelo, separado por vírgulas. Valores suportados: llm (modelo de linguagem de grande porte), image_generation (modelo de geração de imagens), video (modelo de geração de vídeo), tts (modelo de síntese de fala), stt (modelo de fala para texto), embedding (modelo de embeddings), rerank (modelo de reordenação), ocr (modelo de reconhecimento de texto), search (modelo de busca), 3d (modelo de geração 3D)

string

Funcionalidades suportadas, separadas por vírgulas. Valores suportados: thinking (suporta raciocínio), tools (suporta chamada de ferramentas), function_calling (suporta chamada de funções), web (suporta busca), deepsearch (suporta busca profunda), long_context (modelo de contexto longo), structured_outputs (saída estruturada)

string

Modalidades de entrada suportadas, separadas por vírgulas. Valores suportados: text (texto), image (imagem), audio (áudio), video (vídeo), pdf

string

Modalidades de saída suportadas, separadas por vírgulas. Valores suportados: text (texto), image (imagem), audio (áudio), video (vídeo). Campo opcional; a ausência indica que a informação não foi anotada

string

Protocolos de API disponíveis para o modelo, separados por vírgulas. Valores suportados: chat_completions (API Chat Completions), responses (API Responses), claude_api (API Claude Messages), gemini_api (API Gemini). Vazio indica que ainda não foi anotado

integer

Número máximo de tokens de saída

integer

Tamanho da janela de contexto (número máximo de tokens de entrada)

string

Data de lançamento do modelo, no formato YYYY-MM-DD ou YYYY-MM. Campo opcional; a ausência indica que a informação não foi catalogada

string

Data da atualização mais recente do modelo; quando não há registro de atualização no mesmo ID, é igual a release_date. Campo opcional

boolean

Indica se os pesos do modelo estão abertos para download e implantação própria. false indica que o fabricante declarou explicitamente que não publica os pesos. Campo opcional; a ausência indica que a informação não foi catalogada

boolean

Indica se a plataforma concluiu a verificação da estrutura dos parâmetros de requisição desse modelo

Preços

object

Objeto de informações de preço; todos os preços estão em dólares americanos por 1 milhão (1M) de tokens

number

Preço dos tokens de entrada (USD / 1M tokens)

number

Preço dos tokens de saída (USD / 1M tokens)

number

Preço de leitura de cache (USD / 1M tokens, campo opcional)

number

Preço de escrita de cache (USD / 1M tokens, campo opcional)

array

Array de faixas de preço, campo opcional. Cada elemento contém um objeto tier (type fixo em context, size é o limite em número de tokens de contexto) e os preços input, output, cache_read, cache_write dessa faixa. Quando o comprimento do contexto da requisição excede size, a cobrança segue o preço dessa faixa; os campos input, output e demais no nível superior são os preços da faixa padrão

Capacidades de raciocínio e ferramentas

boolean

Indica se o modelo possui capacidade de raciocínio; valor booleano normalizado a partir de features. Campo opcional; a ausência indica que a informação não foi anotada e não significa que o modelo não suporte

boolean

Indica se o modelo suporta chamada de ferramentas; valor booleano normalizado a partir de features. Campo opcional; a ausência indica que a informação não foi anotada e não significa que o modelo não suporte

array

Array de configurações de níveis de raciocínio, campo opcional. Cada item contém type, com valores suportados: toggle (raciocínio pode ser ativado ou desativado), effort (controle por nível; values lista os níveis disponíveis e default é o nível padrão), budget_tokens (controle por orçamento de tokens)

object

Forma de retorno do conteúdo de raciocínio em cada protocolo de API, campo opcional; a ausência indica que a informação não foi catalogada. As chaves são nomes de protocolo (anthropic.messages, openai.chat_completions, openai.responses, google.gemini) e o valor é true (o protocolo pode retornar o conteúdo de raciocínio) ou {"field": "reasoning_content"} (o conteúdo de raciocínio é retornado por esse campo). Consulte a chave correspondente ao protocolo realmente usado na chamada

Variantes e ciclo de vida

string

ID do modelo principal, campo opcional. Quando presente, indica que o model_id atual e o modelo principal são o mesmo modelo, diferindo apenas na faixa ou predefinição dentro da plataforma

string

Tipo de variante, sempre presente junto com variant_of. Valores suportados: pricing-tier (faixa de preço), channel-tier (faixa de acesso), mode-preset (predefinição de modo), deprecated-alias (alias descontinuado)

string

Estágio do ciclo de vida do modelo, sempre retornado. Valores suportados: active (em operação normal), deprecated (descontinuação anunciada, ainda pode ser chamado). Modelos que já encerraram o serviço não aparecem na resposta desta API

string

Data do anúncio de descontinuação (formato ISO 8601). Retornado apenas no estágio deprecated

string

Data planejada de encerramento do serviço (formato ISO 8601). Campo opcional; pode ser retornado apenas no estágio deprecated

string

ID do modelo substituto recomendado para migração. Campo opcional; pode ser retornado apenas no estágio deprecated

Promoções por tempo limitado

object

Informações de promoção por tempo limitado, campo opcional; ausente quando não há promoção

string

Nome da campanha promocional

integer

Percentual de desconto; por exemplo, 10 indica 10% de desconto

string

Tipo de regra de tempo da promoção. Valores suportados: absolute (intervalo de tempo absoluto, ver start e end no objeto absolute), daily (períodos fixos diários, ver daily.ranges), weekly (períodos fixos semanais, ver weekdays e ranges no array weekly; weekdays segue a codificação ISO 8601, segunda-feira é 1 e domingo é 7)

Exemplos de requisição

import requests

# Endereço do 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"

Descrição dos parâmetros de requisição (para filtragem)

string

Tipo do modelo. Valores suportados: llm (modelo de linguagem de grande porte), image_generation (modelo de geração de imagens), video (modelo de geração de vídeo), tts (modelo de síntese de fala), stt (modelo de fala para texto), embedding (modelo de embeddings), rerank (modelo de reordenação), ocr (modelo de reconhecimento de texto), search (modelo de busca), 3d (modelo de geração 3D)

string

Modalidade de entrada. Valores suportados: text (texto), image (imagem), audio (áudio), video (vídeo), pdf. Suporta consulta multimodal (separada por vírgulas)

string

Busca aproximada pelo nome do modelo (suporta correspondência parcial)

string

Funcionalidades do modelo. Valores suportados: thinking (suporta raciocínio), tools (suporta chamada de ferramentas), function_calling (suporta chamada de funções), web (suporta busca), deepsearch (suporta busca profunda), long_context (modelo de contexto longo), structured_outputs (saída estruturada). Suporta consulta de múltiplas funcionalidades (separadas por vírgulas)

string

Filtro por protocolo de API. Valores suportados: chat_completions, responses, claude_api, gemini_api. Suporta consulta de múltiplos valores (separados por vírgulas)

integer

Filtra pelo número do desenvolvedor do modelo; o número está no campo de resposta developer_id

string

Filtra por tag do modelo, por exemplo coding (modelos de programação)

boolean

Quando true, retorna apenas os modelos cuja estrutura de parâmetros de requisição já foi verificada pela plataforma (ou seja, modelos com o campo de resposta schema_checked igual a true)

string

Campo de ordenação. Valores suportados:
• model_ratio: ordena por custo-benefício
• context_length: ordena por comprimento de contexto
• coding: prioriza modelos de programação
• order: ordena pela ordem padrão

string

Direção da ordenação. Valores suportados:
• asc (crescente)
• desc (decrescente)

Exemplo de resposta bem-sucedida

{
    "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
}

Exemplos de cenários 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

Observação: Ao usar a ordenação inteligente de modelos de programação, o sistema exibe primeiro os modelos com a tag coding; os demais modelos seguem a ordem padrão.

Otimização de desempenho

Mecanismo de cache

Política de cache: cache HTTP, duração de 300 segundos (5 minutos)
Controle de cache: Cache-Control: private, max-age=300, stale-while-revalidate=300
Validação de conteúdo: suporta validação por hash de conteúdo com ETag

Exemplo de uso de cache

# Requisição condicional com ETag
curl -H "If-None-Match: \"abc123...\"" \
     https://aihubmix.com/api/v1/models

Se o conteúdo não foi atualizado, o servidor retorna o código de status 304 Not Modified.

Tratamento de erros

{
  "success": false,
  "message": "Formato de parâmetro de requisição inválido"
}

{
  "success": false,
  "message": "Erro interno do servidor, tente novamente mais tarde"
}

Observações importantes

Integridade dos dados: este endpoint retorna todos os modelos que atendem aos critérios, sem paginação
Compatibilidade de tipos: suporta mapeamento automático entre identificadores de tipo novos e antigos
- t2t ↔ llm
- t2i ↔ image_generation
- t2v ↔ video
- reranking ↔ rerank
Lógica de filtragem: múltiplas condições de filtro são combinadas com a relação lógica E (AND)
Regra de ordenação: quando nenhum método de ordenação é especificado, os modelos seguem a ordem predefinida do sistema
Ciclo de vida: modelos com retire_stage igual a deprecated ainda podem ser chamados normalmente; recomenda-se consultar os campos successor_model e retired_at para planejar a migração com antecedência. Modelos que já encerraram o serviço não aparecem na lista retornada
Campos opcionais: quando um campo marcado como opcional está ausente, isso indica que a informação não foi anotada ou catalogada; a ausência não significa que o modelo não possua a capacidade correspondente

Legacy API Version

⚠️ Note: O seguinte are legacy API endpoints. Recomenda-se to use the new API version for better performance and features.

Get Model List

Endpoint: GET /v1/models

If a user is logged in, it retrieves the list of available models for the user’s group. If no user is logged in, it retrieves the list for the default group.
If the header contains an Authorization field, it queries the list of models configured for the corresponding token.

Response Example:

{
  "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
    }
  ]
}

Response

Código de Status	Meaning	Description	Modelo de Dados
200	OK	none	Inline

Response Data Structure

Código de Status 200

Name	Type	Required	Description
» data	[object]	true	none
»» id	string	true	Model ID
»» object	string	true	`model`
»» created	integer	true	Timestamp of creation
»» owned_by	string	true	Developer
»» permission	[object]¦null	true	none
»»» id	string	true	none
»»» object	string	true	none
»»» created	integer	true	none
»»» allow_create_engine	boolean	true	none
»»» allow_sampling	boolean	true	none
»»» allow_logprobs	boolean	true	none
»»» allow_search_indices	boolean	true	none
»»» allow_view	boolean	true	none
»»» allow_fine_tuning	boolean	true	none
»»» organization	string	true	none
»»» group	null	true	none
»»» is_blocking	boolean	true	none
»» root	string	true	Root model name
»» parent	null	true	Parent model

Get Informações dos Modelos

Endpoint: GET /v1/models/:model

Parâmetros da Requisição

Name	In	Type	Required	Description
model	path	string	true	Model ID

Response Example:

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
}

Response

Código de Status	Meaning	Description	Modelo de Dados
200	OK	none	Inline

Response Data Structure

Código de Status 200

Name	Type	Required	Description
id	string	true	Model ID
object	string	true	`model`
created	integer	true	Timestamp of creation
owned_by	string	true	Developer
permission	[object]	true	none
» id	string	false	none
» object	string	false	none
» created	integer	false	none
» allow_create_engine	boolean	false	none
» allow_sampling	boolean	false	none
» allow_logprobs	boolean	false	none
» allow_search_indices	boolean	false	none
» allow_view	boolean	false	none
» allow_fine_tuning	boolean	false	none
» organization	string	false	none
» group	null	false	none
» is_blocking	boolean	false	none
root	string	true	Root model name
parent	null	true	Parent model

Última atualização: 2026-09-18

⌘I

API de Gerenciamento 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 Gerenciamento de Modelos

Nova versão da API

Obter informações dos modelos da plataforma

Descrição dos campos do objeto de modelo

Informações básicas

Preços

Capacidades de raciocínio e ferramentas

Variantes e ciclo de vida

Promoções por tempo limitado

Exemplos de requisição

Descrição dos parâmetros de requisição (para filtragem)

Exemplo de resposta bem-sucedida

Exemplos de cenários de uso

Otimização de desempenho

Mecanismo de cache

Exemplo de uso de cache

Tratamento de erros

Observações importantes

Legacy API Version

Get Model List

Response

Response Data Structure

Get Informações dos Modelos

Parâmetros da Requisição

Response

Response Data Structure

​Nova versão da API

​Obter informações dos modelos da plataforma

​Descrição dos campos do objeto de modelo

​Informações básicas

​Preços

​Capacidades de raciocínio e ferramentas

​Variantes e ciclo de vida

​Promoções por tempo limitado

​Exemplos de requisição

​Descrição dos parâmetros de requisição (para filtragem)

​Exemplo de resposta bem-sucedida

​Exemplos de cenários de uso

​Otimização de desempenho

​Mecanismo de cache

​Exemplo de uso de cache

​Tratamento de erros

​Observações importantes

​Legacy API Version

​Get Model List

​Response

​Response Data Structure

​Get Informações dos Modelos

​Parâmetros da Requisição

​Response

​Response Data Structure

Nova versão da API

Obter informações dos modelos da plataforma

Descrição dos campos do objeto de modelo

Informações básicas

Preços

Capacidades de raciocínio e ferramentas

Variantes e ciclo de vida

Promoções por tempo limitado

Exemplos de requisição

Descrição dos parâmetros de requisição (para filtragem)

Exemplo de resposta bem-sucedida

Exemplos de cenários de uso

Otimização de desempenho

Mecanismo de cache

Exemplo de uso de cache

Tratamento de erros

Observações importantes

Legacy API Version

Get Model List

Response

Response Data Structure

Get Informações dos Modelos

Parâmetros da Requisição

Response

Response Data Structure