用途:本资料是 OpenAI 传统无状态 API 的完整使用指南,版本标注为 Production Ready,包版本 openai@6.7.0,最后更新 2025-10-25。它面向需要用 OpenAI 接口做对话、文本生成、检索与多模态处理的开发者。
主要能力:Chat Completions API(端点 POST /v1/chat/completions),支持 GPT-5、GPT-5-mini、GPT-5-nano、GPT-4o、GPT-4 Turbo 等模型;Embeddings API,支持 text-embedding-3-small/large;Images API,支持 DALL-E 3 生成与 GPT-Image-1 编辑;Audio API,支持 Whisper 转录与 11 种声音的 TTS;Moderation API 含 11 个安全类别;另含流式(SSE)、函数调用/工具、结构化输出(JSON schema)、GPT-4o 视觉能力。
使用方式:安装 npm install openai@6.7.0,配置环境变量 OPENAI_API_KEY。可用 Node.js SDK 创建客户端后调用 openai.chat.completions.create,也可用 fetch 直接请求 https://api.openai.com/v1/chat/completions,并带 Authorization Bearer 头。消息角色含 system、user、assistant。流式需设 stream: true 并处理 SSE 的 data: 行与 [DONE]。函数调用需给出 tools 定义、处理 message.tool_calls,并以 role: tool 与 tool_call_id 回传结果。结构化输出用 response_format 的 json_schema 或 json_object。
适用场景:需要无状态对话、文本生成、语义检索与 RAG 嵌入、图像生成或编辑、语音转录与合成、内容审核、视觉理解的集成开发。
限制:Chat Completions 无状态,每次请求须发送完整对话历史;有状态对话请使用 openai-responses。GPT-5 不支持 temperature、top_p、logprobs,不支持多轮思维链持久化,也不支持视觉;需要这些能力时改用 GPT-4o 或 GPT-4 Turbo。资料另列出错误处理、速率限制与生产最佳实践章节,但正文未展开细节。定价、配额与平台信息暂未提供。