OpenAI API

OpenAI 提供面向开发者的开放平台与 REST/Streaming/Realtime API，包括通用回复（Responses API）、传统聊天补全（Chat Completions）、嵌入向量（Embeddings）、图像生成（Images）、语音文本（Audio：TTS/转写）、以及 Assistants 线程与运行（Threads/Runs）。统一基础地址为 https://api.openai.com/v1，采用 Bearer 令牌进行鉴权。用量与速率限制因账户和模型而异，参考官方限速文档与账户控制台。

基础 URL
https://api.openai.com/v1
官网
https://openai.com/
开放平台
https://platform.openai.com/docs
认证
Bearer / Authorization: Bearer $OPENAI_API_KEY
官方 SDK
Python, Node.js
定价
https://openai.com/api/pricing/
🔑 API Key 获取
前置要求：需要有效账号与受支持地区；建议完成邮箱与手机号验证并添加账单信息以提升配额与限速。
入口：https://platform.openai.com/api-keys
说明：在 OpenAI 平台创建或登录账号，进入平台控制台左侧的“API keys”页面，点击“Create new secret key”生成密钥（仅显示一次）。

支持模型

API 接口列表

GET /v1/models Docs

列出可用模型及其元信息。

认证是
频率限制60/min
计费模式免费列举；实际计费取决于后续调用的具体模型与端点
curl https://api.openai.com/v1/models -H 'Authorization: Bearer $OPENAI_API_KEY'
POST /v1/responses Docs

统一的 Responses API，用于对话与工具调用等通用生成任务。

认证是
频率限制60/min
计费模式按模型令牌计费（输入/输出分开计费）；Responses 不单独计价
{
  "model": "gpt-4.1",
  "input": "Say hello to the world"
}
POST /v1/chat/completions Docs

聊天补全（历史端点），支持消息列表输入与流式输出。

认证是
频率限制60/min
计费模式按模型令牌计费（输入/输出分开计费）
{
  "model": "gpt-4o",
  "messages": [
    {
      "role": "system",
      "content": "You are a helpful assistant."
    },
    {
      "role": "user",
      "content": "Give me a quick example."
    }
  ],
  "stream": true
}
POST /v1/embeddings Docs

生成文本嵌入向量，用于检索与相似度计算。

认证是
频率限制60/min
计费模式按模型令牌计费（通常仅输入计费）
{
  "model": "text-embedding-3-large",
  "input": "The quick brown fox jumps over the lazy dog"
}
POST /v1/images/generations Docs

图像生成（支持 gpt-image-1 / DALL·E），可指定尺寸与返回格式。

认证是
频率限制60/min
计费模式按模型令牌与图片输出计费（详见价格页面）
{
  "model": "gpt-image-1",
  "prompt": "A cute baby sea otter",
  "n": 1,
  "size": "1024x1024"
}
POST /v1/audio/transcriptions Docs

语音转写（Whisper / 4o-transcribe 系列），上传音频文件并返回文本。

认证是
频率限制60/min
计费模式按模型令牌计费；大文件可能需分片或批处理
{
  "model": "whisper-1",
  "file": "@/path/to/audio.mp3"
}
POST /v1/threads/{thread_id}/runs Docs

为指定线程创建一次运行，用于 Assistants 工作流执行。

认证是
频率限制60/min
计费模式按模型令牌计费（工具调用与检索可能产生额外费用）
{
  "assistant_id": "asst_XXXX",
  "instructions": "Answer with concise bullet points."
}