Consultar modelos disponíveis via API

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.

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

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

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

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

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:

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"

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

Copie o ID completo de data[].id, preservando maiúsculas/minúsculas, hífens e o sufixo de data.
Confirme o tipo de interface do modelo no catálogo de modelos do console.
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.

Para séries de modelos e recomendações de escolha, consulte modelos suportados.