OpenAI 官方 API 文档指南

简介

OpenAI 提供强大的 API 接口，让开发者可以轻松集成先进的语言模型（如 GPT-4、GPT-3.5 Turbo）到自己的应用程序中。无论是聊天机器人、内容生成、代码辅助还是智能客服，OpenAI API 都能提供卓越的 AI 能力。

本文档为非官方整理的入门指南，旨在帮助开发者快速理解并使用 OpenAI 官方 API。建议同时参考 OpenAI 官方文档 获取最新信息。

快速开始

1. 获取 API Key

登录 OpenAI 平台，进入 API Keys 页面创建新的密钥。

2. 安装 SDK（可选）

OpenAI 官方提供多种语言的 SDK，例如 Python：

pip install openai

3. 发送第一个请求

以下是一个使用 cURL 调用 Chat Completions API 的示例：

curl https://api.openai.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-3.5-turbo",
    "messages": [{"role": "user", "content": "你好！"}]
  }'

常用模型

• gpt-4：最强大、最智能的模型，适合复杂任务。
• gpt-3.5-turbo：性价比高，响应快，适合大多数应用场景。
• text-embedding-ada-002：用于生成文本向量，支持语义搜索和聚类。
• dall-e：图像生成模型（通过独立端点调用）。

最佳实践

• 始终将 API Key 存储在环境变量或安全的密钥管理服务中，切勿硬编码在前端或公开代码中。
• 设置合理的 max_tokens 避免意外高额费用。
• 使用流式响应（stream: true）提升用户体验。
• 监控用量和错误日志，及时优化提示（prompt）。

资源链接

• OpenAI 官方 API 文档
• API Key 管理页面
• Playground 在线调试工具
• Python SDK GitHub 仓库