---
title: "Consultar modelos disponíveis via API"
description: "Os dois formatos de resposta de GET /v1/models, como ler os IDs dos modelos e a diferença entre visibilidade do modelo e capacidade real de chamada."
headingIds: {"Formato OpenAI":"section-1","Formato Anthropic":"section-2","Como usar os resultados da consulta":"section-3","Lista vazia ou modelos ausentes":"section-4"}
---

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

Documentação mantida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fontes e correções](https://1zheai.com/en/editorial/).

Encontrou um erro? [Contate o suporte](mailto:support@1zheai.com) com o endereço da página e uma descrição. Não envie chaves de API ou credenciais de conta.

</aside>
Primeiro consulte os modelos, depois escreva a requisição. `GET https://1zheai.com/v1/models` retorna os modelos visíveis sob a chave atual, o grupo e as restrições de modelo, sem necessidade de enviar uma requisição de inferência.

## Formato OpenAI

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

Abaixo está um esquema simplificado da estrutura; a lista é definida pelo retorno real:

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

Com `jq` instalado, você pode adicionar `| jq -r '.data[].id'` após a requisição, exibindo um ID de modelo por linha. Não confunda o `model_name` da interface pública de preços com o `id` aqui.

## Formato Anthropic

Ao usar os dois cabeçalhos a seguir, o mesmo caminho retorna dados no estilo Anthropic:

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

Observe `data[].id`, `data[].display_name` e `has_more`. Após trocar o método de autenticação, não continue analisando a resposta com a estrutura do outro formato.

## Como usar os resultados da consulta

1. Copie o ID completo de `data[].id`, preservando maiúsculas/minúsculas, hífens e o sufixo de data.
2. Confirme o tipo de interface do modelo no [catálogo de modelos do console](https://1zheai.com/model-catalog?lng=pt).
3. Valide com uma requisição de texto mínima e, em seguida, adicione gradualmente imagens, ferramentas ou outros parâmetros.

A lista de modelos não é um verificador de saúde em tempo real e não inclui todas as restrições de parâmetros. Se o modelo estiver visível, mas não houver upstream disponível no momento, a requisição ainda pode falhar; o monitoramento de disponibilidade HTTP do site oficial também não significa que todos os modelos consigam realizar inferência com sucesso.

## Lista vazia ou modelos ausentes

Verifique as restrições de modelo e o grupo da chave; os modelos exibidos na página pública de preços nem sempre estão abertos para cada chave. Em 401, verifique primeiro o status da chave; em 403, verifique as condições de acesso; para etapas detalhadas, consulte [códigos de erro e resolução de problemas](/pt/docs/troubleshooting/).

Para séries de modelos e recomendações de escolha, consulte [modelos suportados](/pt/docs/models/).