OpenAI API 文档指南

简介

OpenAI API 提供了强大的语言模型（如 GPT-4、GPT-3.5 Turbo）接口，可用于文本生成、问答、翻译、摘要等多种任务。本页面为你提供简明、实用的文档概览，助你快速集成 OpenAI 能力到你的应用中。

认证方式

所有 API 请求必须包含有效的 API Key，通过 HTTP Header 传递：

Authorization: Bearer YOUR_API_KEY

请在 OpenAI 平台 创建并管理你的密钥。

基础请求示例

以下是一个使用 gpt-3.5-turbo 模型进行对话的请求示例：

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": "你好！"}
  ]
}

常用模型对比

• gpt-4：最强性能，适合复杂任务，响应较慢，费用较高。
• gpt-3.5-turbo：性价比高，速度快，适合大多数应用场景。
• text-embedding-ada-002：用于生成文本向量，适用于语义搜索和聚类。

常见错误处理

• 401 Unauthorized：API Key 无效或缺失。
• 429 Too Many Requests：请求频率超出配额限制。
• 400 Bad Request：请求体格式错误或缺少必要字段。

建议在代码中加入重试机制与错误日志记录。

JavaScript 调用示例

async function askOpenAI(prompt) {
  const response = await fetch('https://api.openai.com/v1/chat/completions', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      model: 'gpt-3.5-turbo',
      messages: [{ role: 'user', content: prompt }]
    })
  });
  const data = await response.json();
  return data.choices[0].message.content;
}

⚠️ 注意：出于安全考虑，不要在前端直接暴露 API Key。建议通过后端代理调用。

更多资源

• 官方完整文档
• 模型详情
• 开发者社区