Pular para o conteúdo

Guias de migraçãoVindo do Azure OpenAI

Do Azure OpenAI sozinho ao Azure como um dos seus provedores

O Azure OpenAI executa modelos da OpenAI na sua assinatura do Azure, sob seu contrato enterprise e os filtros de conteúdo do Azure. O INFRO mantém tudo isso: ele chama seu recurso com sua chave. O que muda é que sua aplicação chama o INFRO, que pode fazer failover do Azure para a OpenAI ou outro provedor, aplicar orçamentos antes da chamada e registrar o custo por requisição.

Azure OpenAI em Microsoft Foundry Models; API v1 sem api-version desde agosto de 2025

As contas do INFRO são self-service. O catálogo, a documentação e o contrato da API são públicos, o gateway está implantado, e tudo o que vai além da v1 está marcado para depois. Planos e teste

Situação atual

Nomenclatura

A documentação da Microsoft agora o chama de Azure OpenAI in Microsoft Foundry Models; a plataforma, antes Azure AI Foundry, é a Microsoft Foundry.

A API v1

Desde agosto de 2025, o caminho /openai/v1/ não precisa de api-version e funciona com o cliente comum da OpenAI. Ele também serve outros modelos do Foundry vendidos pelo Azure com a mesma sintaxe de chat completions.

O que o INFRO chama

https://{resource}.openai.azure.com/openai/v1 com a api-key do recurso. O model enviado é o nome do seu deployment, do mapa de modelos da conexão, ou então o nome do modelo. Requisições Responses vão ao Azure como escritas.

Se o Azure é seu único provedor e seus controles já ficam no Azure, um gateway pode acrescentar pouco. Fique nele se uma destas situações se aplicar.

  • Você usa apenas Entra ID e as chaves estão desativadas no recurso. A conexão Azure do INFRO usa a chave de API do recurso.
  • Tudo precisa ficar dentro do seu tenant do Azure ou de uma zona de dados. O INFRO roda na rede da Cloudflare entre sua aplicação e o Azure; residência de dados está no roadmap.
  • Você usa evals, completions armazenadas, Responses em segundo plano ou as APIs Assistants e Realtime do Azure. O INFRO não as serve.
  • O Azure é seu único provedor e o Azure Monitor já responde às suas perguntas sobre custo.

As alterações, uma linha cada. Tudo o que não está listado aqui continua como está.

 Azure OpenAIINFRO
URL basehttps://{resource}.openai.azure.com/openai/v1/ ou /openai/deployments/{name}/...?api-version=.https://api.infro.io/v1
Credencialapi-key, ou um bearer token do Entra ID.Uma chave do gateway do INFRO. O INFRO guarda o nome do recurso e a chave como uma conexão, selados.
Id do modeloO nome do seu deployment, por exemplo gpt-prod.openai/gpt-5.6-terra; a conexão o mapeia para gpt-prod. Ou o nome de uma rota.
Camposuser, metadata, store; content_filter_results nas respostas.metadata { user_id, session_id, tags } registrado pelo INFRO e não encaminhado. O filtro de conteúdo do Azure continua rodando no seu recurso.

Antes · Azure OpenAI v1

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://my-company.openai.azure.com/openai/v1/",
  apiKey: process.env.AZURE_OPENAI_API_KEY,
});

await client.chat.completions.create({
  model: "gpt-prod", // deployment name
  messages: [{ role: "user", content: "Hello" }],
});

Depois · INFRO

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.infro.io/v1",
  apiKey: process.env.INFRO_API_KEY,
});

await client.chat.completions.create({
  // A route: Azure deployment first, OpenAI second
  model: "gpt-prod",
  messages: [{ role: "user", content: "Hello" }],
});

Deployments no mapa de modelos

Na conexão Azure, mapeie openai/gpt-5.6-terra para o seu deployment gpt-prod. Um modelo sem mapeamento é enviado com o próprio nome como nome do deployment.

Os filtros de conteúdo continuam funcionando

O Azure aplica seus filtros no seu recurso. Uma requisição que o Azure recusa segue a regra moderation da rota: devolver a recusa ou, se você preferir, fazer failover para o próximo destino.

Vários recursos

Conecte cada recurso do Azure (um por região ou zona de dados) como uma conexão própria, e uma rota pode fazer failover entre eles antes de tentar outro provedor.

Os objetos do Azure OpenAI comparados aos do INFRO, a partir da documentação pública do Azure OpenAI lida em 19 de outubro de 2026 e conferidos com o que o gateway implementa. Uma linha diz que o INFRO não tem nada.

Azure OpenAIO que faz láNo INFRO
Recurso e chavediferenteUm recurso do Azure OpenAI com chaves ou Entra ID.Uma conexão Azure com o nome do recurso e a chave, selados. Sem Entra ID.
Deploymentsmesmo formatoDeployments nomeados de cada modelo, com um tipo de deployment.Um mapa de modelos dos ids do catálogo para os nomes dos seus deployments.
FailoverdiferenteEntre recursos, fica por conta da sua aplicação.Rotas entre recursos do Azure e outros provedores, com regras de falha por tipo.
Cotas e PTUdiferenteTokens por minuto por deployment; Provisioned Throughput.Sem mudanças do lado do Azure. O INFRO adiciona orçamentos em dólares que recusam antes da chamada.
Filtros de conteúdo e Prompt Shieldsmesmo formatoConfigurados por recurso, associados por deployment.Eles continuam rodando no seu recurso. O INFRO adiciona os próprios guardrails por cima, se você quiser.
Cache de promptsmesmo formatoCache automático de prefixo, prompt_cache_key, breakpoints explícitos em modelos mais novos.Repassado ao Azure como enviado; o cache acontece no Azure. O INFRO adiciona um cache opcional de respostas por correspondência exata.
Responses APIdiferenteRecomendada; tarefas em segundo plano, respostas armazenadas./v1/responses enviado ao Azure como escrito; previous_response_id e background são recusados porque o INFRO não guarda respostas.
Evals e completions armazenadasnada/openai/v1/evals, store e metadata.Nada.
CustodiferenteAzure Cost Management.Custo estimado por requisição por projeto, chave, usuário e tag. Não reconciliado com o faturamento do Azure.

Nossa leitura da documentação publicada do Azure OpenAI, não um teste nem um benchmark. Se lemos algo errado, avise-nos e corrigimos a linha.

O que o INFRO não faz

  • Autenticar no Azure com Entra ID ou managed identities.
  • Servir Assistants, Realtime, evals, batches ou fine-tuning.
  • Manter o tráfego dentro do seu tenant do Azure ou de uma zona de dados.
  • Reconciliar com o faturamento do Azure.

O que não é levado

  • Métricas e logs do Azure Monitor de antes da troca; eles ficam no Azure.
  • Completions armazenadas e respostas armazenadas.

Perguntas

Meus filtros de conteúdo do Azure continuam valendo?
Sim. O INFRO chama seu próprio recurso, e o Azure aplica os filtros dele lá, como antes.
Quem me cobra pelo uso?
Microsoft, na sua assinatura do Azure. O INFRO é uma assinatura e adiciona 0% ao gasto com modelos.
Posso manter os nomes dos meus deployments no código?
Sim. Crie rotas no INFRO com os nomes dos seus deployments; quem chama continua enviando o mesmo model.

Migre conosco ou por conta própria

O programa de migração mapeia, numa chamada, a sua configuração do Azure OpenAI para conexões, rotas e orçamentos do INFRO e migra o primeiro serviço com você. Seus provedores continuam cobrando você diretamente; o INFRO é uma assinatura e acrescenta 0% ao gasto com modelos.

Fontes

Cada afirmação desta página sobre o Azure OpenAI vem de uma destas fontes, lidas em 19 de outubro de 2026. Nada é inferido de um teste, de um benchmark ou de uma conversa.