Pular para o conteúdo principal
Envie solicitações de texto para 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.
O roteamento regional ainda não é uma garantia de residência de dados de ponta a ponta. O Phaseo restringe a seleção de provedores e posiciona o gateway perto da região, mas os sistemas compartilhados de conta, cobrança, cache e operações podem processar dados fora dela. Veja O que fica fora da região.

Enviar uma solicitação regional

Nos SDKs, defina 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.
A lista contém apenas modelos com uma rota de provedor ativa cujas regiões de execução e de dados declaradas incluem a região, e anuncia apenas Chat Completions, Responses e Messages com entrada e saída de texto. Cada oferta mostra suas regiões:

Verificar qual gateway tratou uma solicitação

As respostas regionais trazem X-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 retornam 400 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.
O Phaseo só vai chamar isso de residência de dados de ponta a ponta quando o gateway, o armazenamento, os registros, o provedor e os caminhos operacionais tiverem controles regionais aplicáveis.
Última modificação em 5 de novembro de 2026