用途:面向 OpenAI API 的调用指南,当用户提到 OpenAI、GPT、ChatGPT API 或 OpenAI 模型时使用,不适用于 Anthropic/Claude。鉴权依赖环境变量 OPENAI_TOKEN,Base URL 为 https://api.openai.com/v1。
主要能力:
- 聊天补全(/chat/completions),支持 system 提示设定行为、stream 流式返回 SSE delta。
- JSON 模式:设置 response_format 为 {"type": "json_object"},需配合 system 提示要求仅返回 JSON。
- 视觉:gpt-4o/gpt-4o-mini 支持 image_url 图像输入,可配 max_tokens。
- 函数调用:tools 中定义 function 及 parameters,读取返回的 tool_calls。
- 嵌入(/embeddings):text-embedding-3-small(1536 维)与 text-embedding-3-large(3072 维)。
- 图像生成(/images/generations):gpt-image-2 与 dall-e-3,可设 size、quality、output_format、background、moderation、n 等;gpt-image-2 始终返回 base64。
- 音频:Whisper(whisper-1)转写,支持 mp3/mp4/mpeg/mpga/m4a/wav/webm,最大 25MB;TTS(tts-1、tts-1-hd)支持 alloy、echo、fable、onyx、nova、shimmer 音色。
- 列出模型(/models)与查看 usage(prompt_tokens、completion_tokens、total_tokens)。
使用方式:以 curl 发请求,示例:curl -s "https://api.openai.com/v1/chat/completions" -H "Content-Type: application/json" -H "Authorization: Bearer $OPENAI_TOKEN" -d @/tmp/openai_request.json。请求参数常写入 /tmp/openai_request.json。模型可选 gpt-4o、gpt-4o-mini、gpt-4-turbo、gpt-3.5-turbo、o1、o1-mini。
故障排查:请求失败可运行 zero doctor check-connector --env-name OPENAI_TOKEN 或 zero doctor check-connector --url https://api.openai.com/v1/chat/completions --method POST。
适用场景与限制:适合对话、结构化 JSON 输出、图像理解与生成、语义嵌入、语音转写与合成等集成。注意视觉仅 gpt-4o 系列支持;JSON 模式需 system 提示;建议设置 max_tokens 并用 streaming 优化长响应体验;批量化嵌入请求;监控用量避免意外费用。收费、价格与更多平台细节暂未提供。