Idioma da resposta

A Bayle renderiza mensagens de erro em inglês ou português brasileiro. Respostas de sucesso carregam conteúdo gerado, que não é afetado por isso: só a prosa de erro é traduzida.

Pedindo um idioma

Envie Accept-Language. Um tag começando com as duas letras pt, em qualquer caixa, seleciona português brasileiro. Qualquer outra coisa, incluindo nenhum header, seleciona inglês.

curl https://api.bayle.ai/embeddings \
  -H "Authorization: Bearer bad-key" \
  -H "Accept-Language: pt-BR" \
  -H "Content-Type: application/json" \
  -d '{"model": "bad-model-id", "input": "hello"}'

{
  "error": {
    "message": "Sua chave de API da Bayle está ausente ou não pôde ser verificada.",
    "type": "authentication_error",
    "param": null,
    "code": "invalid_api_key"
  }
}

O tag pode aparecer em qualquer posição de um header com múltiplos tags, então fr-FR;q=0.9,pt;q=0.5,en;q=0.3 seleciona português. Valores de qualidade são aceitos mas ignorados: isto é uma checagem de presença de um tag prefixado com pt, não negociação ponderada. pt, pt-BR e pt-PT selecionam as mesmas mensagens em português brasileiro.

Descobrindo qual idioma você recebeu

Toda resposta carrega Content-Language, en ou pt-BR, em sucesso e erro igualmente. Você pode lê-lo sem fazer parse do texto da mensagem.

curl -sD - https://api.bayle.ai/models -o /dev/null | grep -i content-language

Em uma chat completion via streaming, o header é confirmado junto com o 200 inicial, antes de o resultado ser conhecido, então ele está presente seja qual for o desfecho do stream. Um evento de erro que chega no meio do stream é renderizado no idioma negociado no início da requisição.

Não faça correspondência pelo texto da mensagem

Como message é traduzida, código que faz correspondência com ela funciona até alguém mudar um header. Trate por error.code, que é estável entre os dois idiomas. Veja Erros.