用途:本资料是 OpenAI API 的完整使用指南,基于 openai@6.9.1(更新于 2025-11-21),面向需要调用 OpenAI 各类接口的开发者,帮助完成文本对话、嵌入、图像生成与编辑、语音转写与合成、内容审核等任务。
主要能力:对话补全支持 gpt-5.2、gpt-4o、gpt-4o-mini、o1-preview、o1-mini 等模型,支持系统与用户消息、temperature、max_tokens 参数,并提供流式响应与函数调用(tools)。嵌入使用 text-embedding-3-small,输出 1536 维向量。图像使用 gpt-image-1.5,可设 size 与 quality(standard 或 hd)。音频包含 Whisper 转写(whisper-1)与 TTS(tts-1,voice 如 alloy)。还包括内容审核接口。
使用方式:安装命令为 bun add openai,并设置环境变量 export OPENAI_API_KEY="sk-..."。通过 import OpenAI from 'openai' 创建客户端后可调用 chat.completions.create、embeddings.create、images.generate、audio.transcriptions.create、audio.speech.create 等方法。资料提供 references 参考指南(模型对比、函数调用、结构化输出、嵌入、图像、音频、成本优化、错误目录等)与 templates 模板(基础用法、流式、函数调用、视觉、嵌入、图像生成与编辑、转写、TTS、审核、限流处理、Cloudflare Worker 等)。
常见错误:401 无效密钥需检查 OPENAI_API_KEY;429 限流应实现指数退避;404 模型不存在需核对模型名;400 上下文超长需缩减输入;函数调用 JSON 无效需修正 schema。
限制:本资料主要给出接口能力、参数与示例,具体定价、速率上限、平台可用性等未提供,需以官方文档为准。