Fixação de grupos

Cada modelo é servido por um ou mais grupos de provedores, cada um com seu preço. Por padrão uma chave usa auto: cada requisição vai para o grupo mais barato que estiver no ar.

A fixação substitui isso por modelo: você escolhe exatamente quais grupos ele pode usar, e a cobrança fica travada nas tarifas deles. Útil quando você precisa da qualidade ou região de um provedor específico, ou de uma tarifa que não pode variar.

A página de detalhes de cada modelo lista cada grupo com preço de entrada e saída em Group Pricing; o selo de desconto na lista de modelos sempre reflete o grupo mais barato.

Abra Chaves de API, crie ou edite uma chave e abra o seletor de grupos. Busque um modelo, clique nele e marque um ou mais grupos de provedores, ordenados do mais barato com seu multiplicador de tarifa. Modelos que você não mexer continuam em auto.

Modelos fixados sobem ao topo com um selo mostrando em quantos grupos estão travados; Limpar tudo devolve a chave ao auto completo. A lista de chaves mostra chaves fixadas como auto +N.

Um modelo fixado roteia apenas dentro dos seus grupos fixados: o mais barato é tentado primeiro, com failover automático para o próximo em erros ou quedas. A tarifa cobrada é a do grupo que de fato atendeu a requisição.

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

Você também pode fixar por requisição sem alterar a chave: envie um cabeçalho X-Group com o nome exato do grupo. Ele prevalece sobre a fixação salva da chave e sobre o roteamento automático para aquela requisição. Copie qualquer nome de grupo da tabela de Preços por grupo de um modelo.

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 ser um grupo que a chave tem permissão para usar, caso contrário a requisição é rejeitada. Modelos sem fixação mantêm o roteamento para o provedor mais barato disponível quando nenhum cabeçalho é enviado.

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

{
  "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 da chave, ou tente de novo mais tarde. O modelo em si continua no ar.