Para ver o índice completo da documentação, consulte llms.txt. Para acessar a versão em Markdown de uma página da documentação, acrescente .md ao final da URL da página.
Navegação principal
Tema

Residência de dados

Configure o armazenamento e o processamento regionais para seus projetos de API.

A residência de dados é uma configuração do projeto que permite escolher a localização da infraestrutura que a OpenAI usa para prestar os serviços.

Organizações qualificadas podem ativar a residência de dados ao criar um projeto na Plataforma de API. A OpenAI cobra um adicional de 10% pelo uso de endpoints de residência de dados com modelos compatíveis com esse recurso lançados a partir de 5 de março de 2026.

Entre em contato com a equipe de vendas para discutir as necessidades de residência de dados da sua organização e qualificá-la para usar esse recurso.

Como funciona a residência de dados?

Ao criar um projeto, você pode selecionar uma das regiões disponíveis.

  • Armazenamento: Para endpoints, modelos e snapshots compatíveis, a OpenAI armazena o Conteúdo do Cliente (conforme definido no seu contrato de serviços) em repouso na região selecionada quando o endpoint exige persistência, como é o caso de /v1/batches.
  • Processamento: Se a região oferecer processamento regional, a inferência sobre o Conteúdo do Cliente também ocorrerá nessa região.
  • Dados do sistema: A residência de dados não se aplica aos dados do sistema, que podem ser armazenados e processados fora da região selecionada. São dados de conta, metadados e dados de uso que não contêm Conteúdo do Cliente e que a OpenAI coleta para administrar e operar os serviços. Alguns exemplos são informações de conta ou perfis de usuários finais que acessam diretamente os serviços, dados analíticos, estatísticas de uso, informações de cobrança, solicitações de suporte e o schema de saídas estruturadas.

Suboperadores e processamento regional de solicitações

A OpenAI utiliza suboperadores para prestar seus serviços. Nas solicitações enviadas a us.api.openai.com, eu.api.openai.com, au.api.openai.com, in.api.openai.com ou jp.api.openai.com, a OpenAI utiliza o Cloudflare Regional Services para que a terminação de TLS e a descriptografia do tráfego HTTPS ocorram na região de processamento selecionada.

Limitações

A residência de dados não se aplica aos seguintes casos:

  1. Qualquer transmissão ou armazenamento de Conteúdo do Cliente fora da região selecionada em decorrência da localização de um Usuário Final ou da infraestrutura do Cliente no momento do acesso aos serviços.
  2. Produtos, serviços ou conteúdos oferecidos por terceiros por meio dos Serviços.
  3. Quaisquer dados que não sejam Conteúdo do Cliente, como dados do sistema.

Se a região selecionada não oferecer processamento regional, conforme indicado abaixo, a OpenAI também poderá processar e armazenar temporariamente o Conteúdo do Cliente fora dessa região para prestar os serviços.

Como usar a residência de dados

Entre em contato com a equipe de vendas para discutir as necessidades de residência de dados da sua organização e qualificá-la para usar esse recurso.

Você configura a residência de dados para cada projeto da sua organização na API. Como proprietário da organização, siga estas etapas:

  1. Abra a página de projetos na Plataforma de API e selecione Criar.
  2. Insira o nome do projeto e, em Residência de dados e inferência, selecione uma região disponível.
  3. Selecione Criar e depois crie uma chave de API para o novo projeto.
  4. Use a chave de API desse projeto com o prefixo de domínio regional indicado na tabela abaixo, como eu.api.openai.com para a Europa.

Depois de criar o projeto, você não pode alterar a região de residência. Para selecionar outra região, crie um novo projeto.

Como selecionar a região de processamento por solicitação

Para ativar a residência de dados por solicitação em um novo projeto Global, siga as etapas de criação acima. Mantenha a opção Residência de dados e inferência definida como Global e selecione Ativar residência de dados por solicitação antes de selecionar Criar. O projeto continua como Global.

Em cada solicitação que exigir processamento regional, use uma chave de API desse projeto Global com um prefixo de domínio regional. O endpoint e o modelo selecionados precisam oferecer suporte ao processamento regional, conforme indicado na tabela abaixo.

Se o seu projeto Global já oferecer suporte à residência de dados por solicitação, você poderá continuar usando as chaves de API dele.

O exemplo a seguir usa o mesmo cliente e a mesma chave de API de um projeto Global para enviar solicitações globais e solicitações regionais aos EUA e à UE:

from openai import OpenAI

client = OpenAI()

# No processing constraint.
response = client.responses.create(
    model="gpt-6.1-terra",
    input="Reply with OK.",
)
print(response.output_text)

# US processing and storage.
response = client.with_options(
    base_url="https://us.api.openai.com/v1",
).responses.create(
    model="gpt-6.1-terra",
    input="Reply with OK.",
)
print(response.output_text)

# EU processing and storage.
response = client.with_options(
    base_url="https://eu.api.openai.com/v1",
).responses.create(
    model="gpt-6.1-terra",
    input="Reply with OK.",
)
print(response.output_text)

Quais modelos e recursos oferecem suporte à residência de dados?

Os modelos e serviços de API a seguir oferecem suporte à residência de dados nas regiões indicadas abaixo.

Use Suporte por região para comparar os recursos regionais e expandir a lista de serviços disponíveis em cada região. Consulte Suporte a endpoints de API, ferramentas e modelos para ver as listas completas de modelos e os detalhes de cada serviço. O suporte ao armazenamento regional não implica suporte ao processamento regional.

Na Austrália, na Índia e no Japão, gpt-6-luna oferece suporte ao processamento regional. Nessas regiões, somente a modalidade Standard com pagamento conforme o uso está disponível. Use um projeto da região selecionada. A API Responses e a API chat completions aceitam entradas de texto e imagem e geram saídas de texto. As ferramentas hospedadas não estão disponíveis para processamento regional nesses três países.

GPT-6.2 Astra e GPT-6.2 Sol oferecem suporte à residência de dados nos EUA e na UE com as modalidades de processamento Standard, Fast e Batch. Nos dois modelos, o modo Ultrafast só está disponível com residência de dados nos EUA.

O modo Fast oferece suporte à residência de dados na UE para GPT-6.1 Sol, GPT-6.1 Terra e GPT-6 Luna. O modo Fast não está disponível com residência de dados na UE para GPT-6 Astra ou GPT-6 Sol. GPT-6.1 Sol, GPT-6.1 Terra, GPT-6 Sol e GPT-6 Luna oferecem suporte à residência de dados na UE com as modalidades de processamento Standard, Flex e Batch. O modo Ultrafast do GPT-6.1 Sol oferece suporte à residência de dados nos EUA e na UE e ao processamento global. O GPT-6 Astra Ultrafast oferece suporte apenas à residência de dados nos EUA e ao processamento global.

Suporte por região

Compare os recursos e serviços disponíveis em cada região.

United States
us.api.openai.com
ArmazenamentoProcessamento

Armazenamento

Sim

Processamento

Sim

Modos: Text, Audio, Voice, Image

Serviços com suporte

/v1/audio/transcriptions, /v1/audio/translations, /v1/audio/speechArmazenamentoProcessamento
/v1/batchesArmazenamentoProcessamento
/v1/chat/completionsArmazenamentoProcessamento
Europe (EEA + Switzerland)
eu.api.openai.com
ArmazenamentoProcessamento

Armazenamento

Sim

Processamento

Sim

Modos: Text, Audio, Voice, Image*

Serviços com suporte

/v1/audio/transcriptions, /v1/audio/translations, /v1/audio/speechArmazenamentoProcessamento
/v1/batchesArmazenamentoProcessamento
/v1/chat/completionsArmazenamentoProcessamento
Australia
au.api.openai.com
ArmazenamentoProcessamento

Armazenamento

Sim

Processamento

Sim

Modos: Text, Audio, Voice, Image*

Serviços com suporte

/v1/audio/transcriptions, /v1/audio/translations, /v1/audio/speechArmazenamento
/v1/batchesArmazenamento
/v1/chat/completionsArmazenamentoProcessamento
gpt-6-luna
Canada
ca.api.openai.com
Armazenamento

Armazenamento

Sim

Processamento

Não

Modos: Text, Audio, Voice, Image*

Serviços com suporte

/v1/audio/transcriptions, /v1/audio/translations, /v1/audio/speechArmazenamento
/v1/batchesArmazenamento
/v1/chat/completionsArmazenamento
Japan
jp.api.openai.com
ArmazenamentoProcessamento

Armazenamento

Sim

Processamento

Sim

Modos: Text, Audio, Voice, Image*

Serviços com suporte

/v1/audio/transcriptions, /v1/audio/translations, /v1/audio/speechArmazenamento
/v1/batchesArmazenamento
/v1/chat/completionsArmazenamentoProcessamento
gpt-6-luna
India
in.api.openai.com
ArmazenamentoProcessamento

Armazenamento

Sim

Processamento

Sim

Modos: Text, Audio, Voice, Image*

Serviços com suporte

/v1/audio/transcriptions, /v1/audio/translations, /v1/audio/speechArmazenamento
/v1/batchesArmazenamento
/v1/chat/completionsArmazenamentoProcessamento
gpt-6-luna
Singapore
sg.api.openai.com
Armazenamento

Armazenamento

Sim

Processamento

Não

Modos: Text, Audio, Voice, Image*

Serviços com suporte

/v1/audio/transcriptions, /v1/audio/translations, /v1/audio/speechArmazenamento
/v1/batchesArmazenamento
/v1/chat/completionsArmazenamento
South Korea
kr.api.openai.com
Armazenamento

Armazenamento

Sim

Processamento

Não

Modos: Text, Audio, Voice, Image*

Serviços com suporte

/v1/audio/transcriptions, /v1/audio/translations, /v1/audio/speechArmazenamento
/v1/batchesArmazenamento
/v1/chat/completionsArmazenamento
United Kingdom
gb.api.openai.com
Armazenamento

Armazenamento

Sim

Processamento

Não

Modos: Text, Audio, Voice, Image*

Serviços com suporte

/v1/audio/transcriptions, /v1/audio/translations, /v1/audio/speechArmazenamento
/v1/batchesArmazenamento
/v1/chat/completionsArmazenamento
United Arab Emirates
ae.api.openai.com
ArmazenamentoProcessamento

Armazenamento

Sim

Processamento

Sim

Fale com a equipe de vendas para acessar esta região

Modos: Text, Audio, Voice, Image*

Serviços com suporte

/v1/audio/transcriptions, /v1/audio/translations, /v1/audio/speechArmazenamento
/v1/batchesArmazenamento
/v1/chat/completionsArmazenamentoProcessamento
gpt-5.6-lunagpt-5.5-2026-04-23
+1 snapshot
gpt-5.2-2025-12-11

* O suporte a imagens nessas regiões requer aprovação adicional. Fale com a equipe de vendas.

Suporte a endpoints da API, ferramentas e modelos

Filtre por serviço, endpoint, ferramenta ou snapshot de modelo.

27 serviços com suporte

/v1/audio/transcriptions, /v1/audio/translations, /v1/audio/speech

Audio

Modelos com suporte

tts-1whisper-1gpt-4o-tts
+ 3 snapshots de modelo
gpt-4o-transcribegpt-4o-mini-transcribegpt-transcribe

/v1/batches

Batches

Modelos com suporte

gpt-6.2-astragpt-6.2-solgpt-6-astra
+ 35 snapshots de modelo
gpt-6.1-solgpt-6.1-terragpt-6-solgpt-6-lunagpt-5.5-pro-2026-04-23gpt-5.4-pro-2026-03-05gpt-5.2-pro-2025-12-11gpt-5-pro-2025-10-06gpt-5.6-solgpt-5.6-terragpt-5.6-lunagpt-5.5-2026-04-23gpt-5.4-2026-03-05gpt-5-2025-08-07gpt-5.4-mini-2026-03-17gpt-5.4-nano-2026-03-17gpt-5.2-2025-12-11gpt-5.1-2025-11-13gpt-5-mini-2025-08-07gpt-5-nano-2025-08-07gpt-4.1-2025-04-14gpt-4.1-mini-2025-04-14gpt-4.1-nano-2025-04-14o3-2025-04-16o4-mini-2025-04-16o1-proo1-pro-2025-03-19o3-mini-2025-01-31o1-2024-12-17gpt-4o-2024-11-20gpt-4o-2024-08-06gpt-4o-mini-2024-07-18gpt-4-turbo-2024-04-09gpt-4-0613gpt-3.5-turbo-0125

Observações

GPT-6.2 Astra and GPT-6.2 Sol support US and EU data residency with Batch processing. GPT-6.1 Sol, GPT-6.1 Terra, GPT-6 Sol, and GPT-6 Luna support EU data residency with Standard, Flex, and Batch processing. GPT-6.1 Sol and GPT-6.1 Terra support only US and EU data residency.

/v1/chat/completions

Chat Completions

Modelos com suporte

gpt-6.2-astragpt-6.2-solgpt-6-astra
+ 29 snapshots de modelo
gpt-6.1-solgpt-6.1-terragpt-6-solgpt-6-lunagpt-5.6-solgpt-5.6-terragpt-5.6-lunagpt-5.5-2026-04-23gpt-5.4-2026-03-05gpt-5.4-mini-2026-03-17gpt-5.4-nano-2026-03-17gpt-5.2-2025-12-11gpt-5.1-2025-11-13gpt-5-2025-08-07gpt-5-mini-2025-08-07gpt-5-nano-2025-08-07gpt-4.1-2025-04-14gpt-4.1-mini-2025-04-14gpt-4.1-nano-2025-04-14o3-mini-2025-01-31o3-2025-04-16o4-mini-2025-04-16o1-2024-12-17gpt-4o-2024-11-20gpt-4o-2024-08-06gpt-4o-mini-2024-07-18gpt-4-turbo-2024-04-09gpt-4-0613gpt-3.5-turbo-0125

Observações

GPT-6.2 Astra and GPT-6.2 Sol support US and EU data residency with Standard and Fast processing. Fast mode supports EU data residency for GPT-6.1 Sol, GPT-6.1 Terra, and GPT-6 Luna. Fast mode is not available with EU data residency for GPT-6 Astra or GPT-6 Sol. GPT-6.1 Sol and GPT-6.1 Terra support only US and EU data residency.

/v1/decisions

Decisions

Modelos com suporte

gpt-6-luna

Observações

Available in all supported API regions. Regional processing is supported in the United States and Europe (EEA + Switzerland). Prompt caching is subject to the retention limitations below.

/v1/embeddings

Embeddings

Modelos com suporte

text-embedding-3-smalltext-embedding-3-largetext-embedding-ada-002

/v1/evals

Evals

Modelos com suporte

Com suporte

/v1/files

Files

Modelos com suporte

Com suporte

/v1/fine_tuning/jobs

Fine-tuning

Modelos com suporte

gpt-4o-2024-08-06gpt-4o-mini-2024-07-18gpt-4.1-2025-04-14
+ 1 snapshot de modelo
gpt-4.1-mini-2025-04-14

/v1/images/edits

Images

Modelos com suporte

gpt-image-2gpt-image-1.5gpt-image-1-mini

/v1/images/generations

Images

Modelos com suporte

gpt-image-2gpt-image-1.5gpt-image-1-mini

/v1/moderations

Moderation

Modelos com suporte

omni-moderation-latest

/v1/moderations (CSAM classifier)

Moderation

Modelos com suporte

omni-moderation-csam-latest

Observações

Available to approved organizations. Regional processing coverage is not specified for this model.

/v1/live/sessions

GPT-Live

Modelos com suporte

gpt-live-1

/v1/realtime

Realtime

Modelos com suporte

gpt-realtimegpt-realtime-1.5gpt-realtime-mini
+ 3 snapshots de modelo
gpt-realtime-2gpt-realtime-2.1gpt-realtime-2.1-mini

/v1/realtime/transcription_sessions

Realtime

Modelos com suporte

gpt-realtime-whispergpt-live-transcribegpt-transcribe

/v1/realtime/translations

Realtime

Modelos com suporte

gpt-realtime-translate

/v1/responses

Responses

Modelos com suporte

gpt-6.2-astragpt-6.2-solgpt-6-astra
+ 35 snapshots de modelo
gpt-6.1-solgpt-6.1-terragpt-6-solgpt-6-lunagpt-5.5-pro-2026-04-23gpt-5.4-pro-2026-03-05gpt-5.2-pro-2025-12-11gpt-5-pro-2025-10-06gpt-5.6-solgpt-5.6-terragpt-5.6-lunagpt-5.5-2026-04-23gpt-5.4-2026-03-05gpt-5-2025-08-07gpt-5.4-mini-2026-03-17gpt-5.4-nano-2026-03-17gpt-5.2-2025-12-11gpt-5.1-2025-11-13gpt-5-mini-2025-08-07gpt-5-nano-2025-08-07gpt-4.1-2025-04-14gpt-4.1-mini-2025-04-14gpt-4.1-nano-2025-04-14o3-2025-04-16o4-mini-2025-04-16o1-proo1-pro-2025-03-19o3-mini-2025-01-31o1-2024-12-17gpt-4o-2024-11-20gpt-4o-2024-08-06gpt-4o-mini-2024-07-18gpt-4-turbo-2024-04-09gpt-4-0613gpt-3.5-turbo-0125

Observações

GPT-6.2 Astra and GPT-6.2 Sol support US and EU data residency with Standard and Fast processing. Fast mode supports EU data residency for GPT-6.1 Sol, GPT-6.1 Terra, and GPT-6 Luna. Fast mode is not available with EU data residency for GPT-6 Astra or GPT-6 Sol. GPT-6.1 Sol and GPT-6.1 Terra support only US and EU data residency.

/v1/responses File Search

Responses

Modelos com suporte

Com suporte

/v1/responses Web Search

Responses

Modelos com suporte

Com suporte

/v1/vector_stores

Vector stores

Modelos com suporte

Com suporte

Code Interpreter tool

Tools

Modelos com suporte

Com suporte

File Search

Tools

Modelos com suporte

Com suporte

File Uploads

Files

Modelos com suporte

Com suporte

Observações

Supported when used with base64 file uploads.

Remote MCP server tool

Tools

Modelos com suporte

Com suporte

Observações

MCP servers are third-party services. Data sent to an MCP server is subject to its data residency policies.

Scale Tier

Other

Modelos com suporte

Com suporte

Structured Outputs (excluding schema)

Other

Modelos com suporte

Com suporte

Supported input modalities

Other

Modelos com suporte

TextoImagemÁudio/voz

Limitações por endpoint

/v1/decisions

A API Decisions está disponível em todas as regiões em que a API tem suporte. O processamento regional está disponível nos Estados Unidos e na Europa (EEE + Suíça). A disponibilidade em uma região não garante que a inferência ocorra nessa região.

  • Em regiões sem suporte ao processamento regional, o uso do cache de prompts com retenção estendida pode exigir que a OpenAI processe e armazene temporariamente o Conteúdo do Cliente fora da região para prestar os serviços.

/v1/chat/completions

  • Não é possível definir store=true em regiões fora dos EUA.
  • Em regiões sem suporte ao processamento regional, o uso do cache de prompts com retenção estendida pode exigir que a OpenAI processe e armazene temporariamente o Conteúdo do Cliente fora da região para prestar os serviços.

/v1/responses

  • Em regiões sem suporte ao processamento regional, o uso do cache de prompts com retenção estendida pode exigir que a OpenAI processe e armazene temporariamente o Conteúdo do Cliente fora da região para prestar os serviços.

/v1/live/sessions

As sessões do GPT-Live são compatíveis com a zero retenção de dados. Quando essa opção está ativada, a API trata store como false, mesmo que a solicitação defina o parâmetro como true.

O armazenamento de sessões fica desativado por padrão. Em projetos com esse armazenamento ativado, a configuração store: true mantém a gravação da sessão concluída por 30 dias. Nesse período, você pode baixar a gravação ou usá-la para iniciar um fork da sessão. As sessões armazenadas e o índice dessas sessões expiram após 30 dias. Para baixar gravações ou criar forks, a política de dados precisa permitir a persistência. Essas operações não estão disponíveis com a zero retenção de dados.

Definir store: false em um fork impede o armazenamento da nova sessão. A gravação original continua disponível e a leitura dela continua exigindo autorização. A API não oferece um endpoint público para excluir sessões armazenadas.

O GPT-Live oferece suporte à residência de dados nos Estados Unidos e na Europa. Os modelos e as ferramentas de backend que recebem tarefas delegadas têm controles de dados próprios. Consulte nesta página as informações sobre os endpoints e recursos aplicáveis.

/v1/realtime

Atualmente, o rastreamento em /v1/realtime não atende aos requisitos de residência de dados na UE.