该资料是一份面向开发者的 OpenAI 无状态 API 使用指南，标注为 Production Ready，使用 openai@6.16.0 包，最后更新于 2026-01-20。
一、用途 用于指导开发者通过 OpenAI 的无状态 HTTP API（以及 Node.js SDK 与 fetch 两种方式）调用语言、向量、图像、音频与审核等多类模型能力。文档强调 API 本身是无状态的，需要每次请求携带完整对话历史；如需有状态对话，作者指向 openai-responses 技能。
二、主要能力（均为文档明确列出的接口与模型）
- Chat Completions API（端点 POST /v1/chat/completions）：核心语言模型接口，支持对话、文本生成、函数调用、结构化输出与视觉。支持 GPT-5 系列（gpt-5、gpt-5-mini、gpt-5-nano）、GPT-4o 系列（gpt-4o、gpt-4-turbo）、GPT-4（旧版，文档建议改用 gpt-5 或 gpt-4o），以及 o 系列推理模型（o3、o3-pro、o3-mini、o4-mini）。
- GPT-5 系列参数：reasoning_effort（none/minimal/low/medium/high/xhigh）、verbosity（low/medium/high）。其中 gpt-5.2 标注 400k 上下文窗口、128k 输出 token、xhigh 推理档、Compaction 扩展上下文，价格标注为每百万 token $1.75/$14；gpt-5.1 标注自适应推理与 24 小时扩展提示缓存，并新增 apply_patch、shell 开发工具。文档提示 GPT-5 不支持 temperature、top_p、logprobs，且不支持有状态的思维链。
- 流式输出（stream: true）：给出 Node.js SDK 与 fetch（Cloudflare Workers）两种 SSE 处理示例，需处理不完整分块、[DONE] 信号与非法 JSON。
- 函数调用（Tools）：以 JSON Schema 定义工具，处理 tool_calls 并回传 role: tool 结果，循环直至无 tool_calls。
- 结构化输出：response_format 的 json_schema（strict）与 json_object 两种方式，文档建议提示词中包含“JSON”。
- 视觉（GPT-4o）：支持图片 URL、Base64 data URL 与多图对比。
- Embeddings API（POST /v1/embeddings）：text-embedding-3-large（3072 维，可自定义 256-3072）、text-embedding-3-small（1536 维，可自定义 256-1536），支持自定义维度与批量处理，限制为单输入 8192 token、批次总量 300k token、数组最大 2048。
- Images API：DALL-E 3 生成（POST /v1/images/generations，仅支持 n=1，可能改写提示词，URL 1 小时过期）；GPT-Image-1 编辑（POST /v1/images/edits，使用 multipart/form-data，支持透明背景、image_2 合成、input_fidelity 等）。
- Audio API：Whisper 转写（POST /v1/audio/transcriptions，支持 mp3/mp4/mpeg/mpga/m4a/wav/webm）；TTS（POST /v1/audio/speech），模型 tts-1、tts-1-hd、gpt-4o-mini-tts，11 种音色（alloy、ash、ballad、coral、echo、fable、onyx、nova、sage、shimmer、verse），支持速度 0.25-4.0、多种输出格式，gpt-4o-mini-tts 支持语音指令与 SSE 流式。
- Moderation API：11 个安全类别。
三、使用方式 安装：npm install openai@6.16.0；设置环境变量 OPENAI_API_KEY 或使用 .env 文件。文档给出 Node.js SDK 与 fetch 两种首个 Chat Completion 调用示例，并注明结构化输出、流式、函数调用、视觉等各种代码写法。
四、其他内容 文档还包含错误处理、速率限制、常见错误与陷阱、TypeScript 注意事项、生产实践，以及本技能与 openai-responses 的关系说明。
五、限制与说明 原文在音频部分的 Note 处截断，后续内容暂未提供。文档中涉及的具体价格、模型发布时间、上下文窗口等均以原文标注为准；未在资料中出现的功能、收费、平台或效果信息暂未提供。