OpenAI 接口文档

简介

OpenAI 提供强大的人工智能 API，支持文本生成、对话、代码补全、图像生成等多种能力。本页面为开发者提供简洁明了的接口文档概览，帮助您快速集成 OpenAI 服务。

认证方式

所有 OpenAI API 请求都需要通过 Bearer Token 进行身份验证。请在请求头中添加：

Authorization: Bearer YOUR_API_KEY

您可以在 OpenAI 平台 获取 API Key。

常用模型

• gpt-4o：最新多模态旗舰模型，支持文本与图像输入。
• gpt-4-turbo：高性能文本生成模型，上下文长度达 128K tokens。
• gpt-3.5-turbo：经济高效的对话模型，适合大多数应用场景。
• dall-e-3：高质量图像生成模型。

文本生成示例（Chat Completions）

使用 /v1/chat/completions 端点发送对话请求：

POST https://api.openai.com/v1/chat/completions
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "model": "gpt-3.5-turbo",
  "messages": [
    {"role": "system", "content": "你是一个有帮助的助手。"},
    {"role": "user", "content": "你好！"}
  ]
}

速率限制与配额

OpenAI 对 API 调用设有速率限制（RPM/TPM），具体取决于您的账户类型和所选模型。建议在生产环境中实现重试机制与错误处理逻辑。

更多详情请参考 官方限流文档。

常见问题

1. 如何降低成本？ 选择合适的模型（如 gpt-3.5-turbo 而非 gpt-4），并优化提示词减少 token 消耗。
2. API 返回错误怎么办？ 检查 HTTP 状态码（如 429 表示限流，401 表示认证失败）。
3. 是否支持中文？ 是的，所有主流模型均良好支持中文输入与输出。