Referência da API

Lista de modelos

GET/v1/models

Lista 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.