文本、代码与结构化结果
根据输入生成或改写文字、解释代码、提取信息，并按支持的 JSON Schema 输出结构化数据，便于接入表单和业务流程。
接入要求使用支持目标能力的模型与接口；结构化格式约束不等于事实正确，应用仍需处理拒绝、截断和业务校验。
使用 Responses 生成文本站内调用手册 · 参数、代码与排错把文字提取成固定 JSON 字段站内调用手册 · 参数、代码与排错AI 与多媒体 / OpenAI API Platform
OpenAI API
提供模型推理和多模态接口，可开发内容生成、视觉分析、语音交互、语义检索及连接业务系统的智能助手。各模型、工具与接入方式的支持范围不同，需按项目权限和模型文档选择。
01 / CAPABILITIES
开放功能
核心接口调用手册
3 个场景覆盖 Responses 文本生成、按 JSON Schema 提取结构化数据、文本向量三个场景。提供直接 HTTP 请求，不依赖 SDK；未包含图像、语音和实时会话。
图像理解
向支持视觉的模型提交图片，生成描述、比较内容或围绕图像回答问题，适用于图片信息提取和视觉辅助分析。
接入要求选择支持图像输入的模型，按要求提供 URL、文件或编码后的图片；图像尺寸、细节档位和模型会影响用量及效果。
图像生成与编辑
从文字生成图片，或结合已有图片修改内容；可通过图片接口使用，也可在支持的对话流程中调用图像工具。
接入要求模型和接口须支持生成或编辑；部分图像模型可能要求完成组织验证，输出规格与内容限制按官方指南。
语音识别、翻译与合成
把音频转成文本、完成支持的音频翻译任务，或把文字合成为语音，用于字幕、播报和语音工具。
接入要求按任务选择转写、翻译或语音合成接口；文件格式、语言和输出格式以对应模型为准，不能把一种语音接口能力套给全部模型。
实时语音交互
通过实时会话收发音频、维护对话状态并调用工具，适合低延迟语音助手及支持打断的交互体验。
接入要求按场景使用 WebRTC 或 WebSocket；浏览器由自己的服务端创建短期凭证，业务工具、会话状态和断线处理需自行实现。
工具调用与外部数据
让模型请求自己定义的函数，也可使用支持的网络搜索、文件检索及远程 MCP 等工具，把推理与业务数据连接起来。
接入要求工具可用性依模型和接口而异；自己的系统负责授权、执行函数与返回结果，函数定义不会自动授予业务账号权限。
向量与语义检索
把文本转换成向量，用于相似度搜索、推荐、分类和聚类，也可作为自建知识检索流程的一部分。
接入要求调用嵌入接口并选择合适维度；向量存储、索引和业务检索流程需自行建设或另接服务，输入按 Token 计量。
生成文本检索向量站内调用手册 · 参数、代码与排错02 / REQUIREMENTS
接入条件
- 适用主体
- 独立开发者、AI 应用开发者、企业研发团队、语音与多媒体工具开发者
- 接入方式
- 项目 API Key 通过 HTTP Bearer 鉴权，密钥保存在服务端 / 支持工作负载身份联合的场景可使用短期访问令牌 / 浏览器实时语音使用服务端签发的短期会话凭证，避免暴露长期密钥
- 申请概况
- 需服务支持地区账号，部分模型需额外验证
- 注册并使用符合服务资格的 API 平台账号，在有权限的组织和项目中创建 API Key；个人或团队应分别确认自己的实际开户与付费条件。
- 访问与提供服务的地区须符合官方支持地区清单；本次清单未列中国大陆，不能把中国大陆可直接使用作为默认条件。
- 配置 API 账单、可用余额和项目权限；模型是否可用、是否需额外验证，以及请求和 Token 限额均以账号后台及对应模型要求为准。
- 长期 API Key 只能保存在服务端或密钥管理系统中；浏览器和移动端不能直接公开长期密钥，实时客户端可使用短期会话凭证。
- 按功能确认接口支持的模型、输入输出类型和工具；需要访问自己的数据库、文件或第三方服务时，另行实现相应授权和执行逻辑。
03 / GET STARTED
开通步骤
- 01
确认地区与账号资格
先阅读支持地区清单，登录 API 平台确认组织、项目、可用模型和账单状态。
- 02
创建服务端密钥
为应用创建项目密钥并设置最小权限，保存在环境变量或密钥系统中；团队成员使用各自获授权的身份。
- 03
跑通一个目标场景
按官方 Quickstart 选择文本、图像或语音任务，先验证输入、输出、错误处理及实际用量，再接业务工具。
- 04
分开开发与生产
使用独立项目及密钥管理测试和生产，检查限流、用量与支出控制；确认模型和工具权限后再上线。
04 / COSTS & LIMITS
费用、边界与测试方式
费用概况
按模型与工具实际用量计费，先分清 Token、时长、调用次数和存储。
- 文本模型价格通常分别列输入、缓存输入和输出的每百万 Token 单价；部分模型另有缓存写入、长上下文或不同处理档位，不能只用输出字数估算。
- 图片输入和生成、音频输入输出依模型采用各自计量规则；部分转写或语音会按时长列价，应查该模型的计费单位。
- 嵌入模型按输入 Token 量计费；自行使用的向量数据库和其他外部服务另计。
- 内置工具可能额外计费，例如搜索按调用量、文件检索同时涉及调用和按 GB·天计量的存储；相关模型 Token 费用也需计入。
- 官方通用价格页未承诺所有新账号固定免费额度；试用或赠送以实际账号显示及有效期为准，开发调试也应查看用量。
使用范围与限制
- 本条目介绍 API 开放能力，不把 ChatGPT 界面中的所有功能直接视为可通过 API 获取；具体接口与账号资格需分别确认。
- 支持地区、模型可见性、组织验证和项目角色共同影响接入；持有密钥不代表可调用所有模型或管理接口。
- 模型回复可能不准确；结构化输出约束数据格式，不能代替业务规则和事实核验。
- 请求量、Token 量和部分模态有不同限额，失败重试应退避；分配更多项目不代表能绕过组织级限制。
- 图像、音频、文件和外部工具各有输入规格与内容要求，使用前应阅读对应接口说明。
如何进行开发测试
- 开发环境：使用独立项目、密钥和测试数据调试；实际模型及工具调用仍需按账号价格与额度计量。
- 生产环境：独立管理访问权限、密钥、限流和支出；不要把测试项目的模型权限直接推断为生产项目权限。
- 实时客户端：由后端创建短期会话凭证；这不是通用免计费沙盒。
接入前再确认
- 支持地区已按当前官方名单核对；未登录账号，不代表任何特定用户已具备资格、余额或模型权限。
- 模型、工具与组织验证条件需按实际项目确认；不同项目的权限和限额可能不同。
- 未注册账号、生成密钥或调用实际 API；费用说明不代表已测得实际业务成本。
05 / OFFICIAL SOURCES
官方资料
以下资料用于核对本页内容。申请与使用时，请以对应接口的最新规则为准。
- 01Developer quickstart：密钥与首次调用已核对官方资料 · 2026-10-15
- 02API Overview：身份凭证与服务端保管已核对官方资料 · 2026-10-15
- 03Supported countries and territories已核对官方资料 · 2026-10-15
- 04Manage permissions：组织、项目与密钥权限已核对官方资料 · 2026-10-15
- 05Production best practices：组织、账单与环境管理已核对官方资料 · 2026-10-15
- 06Rate limits：请求量与 Token 限额已核对官方资料 · 2026-10-15
- 07Text generation已核对官方资料 · 2026-10-15
- 08Structured model outputs已核对官方资料 · 2026-10-15
- 09Images and vision已核对官方资料 · 2026-10-15
- 10Image generation：生成、编辑与验证条件已核对官方资料 · 2026-10-15
- 11Audio and voice：转写、翻译、合成与会话已核对官方资料 · 2026-10-15
- 12Getting started with the Realtime API已核对官方资料 · 2026-10-15
- 13Using tools：内置工具和 MCP已核对官方资料 · 2026-10-15
- 14Function calling：应用执行与模型请求已核对官方资料 · 2026-10-15
- 15Vector embeddings：用途与输入 Token 计费已核对官方资料 · 2026-10-15
- 16Pricing：模型、模态、工具与存储已核对官方资料 · 2026-10-15
- 17API 平台登录入口官方入口 · 细则待复核 · 2026-10-15
官方文档核对，未进行接口实测
最近核验 2026-10-15 · 查看核验说明
最近核验 2026-10-15 · 查看核验说明
