Fixação de grupos

Todo modelo é servido por um ou mais grupos de provedores, cada um com preço próprio. Por padrão, uma chave usa auto: cada requisição vai para o grupo ativo mais barato.

A fixação substitui isso por modelo. Você escolhe quais grupos ele pode usar, e a cobrança fica presa às tarifas deles.

Cada página de modelo lista todos os grupos com preço de entrada e de saída em Group Pricing. O selo de desconto na lista de modelos reflete o grupo mais barato.

Abra Chaves de API, crie ou edite uma chave e abra o seletor de grupos. Procure um modelo, clique nele e marque um ou mais grupos, ordenados do mais barato ao mais caro. Modelos não alterados continuam em auto.

Modelos fixados vão para o topo com um selo mostrando quantos grupos têm. Clear all redefine a chave para auto. A lista de chaves mostra as chaves fixadas como auto +N.

Em vez de marcar provedores um a um, arraste a faixa de preço de duas alças em um modelo para rotear apenas por provedores cuja taxa esteja dentro dela. Como a seleção é por preço e não por nome, novos provedores que entrem na faixa são incluídos automaticamente.

A faixa e os provedores fixados se combinam como união: a faixa cobre os provedores baratos e uma fixação mantém um provedor caro específico como reserva mesmo fora da faixa. O roteamento continua tentando o mais barato primeiro, então a reserva só é alcançada quando tudo mais barato falha.

Automático devolve o modelo à cadeia normal do mais barato primeiro. Sua faixa e fixações continuam salvas, porém inativas, de modo que desligá-lo restaura exatamente o que estava configurado antes.

Um modelo fixado é roteado apenas dentro dos grupos fixados, do mais barato ao mais caro, com failover em caso de erro. O grupo que atende a requisição define a tarifa cobrada.

Combine uma fixação com um acompanhamento para saber quando os grupos mudam de preço ou caem, veja Notificações

Para fixar uma única requisição sem mudar a chave, envie um cabeçalho X-Group com o nome exato do grupo. Ele substitui a fixação da chave e o roteamento auto. Copie os nomes de Group Pricing.

curl https://api.unorouter.com/v1/chat/completions \
  -H "Authorization: Bearer $UNOROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Group: glm-new-pol-glm-5.2" \
  -d '{
    "model": "glm-5.2",
    "messages": [{ "role": "user", "content": "Hello" }]
  }'

O cabeçalho precisa citar um grupo que a chave possa usar, ou a requisição é rejeitada. Modelos sem fixação continuam no roteamento mais barato.

Se todos os grupos fixados estiverem fora enquanto outros provedores ainda servem o modelo, as requisições falham com um erro específico em vez de uma mensagem genérica de ocupado:

{
  "error": {
    "message": "Your pinned provider groups for model \"glm-5.2\" are currently unavailable, but the model is still served by other providers. Edit this key's group override, or try again later.",
    "type": "new_api_error",
    "code": "get_channel_failed"
  }
}

Amplie ou remova a fixação, ou tente mais tarde. O modelo em si está no ar.