Como listar modelos com GET /v1/models

Resposta direta

Use GET /v1/models para descobrir quais identificadores estão disponíveis no momento da chamada. O contrato segue o formato OpenAI: a resposta raiz contém object: "list" e um array data com objetos de modelo. O campo id é o valor que deve ser enviado no campo model de uma chamada de chat.

Uma página de documentação pode explicar o catálogo, mas não deve ser tratada como inventário em tempo real. Modelos são adicionados, removidos ou substituídos. O endpoint é a fonte de verdade operacional.

Requisição com curl

export MANDAPI_API_KEY="COLE_SUA_CHAVE_AQUI"

curl -sS https://api.mandapi.com/v1/models \
  -H "Authorization: Bearer $MANDAPI_API_KEY"

Uma resposta saudável tem esta forma geral:

{
  "object": "list",
  "data": [
    {
      "id": "identificador-do-modelo",
      "object": "model",
      "created": 0,
      "owned_by": "fornecedor"
    }
  ]
}

A MandAPI pode acrescentar campos úteis, como informações sobre o tipo de endpoint suportado. Um cliente robusto deve ignorar campos desconhecidos e depender apenas dos campos que realmente precisa.

Exemplo em Python

import os
import requests

response = requests.get(
    "https://api.mandapi.com/v1/models",
    headers={"Authorization": f"Bearer {os.environ['MANDAPI_API_KEY']}"},
    timeout=30,
)

response.raise_for_status()
for model in response.json()["data"]:
    print(model["id"], model.get("owned_by", ""))

Exemplo com JavaScript

const response = await fetch("https://api.mandapi.com/v1/models", {
  headers: {
    Authorization: `Bearer ${process.env.MANDAPI_API_KEY}`,
  },
});

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

const body = await response.json();
for (const model of body.data) {
  console.log(model.id, model.owned_by ?? "");
}

Como validar antes de usar em produção

1. Confirme HTTP 200 e object: "list".
2. Verifique se o array data não está vazio.
3. Escolha o id exato — não invente prefixos, sufixos ou aliases.
4. Faça uma chamada pequena em /v1/chat/completions usando esse mesmo id.
5. Guarde a data da consulta e o identificador da resposta para auditoria.

O que o nome do modelo não prova

O id identifica um recurso; ele não descreve sozinho todas as suas propriedades. Não presuma, pelo nome:

• preço por token;
• janela de contexto;
• suporte a streaming;
• suporte a tool calling;
• qualidade em código, redação ou agentes;
• disponibilidade garantida no futuro.

Consulte a página de Modelos, os Preços e testes próprios com o seu caso de uso. Para comparar qualidade e custo com metodologia explícita, use o Radar de Modelos.

Cache e mudança de catálogo

Um cache curto evita consultar o endpoint em toda requisição, mas precisa ser invalidado quando a lista muda. Uma estratégia simples:

• guarde id, horário da consulta e origem;
• use TTL curto para seleção interativa;
• permita atualização manual no painel ou na operação;
• registre o último catálogo válido para diagnóstico;
• não faça fallback silencioso para um modelo removido.

Erros comuns

Próximos passos

• Faça a primeira chamada com Início rápido.
• Veja como proteger a credencial em Chaves de API.
• Compare alternativas no Radar de Modelos.
• Trate falhas com os guias de erro.

Fontes

• OpenAI — API Reference, List models: https://platform.openai.com/docs/api-reference/models/list
• MandAPI — Modelos: https://mandapi.com/docs/models
• MandAPI — Início rápido: https://mandapi.com/docs/quickstart

Última verificação editorial: 20 de setembro de 2026. O catálogo pode mudar; consulte o endpoint antes de publicar uma integração.

curl -sS https://api.mandapi.com/v1/models \
  -H "Authorization: Bearer $MANDAPI_API_KEY" \
  | jq '.data[].id'