Referência da API
Lista de modelos
GET
/v1/modelsLista todos os modelos que esta chave pode chamar — clientes como o Cursor usam isso para validar a conexão. Chaves com lista de modelos permitidos veem apenas essa lista.
#Exemplo de requisição
curl https://www.aisplice.store/v1/models \
-H "Authorization: Bearer sk-YOUR_KEY"#Resposta
response.json
{
"object": "list",
"data": [
{"id": "gpt-5.6-luna", "object": "model", "owned_by": "openai"},
{"id": "gpt-5.6-terra", "object": "model", "owned_by": "openai"},
{"id": "gpt-5.6-sol", "object": "model", "owned_by": "openai"},
{"id": "claude-opus-5-5", "object": "model", "owned_by": "anthropic"},
{"id": "qwen3.7-max", "object": "model", "owned_by": "alibaba"}
]
}Os preços não estão neste payload — a página de modelos traz os preços atualizados por modelo, as faixas e as tags de recursos.
#Como ler o catálogo de modelos
Quais campos do catálogo dizem o que um modelo suporta e quais pertencem à sua UI.
supported_endpoint_types- Quando expor
- Leia isto primeiro ao decidir a qual formato de endpoint o modelo pertence.
- Padrão recomendado
- Trate como sinal de roteamento, não como controle de UI.
- Por que importa
- Indica se o modelo deve ser chamado por /images, /images/tasks, /videos, /audio ou por endpoints no estilo chat.
pricing_tiers.size / quality / resolution / duration- Quando expor
- Leia ao decidir quais controles merecem aparecer na UI do produto.
- Padrão recomendado
- Se um mapa de faixas estiver vazio, mantenha esse controle oculto.
- Por que importa
- Esses mapas são a prova mais clara de que um modelo realmente suporta essa dimensão de preço.
pricing_tiers.reference- Quando expor
- Leia quando precisar saber se mídia de referência de imagem ou vídeo é permitida ou obrigatória.
- Padrão recomendado
- Oculte os controles de upload de referência, a menos que este objeto indique que eles existem.
- Por que importa
- Determina se o fluxo é só com prompt ou guiado por referência, e se URLs públicas são obrigatórias.
quota_type- Quando expor
- Leia ao explicar a semântica de preço para usuários ou operadores.
- Padrão recomendado
- Mostre como metadados somente leitura nas páginas de detalhe do modelo.
- Por que importa
- Distingue a cobrança por token da cobrança por requisição e muda a forma como os usuários pensam sobre o custo.
tags / capability- Quando expor
- Use como dicas de apoio quando os tipos de endpoint forem genéricos demais.
- Padrão recomendado
- Não confie neles como única fonte da verdade.
- Por que importa
- Ajudam a classificar chat, imagem, vídeo e áudio, mas são mais fracos que campos explícitos de endpoint ou de faixa.
Ainda com problemas?
Envie para nós o ID da requisição ou a mensagem de erro e vamos investigar.