eu.api.phaseo.app ou us.api.phaseo.app para usar apenas rotas de provedores que executam o modelo e tratam os dados de prompt e de resposta nessa região. Os IDs de modelo e as chaves de API continuam os mesmos. Chat Completions, Responses e Messages são aceitos.
Enviar uma solicitação regional
region como "eu" ou "us"; omita-o, ou use "global", para o roteamento global. O SDK lança um erro se você definir region e uma baseUrl personalizada (base_url em Python) ao mesmo tempo, porque eles escolhem hosts diferentes.
O hostname é a política. Um required_execution_region ou required_data_region na solicitação ou em uma predefinição que indique outra região falha com 400 validation_error, motivo deployment_region_conflict. As predefinições e as regras de roteamento dinâmico são aplicadas primeiro e a regra regional por último, então elas não conseguem enfraquecê-la. O Phaseo nunca tenta de novo por um provedor fora da região.
O que uma solicitação regional pode conter
Suas próprias ferramentas são permitidas porque são executadas no seu aplicativo. As ferramentas hospedadas e de servidor são executadas em lugares que a regra regional não controla.
Encontrar os modelos disponíveis em uma região
Chame/v1/models no mesmo hostname para o qual você envia as solicitações. A disponibilidade muda entre os endpoints da UE, dos EUA e global.
Verificar qual gateway tratou uma solicitação
As respostas regionais trazemX-Phaseo-Gateway-Region: eu (ou us). O cabeçalho indica a política regional que tratou a solicitação; ele não prova onde a Cloudflare a executou. Os detalhes da solicitação também registram as regiões de execução e de dados exigidas, o provedor selecionado e as regiões declaradas por esse provedor.
Erros
Violações da regra regional retornam400 not_supported com um destes valores de reason:
400 validation_error com o motivo deployment_region_conflict significa que a solicitação ou uma predefinição indica outra região; remova essa configuração. Se nenhuma rota de provedor saudável atender ao modelo e à região, a solicitação para antes de qualquer provedor ser chamado; escolha um modelo listado pelo /v1/models regional.
O que fica fora da região
A regra regional cobre qual provedor executa o modelo e trata os dados de prompt e de resposta. Ela ainda não cobre todo o ciclo de vida da solicitação:- O posicionamento da Cloudflare coloca o gateway perto da região, mas isso não é uma fronteira de conformidade.
- Os metadados de conta, autenticação, cobrança e solicitações ficam na infraestrutura compartilhada do Supabase.
- O Cloudflare KV e os logs de invocação do Worker não ficam restritos à região.
- As chamadas ao provedor vão para o endpoint regional desse provedor, independentemente de onde a Cloudflare posicionou o gateway.
- As equipes de suporte e operações não ficam restritas à região.