Canais

O que é um canal?

Muitos modelos são acessíveis por mais de um canal — rotas independentes que atendem o mesmo modelo com nomes de método neutros como standard, direct ou reverse. Fixar um canal envia suas solicitações desse modelo por uma rota específica; por padrão, a escolha é feita automaticamente.

Padrão: roteamento automático

Sem fixação, cada solicitação usa o roteamento inteligente — a rota saudável mais barata capaz de atender o modelo é escolhida por solicitação. É a configuração recomendada e não exige configuração.

Escolher um canal no seu painel

Abra a aba Canais no seu painel. Cada modelo que oferece mais de um canal é listado com um indicador de status ao vivo por canal. Selecione um canal e salve, ou deixe em Auto (roteamento inteligente). Sua escolha é salva na sua conta e aplicada a todas as solicitações futuras desse modelo.

Níveis de canal

Cada canal possui um nível de acesso, exibido como um selo no seletor do painel. A ausência de selo significa que o canal é gratuito para todos. Um selo Pago indica que ele requer um plano ou assinatura ativa. Um selo Pré-pago indica que ele é cobrado do saldo da sua carteira por requisição. Fixar um canal nunca altera o preço de um modelo — apenas qual rota atende à requisição.

Descobrir canais pela API

Adicione ?channels=1 ao endpoint de modelos para listar todos os canais. Cada um é retornado como um pseudomodelo neutro cujo campo group é o modelo base ao qual pertence e cujo status reflete o estado ao vivo — os mesmos dados que o seletor do painel usa.

curl https://api.airforce/v1/models?channels=1

Uma resposta resumida — cada entrada compartilha seu modelo base em group, com seu próprio status ao vivo:

{
  "data": [
    { "id": "claude-opus-4.6_standard", "group": "claude-opus-4.6", "status": "operational", "tier": "free" },
    { "id": "claude-opus-4.6_reverse",  "group": "claude-opus-4.6", "status": "operational", "tier": "paid" }
  ]
}

Fallback e disponibilidade

Um canal fixado é usado enquanto estiver saudável. Se ficar indisponível, a solicitação volta automaticamente ao roteamento inteligente em vez de falhar — então fixar um canal nunca torna um modelo menos confiável que o padrão.