Residencia de datos

La residencia de datos es una opción de configuración del proyecto que te permite elegir la ubicación de la infraestructura que OpenAI utiliza para prestar sus servicios.

Las organizaciones que cumplen los requisitos pueden habilitar la residencia de datos al crear un proyecto en la Plataforma API. En los puntos de acceso con residencia de datos se aplica un recargo del 10 % a los modelos lanzados a partir del 5 de marzo de 2026 que admiten la residencia de datos.

¿Cómo funciona la residencia de datos?

Al crear un proyecto, puedes seleccionar una de las regiones disponibles.

• Almacenamiento: en el caso de los puntos de acceso, modelos y versiones específicas compatibles, tu Contenido del Cliente (según se define en tu contrato de servicios) se almacena en reposo en la región seleccionada cuando el punto de acceso requiere almacenamiento persistente, como ocurre con /v1/batches.
• Procesamiento: si la región admite el procesamiento regional, la inferencia sobre tu Contenido del Cliente también se realiza en esa región.
• Datos del sistema: la residencia de datos no se aplica a los datos del sistema, que pueden almacenarse y procesarse fuera de la región seleccionada. Estos incluyen datos de cuenta, metadatos y datos de uso que no contienen Contenido del Cliente y que se recopilan para administrar y operar los servicios. Algunos ejemplos son la información de cuenta o los perfiles de los usuarios finales que acceden directamente a los servicios, los datos de análisis, las estadísticas de uso, la información de facturación, las solicitudes de soporte y el esquema de los resultados estructurados.

Subencargados del tratamiento y procesamiento regional de solicitudes

OpenAI recurre a subencargados del tratamiento para prestar sus servicios. Para las solicitudes enviadas a us.api.openai.com, eu.api.openai.com, au.api.openai.com, in.api.openai.com o jp.api.openai.com, OpenAI utiliza Cloudflare Regional Services para que la terminación de TLS y el descifrado de HTTPS se realicen dentro de la región de procesamiento seleccionada.

Limitaciones

La residencia de datos no se aplica en los siguientes casos:

1. La transmisión o el almacenamiento de Contenido del Cliente fuera de la región seleccionada cuando esto se debe a la ubicación de un Usuario Final o de la infraestructura del Cliente al acceder a los servicios.
2. Los productos, servicios o contenidos que terceros distintos de OpenAI ofrecen a través de los Servicios.
3. Los datos distintos del Contenido del Cliente, como los datos del sistema.

Si la Región que seleccionaste no admite el procesamiento regional, según se indica más adelante, OpenAI también puede procesar y almacenar temporalmente Contenido del Cliente fuera de la Región para prestar los servicios.

Cómo usar la residencia de datos

La residencia de datos se configura por proyecto dentro de tu organización de la API. Si tienes el rol de propietario de la organización, sigue estos pasos:

1. Abre la página de proyectos en la Plataforma API y selecciona Crear.
2. Ingresa un nombre para el proyecto y, en Residencia de datos e inferencia, selecciona una región disponible.
3. Selecciona Crear y luego crea una clave de API para el nuevo proyecto.
4. Usa la clave de API de ese proyecto con el prefijo de dominio regional que se indica en la tabla siguiente, por ejemplo, eu.api.openai.com para Europa.

Una vez creado el proyecto, no puedes cambiar su región de residencia. Para seleccionar otra región, crea un proyecto nuevo.

Seleccionar una región de procesamiento por solicitud

Para habilitar la residencia de datos por solicitud en un proyecto Global nuevo, sigue los pasos de creación anteriores, deja Residencia de datos e inferencia en Global y selecciona Habilitar la residencia de datos por solicitud antes de seleccionar Crear. El proyecto conserva la configuración Global.

En cada solicitud que requiera procesamiento regional, usa una clave de API de ese proyecto Global con el prefijo de dominio de la región. El punto de acceso y el modelo seleccionados deben admitir el procesamiento regional, como se indica en la tabla siguiente.

Si tu proyecto Global actual ya admite la residencia de datos por solicitud, puedes seguir usando sus claves de API.

En el siguiente ejemplo se reutilizan un mismo cliente y una misma clave de API de un proyecto Global para enviar solicitudes globales y solicitudes regionales a Estados Unidos y a la Unión Europea (UE):

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28from openai import OpenAI

client = OpenAI()

# No processing constraint.
response = client.responses.create(
    model="gpt-5.6-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-5.6-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-5.6-terra",
    input="Reply with OK.",
)
print(response.output_text)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22require "openai"

client = OpenAI::Client.new

response = client.responses.create(
  model: "gpt-5.6-terra",
  input: "Reply with OK."
)
puts(response.output_text)

response = client.with_options(data_residency: :us).responses.create(
  model: "gpt-5.6-terra",
  input: "Reply with OK."
)
puts(response.output_text)

# EU processing requires a key from an EU-region project.
response = client.with_options(data_residency: :eu, api_key: ENV.fetch("OPENAI_EU_API_KEY"), organization: nil, project: nil).responses.create(
  model: "gpt-5.6-terra",
  input: "Reply with OK."
)
puts(response.output_text)

¿Qué modelos y funciones admiten la residencia de datos?

Los siguientes modelos y servicios de la API admiten actualmente la residencia de datos en las regiones que se indican a continuación.

Usa Compatibilidad por región para comparar las funciones de cada región y desplegar la lista de servicios disponibles en cada una. En Compatibilidad de puntos de acceso de la API, herramientas y modelos puedes consultar las listas completas de modelos y los detalles de cada servicio. Que una región admita el almacenamiento regional no implica que también admita el procesamiento regional.

En Australia, India y Japón, gpt-6-luna admite el procesamiento regional. En estas regiones solo está disponible la modalidad Standard de pago por uso. Usa un proyecto de la región seleccionada. La API de Responses y la API para completar chats admiten entradas de texto e imagen y salidas de texto. Las herramientas alojadas no están disponibles para el procesamiento regional en estas tres regiones.

El Modo rápido admite la residencia de datos en la UE para GPT-6.1 Sol, GPT-6.1 Terra y GPT-6 Luna. El Modo rápido no está disponible con la residencia de datos en la UE para GPT-6 Astra ni GPT-6 Sol. GPT-6.1 Sol, GPT-6.1 Terra, GPT-6 Sol y GPT-6 Luna admiten la residencia de datos en la UE con las modalidades de procesamiento Standard, Flex y Batch. El modo ultrarrápido de GPT-6.1 Sol admite la residencia de datos en Estados Unidos y en la UE, así como el procesamiento global. El modo ultrarrápido de GPT-6 Astra solo admite la residencia de datos en Estados Unidos y el procesamiento global.

Limitaciones de los puntos de acceso

/v1/decisions

La API de Decisions está disponible en todas las regiones compatibles con la API. El procesamiento regional está disponible en Estados Unidos y Europa (EEE + Suiza). La disponibilidad de la API en una región no implica que la inferencia se realice en esa región.

• En las regiones que no admiten el procesamiento regional, el almacenamiento en caché de prompts con retención prolongada puede requerir que OpenAI procese y almacene temporalmente Contenido del Cliente fuera de la Región para prestar los servicios.

/v1/chat/completions

• No puedes establecer store=true en regiones fuera de Estados Unidos.
• En las regiones que no admiten el procesamiento regional, el almacenamiento en caché de prompts con retención prolongada puede requerir que OpenAI procese y almacene temporalmente Contenido del Cliente fuera de la Región para prestar los servicios.

/v1/responses

• En las regiones que no admiten el procesamiento regional, el almacenamiento en caché de prompts con retención prolongada puede requerir que OpenAI procese y almacene temporalmente Contenido del Cliente fuera de la Región para prestar los servicios.

/v1/live/sessions

Las sesiones de GPT-Live admiten la retención cero de datos. Si habilitas la retención cero de datos, la API interpreta store como false, incluso si una solicitud lo establece en true.

El almacenamiento de sesiones está deshabilitado de forma predeterminada. En los proyectos que tienen habilitado el almacenamiento de sesiones, store: true conserva la grabación de la sesión finalizada durante 30 días para que puedas descargarla o usarla para iniciar un fork de la sesión. Las sesiones almacenadas y su índice caducan después de 30 días. Para descargar grabaciones y crear forks, se requiere una política de datos que permita el almacenamiento persistente. Ninguna de estas dos operaciones está disponible con la retención cero de datos.

Si estableces store: false en un fork, la nueva sesión no se almacena. La grabación original se conserva y sigue siendo necesario contar con autorización para leerla. La API no ofrece un punto de acceso público para eliminar sesiones almacenadas.

GPT-Live admite la residencia de datos en Estados Unidos y Europa. Los modelos y las herramientas del backend a los que GPT-Live delega tareas tienen sus propios controles de datos. Consulta en esta página las entradas de los puntos de acceso y las funciones correspondientes.

/v1/realtime

Actualmente, el rastreo de /v1/realtime no cumple con los requisitos de residencia de datos en la UE.