OpenAI API 数据驻留

2026-11-19 10:59 更新

数据驻留是 API 项目级设置,用于选择 OpenAI 为项目提供服务时使用的基础设施区域。符合条件的组织可以在创建项目时启用。对 2026 年 3 月 5 日起发布且支持数据驻留的模型,使用数据驻留端点时适用 10% 的加价,详见定价。可联系销售确认适用资格和区域。

区域存储与推理

  • 区域存储。对于支持的端点、模型和快照,只有在服务需要持久化时,客户内容才会作为静态数据存放于选定区域。例如,批处理输入和输出由 /v1/batches 按其流程保存。
  • 区域处理。选定区域支持该模型与端点的区域处理时,客户内容的推理也在该区域进行。支持区域存储的组合可能仍需要在区域之外处理内容。
  • 系统数据。不含客户内容的运营数据不属于数据驻留范围,例如账号资料、直接访问服务的终端用户资料、元数据、用量和分析统计、账单、支持请求及结构化输出的 schema。

OpenAI 会使用分包处理方提供服务。发往 us.api.openai.com、eu.api.openai.com、au.api.openai.com、in.api.openai.com 和 jp.api.openai.com 的请求使用 Cloudflare Regional Services,TLS 终止与 HTTPS 解密位于所选处理区域。

数据驻留不涵盖由终端用户或客户基础设施所在位置引起的境外传输或存储,也不涵盖服务中由第三方提供的产品、服务、内容及系统数据。若所选区域不支持区域处理,OpenAI 为交付服务可能在区域外处理并临时存储客户内容。其他保留规则参阅平台数据控制。

在 API 项目中配置

  1. 组织所有者打开 API 平台的项目设置,选择创建。
  2. 输入名称,在 Data and inference residency 中选择可用区域。
  3. 创建项目,然后为该项目创建 API 密钥。
  4. 使用项目密钥和对应的区域域名。例如,欧洲区域的 API 基础地址为 https://eu.api.openai.com/v1。

项目创建后无法更改驻留区域。需要选择其他区域时,应新建项目。

按请求选择处理区域

创建支持此功能的新项目时,将 Data and inference residency 保持为 Global,勾选 Enable per-request data residency 后再创建。项目本身仍是 Global。对于已启用按请求驻留的 Global 项目,可继续使用现有项目密钥。对需要在特定区域处理的每条请求指定区域基础地址,并确认所用模型和端点均支持。

以下 Python 示例对全局、美国和欧洲请求复用同一个支持按请求选择区域的 Global 项目密钥。Ruby 示例中的欧洲调用按照官方示例另读 OPENAI_EU_API_KEY,并清除从默认客户端继承的组织与项目覆盖值。两个示例均从环境变量读取密钥。

from openai import OpenAI

## 从 OPENAI_API_KEY 读取支持按请求选择区域的项目密钥。
client = OpenAI()

## 使用全局端点,不指定处理区域。
response = client.responses.create(
    model="gpt-6.1-terra",
    input="只回复“收到”。",
)
print(response.output_text)

## 通过美国端点请求区域处理和存储。
response = client.with_options(
    base_url="https://us.api.openai.com/v1",
).responses.create(
    model="gpt-6.1-terra",
    input="只回复“收到”。",
)
print(response.output_text)

## 通过欧洲端点请求区域处理和存储。
response = client.with_options(
    base_url="https://eu.api.openai.com/v1",
).responses.create(
    model="gpt-6.1-terra",
    input="只回复“收到”。",
)
print(response.output_text)

require "openai"

## 从运行环境读取默认项目的密钥。
client = OpenAI::Client.new

response = client.responses.create(
  model: "gpt-6.1-terra",
  input: "只回复“收到”。"
)
puts(response.output_text)

## 选择美国区域。
response = client.with_options(data_residency: :us).responses.create(
  model: "gpt-6.1-terra",
  input: "只回复“收到”。"
)
puts(response.output_text)

## 此欧洲调用使用欧洲区域项目的密钥。
response = client.with_options(data_residency: :eu, api_key: ENV.fetch("OPENAI_EU_API_KEY"), organization: nil, project: nil).responses.create(
  model: "gpt-6.1-terra",
  input: "只回复“收到”。"
)
puts(response.output_text)

模型、服务和区域

在澳大利亚、印度、日本的选定区域项目中,gpt-6-luna 支持区域处理。这里只支持 Standard 按量付费。Responses 和 Chat Completions 支持文本与图像输入及文本输出,此处的区域处理中不提供托管工具。

GPT-6.2 Astra 和 GPT-6.2 Sol 支持美国及欧洲的 Standard、Fast、Batch。两者的 Ultrafast 数据驻留限美国。欧洲 Fast 模式支持 GPT-6.1 Sol、GPT-6.1 Terra、GPT-6 Luna。GPT-6 Astra、GPT-6 Sol 在欧洲不支持 Fast 模式。GPT-6.1 Sol、GPT-6.1 Terra、GPT-6 Sol、GPT-6 Luna 支持欧洲的 Standard、Flex、Batch。GPT-6.1 Sol 的 Ultrafast 可使用美国、欧洲驻留或全局处理,GPT-6 Astra 的 Ultrafast 可使用美国驻留或全局处理。

各区域支持情况

区域 域名 区域存储 区域处理 开通要求 输入输出模态
美国 us.api.openai.com 支持 支持 — 文本、音频、语音、图像
欧洲(欧洲经济区及瑞士) eu.api.openai.com 支持 支持 — 文本、音频、语音、图像(见注)
澳大利亚(见注) au.api.openai.com 支持 支持 — 文本、音频、语音、图像
加拿大(见注) ca.api.openai.com 支持 不支持 — 文本、音频、语音、图像
日本(见注) jp.api.openai.com 支持 支持 — 文本、音频、语音、图像
印度(见注) in.api.openai.com 支持 支持 — 文本、音频、语音、图像
新加坡(见注) sg.api.openai.com 支持 不支持 — 文本、音频、语音、图像
韩国(见注) kr.api.openai.com 支持 不支持 — 文本、音频、语音、图像
英国(见注) gb.api.openai.com 支持 不支持 — 文本、音频、语音、图像
阿联酋(见注) ae.api.openai.com 支持 支持 联系销售 开通该区域 文本、音频、语音、图像

带注区域或模态的图像支持需要额外审批。联系销售可核对开通要求。下面按相同服务范围合并展示,模型快照和区域例外以端点表为准。

美国、欧洲(欧洲经济区及瑞士)

  • 区域存储服务为 /v1/audio/transcriptions, /v1/audio/translations, /v1/audio/speech;/v1/batches;/v1/chat/completions;/v1/decisions;/v1/embeddings;/v1/evals;/v1/files;/v1/fine_tuning/jobs;/v1/images/edits;/v1/images/generations;/v1/moderations;/v1/live/sessions;/v1/realtime;/v1/realtime/transcription_sessions;/v1/realtime/translations;/v1/responses;/v1/responses File Search;/v1/responses Web Search;/v1/vector_stores;Code Interpreter tool;File Search;File Uploads;Remote MCP server tool;Scale Tier;Structured Outputs (excluding schema);Supported input modalities。
  • 区域处理服务为 /v1/audio/transcriptions, /v1/audio/translations, /v1/audio/speech;/v1/batches;/v1/chat/completions;/v1/decisions;/v1/embeddings;/v1/evals;/v1/fine_tuning/jobs;/v1/images/edits;/v1/images/generations;/v1/moderations;/v1/live/sessions;/v1/realtime;/v1/realtime/transcription_sessions;/v1/realtime/translations;/v1/responses;/v1/responses File Search;/v1/responses Web Search;Code Interpreter tool;File Search;Remote MCP server tool;Scale Tier;Structured Outputs (excluding schema);Supported input modalities。

澳大利亚、日本、印度

  • 区域存储服务为 /v1/audio/transcriptions, /v1/audio/translations, /v1/audio/speech;/v1/batches;/v1/chat/completions;/v1/decisions;/v1/embeddings;/v1/files;/v1/fine_tuning/jobs;/v1/images/edits;/v1/images/generations;/v1/moderations;/v1/responses;/v1/responses File Search;/v1/responses Web Search;/v1/vector_stores;Code Interpreter tool;File Search;File Uploads;Remote MCP server tool;Scale Tier;Structured Outputs (excluding schema);Supported input modalities。
  • 区域处理服务为 /v1/chat/completions (gpt-6-luna);/v1/responses (gpt-6-luna)。

加拿大、新加坡、韩国、英国

  • 区域存储服务为 /v1/audio/transcriptions, /v1/audio/translations, /v1/audio/speech;/v1/batches;/v1/chat/completions;/v1/decisions;/v1/embeddings;/v1/files;/v1/fine_tuning/jobs;/v1/images/edits;/v1/images/generations;/v1/moderations;/v1/responses;/v1/responses File Search;/v1/responses Web Search;/v1/vector_stores;Code Interpreter tool;File Search;File Uploads;Remote MCP server tool;Scale Tier;Structured Outputs (excluding schema);Supported input modalities。
  • 区域处理服务为 无。

阿联酋

  • 区域存储服务为 /v1/audio/transcriptions, /v1/audio/translations, /v1/audio/speech;/v1/batches;/v1/chat/completions;/v1/decisions;/v1/embeddings;/v1/files;/v1/fine_tuning/jobs;/v1/images/edits;/v1/images/generations;/v1/moderations;/v1/responses;/v1/responses File Search;/v1/responses Web Search;/v1/vector_stores;Code Interpreter tool;File Search;File Uploads;Remote MCP server tool;Scale Tier;Structured Outputs (excluding schema);Supported input modalities。
  • 区域处理服务为 /v1/chat/completions (gpt-5.6-luna, gpt-5.5-2026-04-23, gpt-5.2-2025-12-11);/v1/embeddings (text-embedding-3-large);/v1/responses (gpt-5.5-pro-2026-04-23, gpt-5.6-luna, gpt-5.5-2026-04-23, gpt-5.2-2025-12-11)。

API 端点、工具和模型支持

端点或功能 服务 存储区域 处理区域 模型与快照 区域处理例外 说明
/v1/audio/transcriptions, /v1/audio/translations, /v1/audio/speech 音频 所有列出的区域 美国, 欧洲(欧洲经济区及瑞士) tts-1, whisper-1, gpt-4o-tts, gpt-4o-transcribe, gpt-4o-mini-transcribe, gpt-transcribe 无 —
/v1/batches 批处理 所有列出的区域 美国, 欧洲(欧洲经济区及瑞士) gpt-6.2-astra, gpt-6.2-sol, gpt-6-astra, gpt-6.1-sol, gpt-6.1-terra, gpt-6-sol, gpt-6-luna, gpt-5.5-pro-2026-04-23, gpt-5.4-pro-2026-03-05, gpt-5.2-pro-2025-12-11, gpt-5-pro-2025-10-06, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.5-2026-04-23, gpt-5.4-2026-03-05, gpt-5-2025-08-07, gpt-5.4-mini-2026-03-17, gpt-5.4-nano-2026-03-17, gpt-5.2-2025-12-11, gpt-5.1-2025-11-13, gpt-5-mini-2025-08-07, gpt-5-nano-2025-08-07, gpt-4.1-2025-04-14, gpt-4.1-mini-2025-04-14, gpt-4.1-nano-2025-04-14, o3-2025-04-16, o4-mini-2025-04-16, o1-pro, o1-pro-2025-03-19, o3-mini-2025-01-31, o1-2024-12-17, gpt-4o-2024-11-20, gpt-4o-2024-08-06, gpt-4o-mini-2024-07-18, gpt-4-turbo-2024-04-09, gpt-4-0613, gpt-3.5-turbo-0125 无 GPT-6.2 Astra、GPT-6.2 Sol 在美国和欧洲支持 Batch。GPT-6.1 Sol、GPT-6.1 Terra、GPT-6 Sol、GPT-6 Luna 在欧洲支持 Standard、Flex、Batch。GPT-6.1 Sol 与 GPT-6.1 Terra 的驻留区域限美国和欧洲。
/v1/chat/completions Chat Completions 所有列出的区域 美国, 欧洲(欧洲经济区及瑞士), 阿联酋, 澳大利亚, 印度, 日本 gpt-6.2-astra, gpt-6.2-sol, gpt-6-astra, gpt-6.1-sol, gpt-6.1-terra, gpt-6-sol, gpt-6-luna, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.5-2026-04-23, gpt-5.4-2026-03-05, gpt-5.4-mini-2026-03-17, gpt-5.4-nano-2026-03-17, gpt-5.2-2025-12-11, gpt-5.1-2025-11-13, gpt-5-2025-08-07, gpt-5-mini-2025-08-07, gpt-5-nano-2025-08-07, gpt-4.1-2025-04-14, gpt-4.1-mini-2025-04-14, gpt-4.1-nano-2025-04-14, o3-mini-2025-01-31, o3-2025-04-16, o4-mini-2025-04-16, o1-2024-12-17, gpt-4o-2024-11-20, gpt-4o-2024-08-06, gpt-4o-mini-2024-07-18, gpt-4-turbo-2024-04-09, gpt-4-0613, gpt-3.5-turbo-0125 阿联酋: gpt-5.6-luna, gpt-5.5-2026-04-23, gpt-5.2-2025-12-11;澳大利亚, 印度, 日本: gpt-6-luna GPT-6.2 Astra 和 GPT-6.2 Sol 在美国、欧洲均支持 Standard 与 Fast。欧洲 Fast 可用于 GPT-6.1 Sol、GPT-6.1 Terra、GPT-6 Luna。GPT-6 Astra、GPT-6 Sol 的欧洲驻留不支持 Fast。GPT-6.1 Sol、GPT-6.1 Terra 的驻留区域限美国和欧洲。
/v1/decisions Decisions 所有列出的区域 美国, 欧洲(欧洲经济区及瑞士) gpt-6-luna 无 可由所有支持的 API 区域访问。区域处理限美国和欧洲(欧洲经济区及瑞士)。提示词缓存受下文的数据保留限制约束。
/v1/embeddings Embeddings 所有列出的区域 美国, 欧洲(欧洲经济区及瑞士), 阿联酋 text-embedding-3-small, text-embedding-3-large, text-embedding-ada-002 阿联酋: text-embedding-3-large —
/v1/evals Evals 美国, 欧洲(欧洲经济区及瑞士) 美国, 欧洲(欧洲经济区及瑞士) 服务级支持 无 —
/v1/files 文件 所有列出的区域 无 服务级支持 无 —
/v1/fine_tuning/jobs 微调 所有列出的区域 美国, 欧洲(欧洲经济区及瑞士) gpt-4o-2024-08-06, gpt-4o-mini-2024-07-18, gpt-4.1-2025-04-14, gpt-4.1-mini-2025-04-14 无 —
/v1/images/edits 图像 所有列出的区域 美国, 欧洲(欧洲经济区及瑞士) gpt-image-2.5-sunburst, gpt-image-2.5-sunburst-2026-09-08, gpt-image-2.5-flare, gpt-image-2.5-flare-2026-09-08, gpt-image-2, gpt-image-1.5, gpt-image-1-mini 无 —
/v1/images/generations 图像 所有列出的区域 美国, 欧洲(欧洲经济区及瑞士) gpt-image-2.5-sunburst, gpt-image-2.5-sunburst-2026-09-08, gpt-image-2.5-flare, gpt-image-2.5-flare-2026-09-08, gpt-image-2, gpt-image-1.5, gpt-image-1-mini 无 —
/v1/moderations 内容审核 所有列出的区域 美国, 欧洲(欧洲经济区及瑞士) omni-moderation-latest 无 —
/v1/moderations (CSAM 分类器) 内容审核 未列明 未列明 omni-moderation-csam-latest — 符合审批条件的组织可用。官方未列明此模型的区域处理范围。
/v1/live/sessions GPT-Live 美国, 欧洲(欧洲经济区及瑞士) 美国, 欧洲(欧洲经济区及瑞士) gpt-live-1 无 —
/v1/realtime Realtime 美国, 欧洲(欧洲经济区及瑞士) 美国, 欧洲(欧洲经济区及瑞士) gpt-realtime, gpt-realtime-1.5, gpt-realtime-mini, gpt-realtime-2, gpt-realtime-2.1, gpt-realtime-2.1-mini 无 —
/v1/realtime/transcription_sessions Realtime 美国, 欧洲(欧洲经济区及瑞士) 美国, 欧洲(欧洲经济区及瑞士) gpt-realtime-whisper, gpt-live-transcribe, gpt-transcribe 无 —
/v1/realtime/translations Realtime 美国, 欧洲(欧洲经济区及瑞士) 美国, 欧洲(欧洲经济区及瑞士) gpt-realtime-translate 无 —
/v1/responses Responses 所有列出的区域 美国, 欧洲(欧洲经济区及瑞士), 阿联酋, 澳大利亚, 印度, 日本 gpt-6.2-astra, gpt-6.2-sol, gpt-6-astra, gpt-6.1-sol, gpt-6.1-terra, gpt-6-sol, gpt-6-luna, gpt-5.5-pro-2026-04-23, gpt-5.4-pro-2026-03-05, gpt-5.2-pro-2025-12-11, gpt-5-pro-2025-10-06, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.5-2026-04-23, gpt-5.4-2026-03-05, gpt-5-2025-08-07, gpt-5.4-mini-2026-03-17, gpt-5.4-nano-2026-03-17, gpt-5.2-2025-12-11, gpt-5.1-2025-11-13, gpt-5-mini-2025-08-07, gpt-5-nano-2025-08-07, gpt-4.1-2025-04-14, gpt-4.1-mini-2025-04-14, gpt-4.1-nano-2025-04-14, o3-2025-04-16, o4-mini-2025-04-16, o1-pro, o1-pro-2025-03-19, o3-mini-2025-01-31, o1-2024-12-17, gpt-4o-2024-11-20, gpt-4o-2024-08-06, gpt-4o-mini-2024-07-18, gpt-4-turbo-2024-04-09, gpt-4-0613, gpt-3.5-turbo-0125 阿联酋: gpt-5.5-pro-2026-04-23, gpt-5.6-luna, gpt-5.5-2026-04-23, gpt-5.2-2025-12-11;澳大利亚, 印度, 日本: gpt-6-luna GPT-6.2 Astra 和 GPT-6.2 Sol 在美国、欧洲均支持 Standard 与 Fast。欧洲 Fast 可用于 GPT-6.1 Sol、GPT-6.1 Terra、GPT-6 Luna。GPT-6 Astra、GPT-6 Sol 的欧洲驻留不支持 Fast。GPT-6.1 Sol、GPT-6.1 Terra 的驻留区域限美国和欧洲。
/v1/responses File Search Responses 所有列出的区域 美国, 欧洲(欧洲经济区及瑞士) 服务级支持 无 —
/v1/responses Web Search Responses 所有列出的区域 美国, 欧洲(欧洲经济区及瑞士) 服务级支持 无 —
/v1/vector_stores 向量存储 所有列出的区域 无 服务级支持 无 —
Code Interpreter tool 工具 所有列出的区域 美国, 欧洲(欧洲经济区及瑞士) 服务级支持 无 —
File Search 工具 所有列出的区域 美国, 欧洲(欧洲经济区及瑞士) 服务级支持 无 —
File Uploads 文件 所有列出的区域 无 服务级支持 无 使用 Base64 文件上传时支持。
Remote MCP server tool 工具 所有列出的区域 美国, 欧洲(欧洲经济区及瑞士) 服务级支持 无 MCP 服务器属于第三方服务。发给 MCP 服务器的数据受该服务的数据驻留政策约束。
Scale Tier 其他 所有列出的区域 美国, 欧洲(欧洲经济区及瑞士) 服务级支持 无 —
Structured Outputs (excluding schema) 其他 所有列出的区域 美国, 欧洲(欧洲经济区及瑞士) 服务级支持 无 —
Supported input modalities 其他 所有列出的区域 美国, 欧洲(欧洲经济区及瑞士) Text, Image, Audio/Voice 无 —

端点限制

Decisions、Chat Completions 和 Responses

Decisions 可在受支持的 API 区域访问,区域推理仅由美国和欧洲(欧洲经济区及瑞士)支持。Chat Completions 在美国以外的区域不能设置 store=true。

对于 /v1/decisions、/v1/chat/completions、/v1/responses,在不支持相应区域处理的区域使用延长的提示词缓存时,为交付服务,客户内容可能在区域外处理及临时存储。

GPT-Live 会话

/v1/live/sessions 支持在美国和欧洲使用数据驻留。启用零数据保留后,store 按 false 处理。

会话存储默认关闭。在允许存储的项目中设置 store: true,可保留已结束会话的录音及索引 30 天,用于下载或启动分叉会话。下载和分叉要求数据策略允许持久化,启用零数据保留时不可用。对分叉设置 store: false 只影响新会话,源录音及其访问要求仍继续适用。API 没有公开的已存会话删除端点。被委派的后端模型和工具各自应用对应的数据规则。

Realtime

/v1/realtime 的追踪功能目前不符合欧洲区域的数据驻留要求。

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号