[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-easychen--openai-gpt-dev-notes-for-cn-developer":3,"tool-easychen--openai-gpt-dev-notes-for-cn-developer":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",149489,2,"2026-04-10T11:32:46",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[52,13,15,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":32,"last_commit_at":59,"category_tags":60,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":76,"owner_location":77,"owner_email":75,"owner_twitter":72,"owner_website":78,"owner_url":79,"languages":80,"stars":85,"forks":86,"last_commit_at":87,"license":75,"difficulty_score":88,"env_os":89,"env_gpu":90,"env_ram":90,"env_deps":91,"category_tags":94,"github_topics":75,"view_count":32,"oss_zip_url":75,"oss_zip_packed_at":75,"status":17,"created_at":95,"updated_at":96,"faqs":97,"releases":98},6299,"easychen\u002Fopenai-gpt-dev-notes-for-cn-developer","openai-gpt-dev-notes-for-cn-developer","如何快速开发一个OpenAI\u002FGPT应用：国内开发者笔记","openai-gpt-dev-notes-for-cn-developer 是一份专为国内开发者编写的实战指南，旨在帮助大家快速上手并构建基于 OpenAI\u002FGPT 的应用。针对国内网络环境无法直接访问 OpenAI 官网、注册账号困难以及 API 调用受阻等痛点，该笔记详细梳理了从基础概念到落地运营的全流程解决方案。\n\n内容涵盖 ChatGPT 与 OpenAI 模型的关系解析、核心接口（chat completions）的调用方法、流式输出（Stream）的技术细节、计费策略分析，以及如何合规地在国内上线 GPT 相关业务。特别值得一提的是，它提供了通过第三方接口绕过网络限制、避免账号封禁等实用技巧，并分享了将免费应用转化为商业产品的思路。\n\n这份资料非常适合希望利用大模型能力进行产品创新的软件工程师、独立开发者及创业团队。无论是想快速验证想法的原型开发，还是设计拥有独特提示词与工作流的商业化应用，都能从中获得清晰的技术路径和本土化实操建议，帮助开发者在看似红海的市场中打造出差异化的 AI 体验。","在写了一堆应用以后，我们打算[众筹一个GPT课程](https:\u002F\u002Fsubdeer.cn\u002Fproduct\u002F3)。之前我以为现在GPT应用已经是红海了，但实际测试下来发现，GPT应用其实可以是非标准品。独有的提示词、独有的知识库、独有的工作流都可以做出独一无二的GPT体验。\n\n在课程中我们将讲解如何设计、搭建和开发一个与众不同的商业GPT应用。\u003Chttps:\u002F\u002Fsubdeer.cn\u002Fproduct\u002F3>\n\n# 如何快速开发一个OpenAI\u002FGPT应用\n\n> 一个国内开发者的OpenAI\u002FGPT的笔记\n\n\n最近都在问，于是写个文档。本文希望用尽可能少的内容，讲清楚开发一个OpenAI\u002FGPT应用必然用到的知识，内容主要聚焦在免费应用开发，商业化方案可以看看这篇文章：[《十分钟，给你开发的免费GPT应用加上收费功能》](https:\u002F\u002Fa.ftqq.com\u002F2023\u002F04\u002F18\u002Fapi2d-developer-program\u002F)\n\n欢迎PR补充。\n\n### AI\u002FAutomation开发交流群\n\n1. 电报群 \u003Chttps:\u002F\u002Ft.me\u002F+s-5piM3koEphNDY1>\n1. 微信群 \n\n![](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Feasychen_openai-gpt-dev-notes-for-cn-developer_readme_bcd16035b82e.jpeg)\n\n\n目录\n=================\n\n* [如何快速开发一个OpenAI\u002FGPT应用](#如何快速开发一个openaigpt应用)\n   * [ChatGPT && OpenAI 的关系](#chatgpt--openai-的关系)\n   * [OpenAI API 接口能做什么](#openai-api-接口能做什么)\n   * [chat completions 接口如何使用？](#chat-completions-接口如何使用)\n      * [Stream 参数](#stream-参数)\n      * [其他参数](#其他参数)\n   * [Chat completions 接口如何计费？](#chat-completions-接口如何计费)\n   * [chat completions 接口能做什么 ①](#chat-completions-接口能做什么-)\n   * [chat completions 接口能做什么 ②](#chat-completions-接口能做什么--1)\n   * [国内是否可以上线运营GPT相关业务？](#国内是否可以上线运营gpt相关业务)\n   * [如何解决国内用户无法注册OpenAI账号、无法访问OpenAI接口的问题？](#如何解决国内用户无法注册openai账号无法访问openai接口的问题)\n      * [注册OpenAI](#注册openai)\n      * [访问OpenAI API](#访问openai-api)\n      * [通过第三方接口访问](#通过第三方接口访问)\n   * [如何避免 OpenAI 封禁账号 API权限](#如何避免-openai-封禁账号-api权限)\n   * [如何知道 OpenAI 接口状态](#如何知道-openai-接口状态)\n\n\n## ChatGPT && OpenAI 的关系\n\nChatGPT 是 OpenAI 推出的应用，使用的是最新的模型；而 OpenAI 开放接口的模型是 gpt-3.5-turbo ，这个模型比 ChatGPT 应用要笨。但 ChatGPT 用的最新模型没有接口，只能通过无头浏览器等方式来使用（不稳定）。\n\n> 更新：目前已经开放了 gpt-4 ，当前尚未提供图片输入接口，使用方式和 gpt-3.5-turbo 一致，只需要将 model 参数更换为 gpt-4 ，注意 gpt-4 的 max tokens 为 8k （gpt-4-32k 为 32k），Token 价格是 3.5 的 15~30 倍。\n\n## OpenAI API 接口能做什么\n\n能做的事情很多，可以查看[官方文档](https:\u002F\u002Fplatform.openai.com\u002Fdocs)，但这个文档中国网络目前无法访问。\n\n![](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Feasychen_openai-gpt-dev-notes-for-cn-developer_readme_8a086b940aee.png)\n\n具体来讲，OpenAI 所有的可用的接口都在里边，包括语音识别和图片生成。但真正智能的其实只有 `gpt-3.5-turbo`，因此刚开始不用看其他内容。\n\n目前大家看到的绝大部分GPT类应用都是由 `gpt-3.5-turbo` 模型的 `chat completions` 对话补全接口实现的。\n\n![](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Feasychen_openai-gpt-dev-notes-for-cn-developer_readme_18c6121a67a9.png)\n\n## chat completions 接口如何使用？\n\n可以通过很多方式来使用，比如使用官方SDK，第三方项目，但其实只需要一个HTTP请求就可以。以下是官方文档给出的例子：\n\n```bash\ncurl https:\u002F\u002Fapi.openai.com\u002Fv1\u002Fchat\u002Fcompletions \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -H 'Authorization: Bearer YOUR_API_KEY' \\\n  -d '{\n  \"model\": \"gpt-3.5-turbo\",\n  \"messages\": [{\"role\": \"user\", \"content\": \"Hello!\"}]\n}'\n```\n\n从里边可以看到，需要的信息有：\n\n① 请求地址： `https:\u002F\u002Fapi.openai.com\u002Fv1\u002Fchat\u002Fcompletions` 这个地址目前在国内大部分地区已经无法访问了，后边会讲解决办法 \n\n② 最常用的接口参数包括：\n\n1. model: 必填，建议使用 `gpt-3.5-turbo`，便宜。计费后边会讲。\n1. messages: AI 进行提问的问题或信息。\n1. max_tokens: 选填，指定生成回答的最大Token数。\n1. stream: 选填，是否按流的方式发送内容。\n\n其中 messages的格式为：`{\"role\",\"content\"}`。一般用 `user` 发送用户问题；`system` 发送给模型提示信息。\n\n例如：\n```json\n[\n  {\"role\": \"system\", \"content\": \"You are a helpful assistant that translates English to French.\"},\n  {\"role\": \"user\", \"content\": \"Translate the following English text to French: {text}\"}\n]\n```\n知道了这些基本就可以跑通GPT流程了，其他role可以稍后优化时来做。\n\n### Stream 参数\n\n这里单独说一下 stream 参数，当它设置为 true 时，API 会以 SSE（ Server Side Event ）方式返回内容。\n\nSSE 本质上还是 HTTP 协议，只不过它是一个长链接，先输出一个 `header(\"Content-Type: text\u002Fevent-stream\")` ， 然后持续不断地输出内容直到完成。如果不是做实时聊天，建议直接false掉。\n\n需要注意的是，开启stream 后，将不会返回 usage 信息，这对精准计费有影响\n\n```\n{\"id\":\"chatcmpl-6s3hNohxOliHi8zR7m5UTrLm4cWWc\",\"object\":\"chat.completion.chunk\",\"created\":1678341949,\"model\":\"gpt-3.5-turbo-0301\",\"choices\":[{\"delta\":{\"content\":\"我\"},\"index\":0,\"finish_reason\":null}]}\n{\"id\":\"chatcmpl-6s3hNohxOliHi8zR7m5UTrLm4cWWc\",\"object\":\"chat.completion.chunk\",\"created\":1678341949,\"model\":\"gpt-3.5-turbo-0301\",\"choices\":[{\"delta\":{\"content\":\"没有\"},\"index\":0,\"finish_reason\":null}]}\n{\"id\":\"chatcmpl-6s3hNohxOliHi8zR7m5UTrLm4cWWc\",\"object\":\"chat.completion.chunk\",\"created\":1678341949,\"model\":\"gpt-3.5-turbo-0301\",\"choices\":[{\"delta\":{\"content\":\"当前\"},\"index\":0,\"finish_reason\":null}]}\n{\"id\":\"chatcmpl-6s3hNohxOliHi8zR7m5UTrLm4cWWc\",\"object\":\"chat.completion.chunk\",\"created\":1678341949,\"model\":\"gpt-3.5-turbo-0301\",\"choices\":[{\"delta\":{\"content\":\"日期\"},\"index\":0,\"finish_reason\":null}]}\n{\"id\":\"chatcmpl-6s3hNohxOliHi8zR7m5UTrLm4cWWc\",\"object\":\"chat.completion.chunk\",\"created\":1678341949,\"model\":\"gpt-3.5-turbo-0301\",\"choices\":[{\"delta\":{\"content\":\"的\"},\"index\":0,\"finish_reason\":null}]}\n{\"id\":\"chatcmpl-6s3hNohxOliHi8zR7m5UTrLm4cWWc\",\"object\":\"chat.completion.chunk\",\"created\":1678341949,\"model\":\"gpt-3.5-turbo-0301\",\"choices\":[{\"delta\":{\"content\":\"实\"},\"index\":0,\"finish_reason\":null}]}\n{\"id\":\"chatcmpl-6s3hNohxOliHi8zR7m5UTrLm4cWWc\",\"object\":\"chat.completion.chunk\",\"created\":1678341949,\"model\":\"gpt-3.5-turbo-0301\",\"choices\":[{\"delta\":{\"content\":\"时\"},\"index\":0,\"finish_reason\":null}]}\n{\"id\":\"chatcmpl-6s3hNohxOliHi8zR7m5UTrLm4cWWc\",\"object\":\"chat.completion.chunk\",\"created\":1678341949,\"model\":\"gpt-3.5-turbo-0301\",\"choices\":[{\"delta\":{\"content\":\"信息\"},\"index\":0,\"finish_reason\":null}]}\n```\n\n\n### 其他参数\n\n接口的其他参数可以看[官方文档](https:\u002F\u002Fplatform.openai.com\u002Fdocs\u002Fapi-reference\u002Fchat)，访问不了的同学可以看我做的截图。\n\n![](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Feasychen_openai-gpt-dev-notes-for-cn-developer_readme_d259b42d400c.png)\n![](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Feasychen_openai-gpt-dev-notes-for-cn-developer_readme_d3f528b81076.png)\n\n## Chat completions 接口如何计费？\n\n`chat completions` 接口按 token 计费，有一个专门的算法来计算 token。输入和输出全部都会计入到 token 里边，在 `chat completions` 接口的 `usage` 里边会有具体消耗的 token 数。\n\n如果你要自己计算，可以用这个[在线表单](https:\u002F\u002Ftiktokenizer.vercel.app)，程序计算可以看看这两个项目：\n\n1. https:\u002F\u002Fgithub.com\u002Fdqbd\u002Ftiktokenizer\n2. https:\u002F\u002Fgithub.com\u002Fopenai\u002Ftiktoken\n\n\n除了 `gpt-3.5-turbo` 模型的 `chat completions` 接口，还有 `text-davinci-003` 模型的 `text completions` 接口可以用，但是价格更贵，效果更差 🤣\n\n你可以在 \u003Chttps:\u002F\u002Fopenai.com\u002Fpricing> 查询到价格，以下是3月中旬的定价\n \n| Model | Usage |\n| --- | --- |\n| gpt-3.5-turbo (ChatGPT) | $0.002 \u002F 1K tokens |\n| Davinci (InstructGPT) | $0.0200 \u002F 1K tokens |\n| Ada (InstructGPT) | $0.0004 \u002F 1K tokens |\n| Babbage (InstructGPT) | $0.0005 \u002F 1K tokens |\n| Curie (InstructGPT) | $0.0020 \u002F 1K tokens |\n\n\n## chat completions 接口能做什么 ①\n\n虽然 `chat completions` 看起来像是一个聊天接口，但接口设计上并没有为聊天优化，因为这个接口是记不住上下文的。\n\n为了让对话具有连续性，我们每次请求需要带上上次的聊天记录。有多种方式解决这个问题，一个是直接在messages参数中加上聊天记录。其中，GPT返回的内容用 `assistant` role。\n\n```json\n[\n     {\"role\": \"system\", \"content\": \"You are a helpful assistant.\"},\n     {\"role\": \"user\", \"content\": \"Who won the world series in 2020?\"},\n     {\"role\": \"assistant\", \"content\": \"The Los Angeles Dodgers won the World Series in 2020.\"},\n     {\"role\": \"user\", \"content\": \"Where was it played?\"}\n ]\n```\n\n另一个方式是使用第三方库，比如`chatgpt-api`，它可以自动帮你发送聊天记录（通过指定对话的`parentMessageId`实现）：\n\n1. \u003Chttps:\u002F\u002Fgithub.com\u002Ftransitive-bullshit\u002Fchatgpt-api>\n\n![](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Feasychen_openai-gpt-dev-notes-for-cn-developer_readme_5108e596a15e.png)\n\n在加上对话记录后，`chat completions` 接口就可以制作一个看起来有智能的聊天应用了。\n\n\n\n> 如果你要在国内运营聊天机器人之类的话，请记得将内容通过文本内容审核接口进行审核，否则很可能导致被封。\n\n## chat completions 接口能做什么 ②\n\n其实除了对话，GPT有很强的内容总结归纳能力，另外由于它能理解内容结构，同时本身又是语言模型，因此对结构化翻译很擅长。\n\n比如，我经常用它翻译JSON和Markdown，大部分情况下效果很好。在自用体验很好的情况下，我们可以将其制作为应用。\n\n![](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Feasychen_openai-gpt-dev-notes-for-cn-developer_readme_a5555deb917e.png)\n\n应用开发非常简单，我只用一天时间开发了[AiBox](https:\u002F\u002Fai.ftqq.com\u002F)，按基本的web应用开发就可以，重点说几个细节：\n\n1. 提示词：直接把提示词以 system 的 role 提交就可以。\n1. Key问题：开发者的Key肯定是不够用的，因此一般会让使用者填写自己的Key。但是国内用户没有海外手机号，无法申请key;申请下来API直接访问也不通，解决方案有几种，后边专门讲\n1. Token计算和限制问题：如果使用者用自己的Key，为了提升体验，我们可以提供一个Token计算，让用户知道自己的会花多少钱。另外如果你没有用第三方那个库来分拆，那么一次请求的内容不要超过 max_tokens 的限制。这个值一般是 4096。\n\n## 国内是否可以上线运营GPT相关业务？\n\n就目前而言，我了解到的情况是大部分企业没有收到明确禁止运营GPT相关业务的通知，但在国内运营要做好内容安全，比如对接口返回的内容再过一层内容审核。否则如果在应用中出现违规内容被举报，就会被封禁。\n\n但这是一个随时可能变化的情况，我们准备了[一个issue](https:\u002F\u002Fgithub.com\u002Feasychen\u002Fopenai-api-proxy\u002Fissues\u002F11)供大家反馈。\n\n## 如何解决国内用户无法注册OpenAI账号、无法访问OpenAI接口的问题？\n\n两个思路，一个是绕道海外去注册，通过代理使用服务；另一个是直接使用第三方代理API服务。前者可以暂时解决当前的问题；后者更方便省心。\n\n### 注册OpenAI\n\n1. 准备一个海外的网络\n1. 准备一个海外手机号来接收验证短信，可以用[海外虚拟号码](https:\u002F\u002Fsms-activate.org\u002F?ref=4207095)\n\n注册完成后，进入[API页面](https:\u002F\u002Fopenai.com\u002Fapi\u002F) 创建Key，然后就可以使用了。\n\n这个方案目前可行，是因为OpenAI给每个新用户提供了18美金的免费额度。但是一旦不再提供，就会面临充值的问题。目前OpenAI不接受中国信用卡，因此还必须准备一个海外信用卡。也就是说，要长久稳定的使用，必须有海外信用卡。\n\n以前有财付通的海外虚拟信用卡，后来服务下线了。最近看了下，很多500RMB起，还只支持电商网站，感觉不太靠谱 🤣\n\n### 访问OpenAI API\n\n3月3日开始，国内大部分网络不再能直接访问 OpenAI 接口。\n\n![](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Feasychen_openai-gpt-dev-notes-for-cn-developer_readme_1bd45cf2d5ca.png)\n\n因此你需要架设代理来访问OpenAI 接口。你可以将整个服务器代理到海外网络，或者只是简单的通过 Cloudflare 或者 腾讯云函数来部署API代理。\n\n如果你准备使用腾讯云函数，[教程可以看这里](https:\u002F\u002Fgithub.com\u002Feasychen\u002Fopenai-api-proxy\u002Fblob\u002Fmaster\u002FFUNC.md)\n\n![](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Feasychen_openai-gpt-dev-notes-for-cn-developer_readme_1a02bb0e6f1c.png)\n\n需要注意的是，腾讯云API代理会将长连接内容一次性返回，因此流式体验不明显。当然，有同学说腾讯云的 ApiGateway 直接就能代理，但我测试了下没成功。\n\n### 通过第三方接口访问\n\n如果你搞不定海外手机号和信用卡，或者自己不想架设代理，那么可以考虑用像[API2D](https:\u002F\u002Fapi2d.com)这样的第三方代理API。\n\n主要的优点：\n\n1. 基本兼容原有接口，只需要改下 API endpoint 和 Key\n1. 接口国内直接可以访问，无需架设代理\n1. 支持微信和国内卡充值，提供最小0.5美金\u002F3.5人民币的测试档位，GitHub注册还有50点免费额度试用\n1. 添加 moderation 参数，可以返回内容审核结果，省事\n1. 推荐可以获得点数，这里是我的[推荐链接](https:\u002F\u002Fapi2d.com\u002Fr\u002F186008)\n\n缺点：\n\n1. ~~不支持 stream 参数~~，已经支持 stream\n1. 目前只支持 chat 和 embeddings 接口\n1. 价格比官方略高，大概1.5倍，当然这个包含了流量中转的成本\n\n> 利益相关：api2d这个产品是作者加拿大的朋友做的，而且作为早期用户一直在重度使用\n\n## 如何避免 OpenAI 封禁账号 API权限\n\n最近得到反馈，很多架设香港代理的账号收到了邮件被禁用了权限。经过群里大家的讨论，总结的经验如下：\n\n1. 不要使用 OpenAI 不服务地区的代理\n1. 虚拟海外手机号更可能导致账号被封\n1. 绑定信用卡可以大幅提升账号存活率\n\n## 如何知道 OpenAI 接口状态\n\nOpenAI官方提供了一个[状态页](https:\u002F\u002Fstatus.openai.com\u002F)，虽然小故障不怎么显示，但大面积宕机时能看到公告。\n\n![image](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Feasychen_openai-gpt-dev-notes-for-cn-developer_readme_0e2258e4ea30.png)\n\n\n\n\n\n\n\n\n","在写了一堆应用以后，我们打算[众筹一个GPT课程](https:\u002F\u002Fsubdeer.cn\u002Fproduct\u002F3)。之前我以为现在GPT应用已经是红海了，但实际测试下来发现，GPT应用其实可以是非标准品。独有的提示词、独有的知识库、独有的工作流都可以做出独一无二的GPT体验。\n\n在课程中我们将讲解如何设计、搭建和开发一个与众不同的商业GPT应用。\u003Chttps:\u002F\u002Fsubdeer.cn\u002Fproduct\u002F3>\n\n# 如何快速开发一个OpenAI\u002FGPT应用\n\n> 一个国内开发者的OpenAI\u002FGPT的笔记\n\n\n最近都在问，于是写个文档。本文希望用尽可能少的内容，讲清楚开发一个OpenAI\u002FGPT应用必然用到的知识，内容主要聚焦在免费应用开发，商业化方案可以看看这篇文章：[《十分钟，给你开发的免费GPT应用加上收费功能》](https:\u002F\u002Fa.ftqq.com\u002F2023\u002F04\u002F18\u002Fapi2d-developer-program\u002F)\n\n欢迎PR补充。\n\n### AI\u002FAutomation开发交流群\n\n1. 电报群 \u003Chttps:\u002F\u002Ft.me\u002F+s-5piM3koEphNDY1>\n1. 微信群 \n\n![](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Feasychen_openai-gpt-dev-notes-for-cn-developer_readme_bcd16035b82e.jpeg)\n\n\n目录\n=================\n\n* [如何快速开发一个OpenAI\u002FGPT应用](#如何快速开发一个openaigpt应用)\n   * [ChatGPT && OpenAI 的关系](#chatgpt--openai-的关系)\n   * [OpenAI API 接口能做什么](#openai-api-接口能做什么)\n   * [chat completions 接口如何使用？](#chat-completions-接口如何使用)\n      * [Stream 参数](#stream-参数)\n      * [其他参数](#其他参数)\n   * [Chat completions 接口如何计费？](#chat-completions-接口如何计费)\n   * [chat completions 接口能做什么 ①](#chat-completions-接口能做什么-)\n   * [chat completions 接口能做什么 ②](#chat-completions-接口能做什么--1)\n   * [国内是否可以上线运营GPT相关业务？](#国内是否可以上线运营gpt相关业务)\n   * [如何解决国内用户无法注册OpenAI账号、无法访问OpenAI接口的问题？](#如何解决国内用户无法注册openai账号无法访问openai接口的问题)\n      * [注册OpenAI](#注册openai)\n      * [访问OpenAI API](#访问openai-api)\n      * [通过第三方接口访问](#通过第三方接口访问)\n   * [如何避免 OpenAI 封禁账号 API权限](#如何避免-openai-封禁账号-api权限)\n   * [如何知道 OpenAI 接口状态](#如何知道-openai-接口状态)\n\n\n## ChatGPT && OpenAI 的关系\n\nChatGPT 是 OpenAI 推出的应用，使用的是最新的模型；而 OpenAI 开放接口的模型是 gpt-3.5-turbo ，这个模型比 ChatGPT 应用要笨。但 ChatGPT 用的最新模型没有接口，只能通过无头浏览器等方式来使用（不稳定）。\n\n> 更新：目前已经开放了 gpt-4 ，当前尚未提供图片输入接口，使用方式和 gpt-3.5-turbo 一致，只需要将 model 参数更换为 gpt-4 ，注意 gpt-4 的 max tokens 为 8k （gpt-4-32k 为 32k），Token 价格是 3.5 的 15~30 倍。\n\n## OpenAI API 接口能做什么\n\n能做的事情很多，可以查看[官方文档](https:\u002F\u002Fplatform.openai.com\u002Fdocs)，但这个文档中国网络目前无法访问。\n\n![](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Feasychen_openai-gpt-dev-notes-for-cn-developer_readme_8a086b940aee.png)\n\n具体来讲，OpenAI 所有的可用的接口都在里边，包括语音识别和图片生成。但真正智能的其实只有 `gpt-3.5-turbo`，因此刚开始不用看其他内容。\n\n目前大家看到的绝大部分GPT类应用都是由 `gpt-3.5-turbo` 模型的 `chat completions` 对话补全接口实现的。\n\n![](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Feasychen_openai-gpt-dev-notes-for-cn-developer_readme_18c6121a67a9.png)\n\n## chat completions 接口如何使用？\n\n可以通过很多方式来使用，比如使用官方SDK，第三方项目，但其实只需要一个HTTP请求就可以。以下是官方文档给出的例子：\n\n```bash\ncurl https:\u002F\u002Fapi.openai.com\u002Fv1\u002Fchat\u002Fcompletions \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -H 'Authorization: Bearer YOUR_API_KEY' \\\n  -d '{\n  \"model\": \"gpt-3.5-turbo\",\n  \"messages\": [{\"role\": \"user\", \"content\": \"Hello!\"}]\n}'\n```\n\n从里边可以看到，需要的信息有：\n\n① 请求地址： `https:\u002F\u002Fapi.openai.com\u002Fv1\u002Fchat\u002Fcompletions` 这个地址目前在国内大部分地区已经无法访问了，后边会讲解决办法 \n\n② 最常用的接口参数包括：\n\n1. model: 必填，建议使用 `gpt-3.5-turbo`，便宜。计费后边会讲。\n1. messages: AI 进行提问的问题或信息。\n1. max_tokens: 选填，指定生成回答的最大Token数。\n1. stream: 选填，是否按流的方式发送内容。\n\n其中 messages的格式为：`{\"role\",\"content\"}`。一般用 `user` 发送用户问题；`system` 发送给模型提示信息。\n\n例如：\n```json\n[\n  {\"role\": \"system\", \"content\": \"You are a helpful assistant that translates English to French.\"},\n  {\"role\": \"user\", \"content\": \"Translate the following English text to French: {text}\"}\n]\n```\n知道了这些基本就可以跑通GPT流程了，其他role可以稍后优化时来做。\n\n### Stream 参数\n\n这里单独说一下 stream 参数，当它设置为 true 时，API 会以 SSE（ Server Side Event ）方式返回内容。\n\nSSE 本质上还是 HTTP 协议，只不过它是一个长链接，先输出一个 `header(\"Content-Type: text\u002Fevent-stream\")` ， 然后持续不断地输出内容直到完成。如果不是做实时聊天，建议直接false掉。\n\n需要注意的是，开启stream 后，将不会返回 usage 信息，这对精准计费有影响\n\n```\n{\"id\":\"chatcmpl-6s3hNohxOliHi8zR7m5UTrLm4cWWc\",\"object\":\"chat.completion.chunk\",\"created\":1678341949,\"model\":\"gpt-3.5-turbo-0301\",\"choices\":[{\"delta\":{\"content\":\"我\"},\"index\":0,\"finish_reason\":null}]}\n{\"id\":\"chatcmpl-6s3hNohxOliHi8zR7m5UTrLm4cWWc\",\"object\":\"chat.completion.chunk\",\"created\":1678341949,\"model\":\"gpt-3.5-turbo-0301\",\"choices\":[{\"delta\":{\"content\":\"没有\"},\"index\":0,\"finish_reason\":null}]}\n{\"id\":\"chatcmpl-6s3hNohxOliHi8zR7m5UTrLm4cWWc\",\"object\":\"chat.completion.chunk\",\"created\":1678341949,\"model\":\"gpt-3.5-turbo-0301\",\"choices\":[{\"delta\":{\"content\":\"当前\"},\"index\":0,\"finish_reason\":null}]}\n{\"id\":\"chatcmpl-6s3hNohxOliHi8zR7m5UTrLm4cWWc\",\"object\":\"chat.completion.chunk\",\"created\":1678341949,\"model\":\"gpt-3.5-turbo-0301\",\"choices\":[{\"delta\":{\"content\":\"日期\"},\"index\":0,\"finish_reason\":null}]}\n{\"id\":\"chatcmpl-6s3hNohxOliHi8zR7m5UTrLm4cWWc\",\"object\":\"chat.completion.chunk\",\"created\":1678341949,\"model\":\"gpt-3.5-turbo-0301\",\"choices\":[{\"delta\":{\"content\":\"的\"},\"index\":0,\"finish_reason\":null}]}\n{\"id\":\"chatcmpl-6s3hNohxOliHi8zR7m5UTrLm4cWWc\",\"object\":\"chat.completion.chunk\",\"created\":1678341949,\"model\":\"gpt-3.5-turbo-0301\",\"choices\":[{\"delta\":{\"content\":\"实\"},\"index\":0,\"finish_reason\":null}]}\n{\"id\":\"chatcmpl-6s3hNohxOliHi8zR7m5UTrLm4cWWc\",\"object\":\"chat.completion.chunk\",\"created\":1678341949,\"model\":\"gpt-3.5-turbo-0301\",\"choices\":[{\"delta\":{\"content\":\"信息\"},\"index\":0,\"finish_reason\":null}]}\n```\n\n\n### 其他参数\n\n接口的其他参数可以看[官方文档](https:\u002F\u002Fplatform.openai.com\u002Fdocs\u002Fapi-reference\u002Fchat)，访问不了的同学可以看我做的截图。\n\n![](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Feasychen_openai-gpt-dev-notes-for-cn-developer_readme_d259b42d400c.png)\n![](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Feasychen_openai-gpt-dev-notes-for-cn-developer_readme_d3f528b81076.png)\n\n## Chat completions 接口如何计费？\n\n`chat completions` 接口按 token 计费，有一个专门的算法来计算 token。输入和输出全部都会计入到 token 里边，在 `chat completions` 接口的 `usage` 里边会有具体消耗的 token 数。\n\n如果你要自己计算，可以用这个[在线表单](https:\u002F\u002Ftiktokenizer.vercel.app)，程序计算可以看看这两个项目：\n\n1. https:\u002F\u002Fgithub.com\u002Fdqbd\u002Ftiktokenizer\n2. https:\u002F\u002Fgithub.com\u002Fopenai\u002Ftiktoken\n\n\n除了 `gpt-3.5-turbo` 模型的 `chat completions` 接口，还有 `text-davinci-003` 模型的 `text completions` 接口可以用，但是价格更贵，效果更差 🤣\n\n你可以在 \u003Chttps:\u002F\u002Fopenai.com\u002Fpricing> 查询到价格，以下是3月中旬的定价\n \n| Model | Usage |\n| --- | --- |\n| gpt-3.5-turbo (ChatGPT) | $0.002 \u002F 1K tokens |\n| Davinci (InstructGPT) | $0.0200 \u002F 1K tokens |\n| Ada (InstructGPT) | $0.0004 \u002F 1K tokens |\n| Babbage (InstructGPT) | $0.0005 \u002F 1K tokens |\n| Curie (InstructGPT) | $0.0020 \u002F 1K tokens |\n\n\n## chat completions 接口能做什么 ①\n\n虽然 `chat completions` 看起来像是一个聊天接口，但接口设计上并没有为聊天优化，因为这个接口是记不住上下文的。\n\n为了让对话具有连续性，我们每次请求需要带上上次的聊天记录。有多种方式解决这个问题，一个是直接在messages参数中加上聊天记录。其中，GPT返回的内容用 `assistant` role。\n\n```json\n[\n     {\"role\": \"system\", \"content\": \"You are a helpful assistant.\"},\n     {\"role\": \"user\", \"content\": \"Who won the world series in 2020?\"},\n     {\"role\": \"assistant\", \"content\": \"The Los Angeles Dodgers won the World Series in 2020.\"},\n     {\"role\": \"user\", \"content\": \"Where was it played?\"}\n ]\n```\n\n另一个方式是使用第三方库，比如`chatgpt-api`，它可以自动帮你发送聊天记录（通过指定对话的`parentMessageId`实现）：\n\n1. \u003Chttps:\u002F\u002Fgithub.com\u002Ftransitive-bullshit\u002Fchatgpt-api>\n\n![](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Feasychen_openai-gpt-dev-notes-for-cn-developer_readme_5108e596a15e.png)\n\n在加上对话记录后，`chat completions` 接口就可以制作一个看起来有智能的聊天应用了。\n\n\n\n> 如果你要在国内运营聊天机器人之类的话，请记得将内容通过文本内容审核接口进行审核，否则很可能导致被封。\n\n## chat completions 接口能做什么 ②\n\n其实除了对话，GPT有很强的内容总结归纳能力，另外由于它能理解内容结构，同时本身又是语言模型，因此对结构化翻译很擅长。\n\n比如，我经常用它翻译JSON和Markdown，大部分情况下效果很好。在自用体验很好的情况下，我们可以将其制作为应用。\n\n![](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Feasychen_openai-gpt-dev-notes-for-cn-developer_readme_a5555deb917e.png)\n\n应用开发非常简单，我只用一天时间开发了[AiBox](https:\u002F\u002Fai.ftqq.com\u002F)，按基本的web应用开发就可以，重点说几个细节：\n\n1. 提示词：直接把提示词以 system 的 role 提交就可以。\n1. Key问题：开发者的Key肯定是不够用的，因此一般会让使用者填写自己的Key。但是国内用户没有海外手机号，无法申请key;申请下来API直接访问也不通，解决方案有几种，后边专门讲\n1. Token计算和限制问题：如果使用者用自己的Key，为了提升体验，我们可以提供一个Token计算，让用户知道自己的会花多少钱。另外如果你没有用第三方那个库来分拆，那么一次请求的内容不要超过 max_tokens 的限制。这个值一般是 4096。\n\n## 国内是否可以上线运营GPT相关业务？\n\n就目前而言，我了解到的情况是大部分企业没有收到明确禁止运营GPT相关业务的通知，但在国内运营要做好内容安全，比如对接口返回的内容再过一层内容审核。否则如果在应用中出现违规内容被举报，就会被封禁。\n\n但这是一个随时可能变化的情况，我们准备了[一个issue](https:\u002F\u002Fgithub.com\u002Feasychen\u002Fopenai-api-proxy\u002Fissues\u002F11)供大家反馈。\n\n## 如何解决国内用户无法注册OpenAI账号、无法访问OpenAI接口的问题？\n\n两个思路，一个是绕道海外去注册，通过代理使用服务；另一个是直接使用第三方代理API服务。前者可以暂时解决当前的问题；后者更方便省心。\n\n### 注册OpenAI\n\n1. 准备一个海外的网络\n1. 准备一个海外手机号来接收验证短信，可以用[海外虚拟号码](https:\u002F\u002Fsms-activate.org\u002F?ref=4207095)\n\n注册完成后，进入[API页面](https:\u002F\u002Fopenai.com\u002Fapi\u002F) 创建Key，然后就可以使用了。\n\n这个方案目前可行，是因为OpenAI给每个新用户提供了18美金的免费额度。但是一旦不再提供，就会面临充值的问题。目前OpenAI不接受中国信用卡，因此还必须准备一个海外信用卡。也就是说，要长久稳定的使用，必须有海外信用卡。\n\n以前有财付通的海外虚拟信用卡，后来服务下线了。最近看了下，很多500RMB起，还只支持电商网站，感觉不太靠谱 🤣\n\n### 访问OpenAI API\n\n3月3日开始，国内大部分网络不再能直接访问 OpenAI 接口。\n\n![](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Feasychen_openai-gpt-dev-notes-for-cn-developer_readme_1bd45cf2d5ca.png)\n\n因此你需要架设代理来访问OpenAI 接口。你可以将整个服务器代理到海外网络，或者只是简单的通过 Cloudflare 或者 腾讯云函数来部署API代理。\n\n如果你准备使用腾讯云函数，[教程可以看这里](https:\u002F\u002Fgithub.com\u002Feasychen\u002Fopenai-api-proxy\u002Fblob\u002Fmaster\u002FFUNC.md)\n\n![](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Feasychen_openai-gpt-dev-notes-for-cn-developer_readme_1a02bb0e6f1c.png)\n\n需要注意的是，腾讯云API代理会将长连接内容一次性返回，因此流式体验不明显。当然，有同学说腾讯云的 ApiGateway 直接就能代理，但我测试了下没成功。\n\n### 通过第三方接口访问\n\n如果你搞不定海外手机号和信用卡，或者自己不想架设代理，那么可以考虑用像[API2D](https:\u002F\u002Fapi2d.com)这样的第三方代理API。\n\n主要的优点：\n\n1. 基本兼容原有接口，只需要改下 API endpoint 和 Key\n1. 接口国内直接可以访问，无需架设代理\n1. 支持微信和国内卡充值，提供最小0.5美金\u002F3.5人民币的测试档位，GitHub注册还有50点免费额度试用\n1. 添加 moderation 参数，可以返回内容审核结果，省事\n1. 推荐可以获得点数，这里是我的[推荐链接](https:\u002F\u002Fapi2d.com\u002Fr\u002F186008)\n\n缺点：\n\n1. ~~不支持 stream 参数~~，已经支持 stream\n1. 目前只支持 chat 和 embeddings 接口\n1. 价格比官方略高，大概1.5倍，当然这个包含了流量中转的成本\n\n> 利益相关：api2d这个产品是作者加拿大的朋友做的，而且作为早期用户一直在重度使用\n\n## 如何避免 OpenAI 封禁账号 API权限\n\n最近得到反馈，很多架设香港代理的账号收到了邮件被禁用了权限。经过群里大家的讨论，总结的经验如下：\n\n1. 不要使用 OpenAI 不服务地区的代理\n1. 虚拟海外手机号更可能导致账号被封\n1. 绑定信用卡可以大幅提升账号存活率\n\n## 如何知道 OpenAI 接口状态\n\nOpenAI官方提供了一个[状态页](https:\u002F\u002Fstatus.openai.com\u002F)，虽然小故障不怎么显示，但大面积宕机时能看到公告。\n\n![image](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Feasychen_openai-gpt-dev-notes-for-cn-developer_readme_0e2258e4ea30.png)","# OpenAI\u002FGPT 应用快速上手指南\n\n本指南旨在帮助中国开发者快速理解并开发基于 OpenAI API 的应用，重点解决网络访问、接口调用及计费核心问题。\n\n## 环境准备\n\n在开始开发前，请确保满足以下前置条件：\n\n*   **开发语言**：支持发送 HTTP 请求的任何语言（Python, Node.js, Go, Java 等）。\n*   **API Key**：\n    *   **方案 A（推荐国内用户）**：使用第三方代理服务（如 API2D），支持微信\u002F支付宝充值，无需海外手机号和信用卡，国内网络可直接访问。\n    *   **方案 B（原生官方）**：需具备海外网络环境、海外手机号注册账号及海外信用卡充值。\n*   **网络环境**：\n    *   若使用官方接口 (`api.openai.com`)，国内大部分地区无法直接访问，需配置代理服务器（如 Cloudflare Workers 或腾讯云函数部署的 Proxy）。\n    *   若使用第三方代理接口，通常无需额外代理配置。\n\n## 安装步骤\n\nOpenAI API 本质是 RESTful HTTP 接口，**无需安装特定软件**，只需通过代码发送 HTTP 请求即可。\n\n如果你倾向于使用官方 SDK，可通过以下命令安装（以 Python 和 Node.js 为例）：\n\n**Python:**\n```bash\npip install openai\n```\n\n**Node.js:**\n```bash\nnpm install openai\n```\n\n> **注意**：使用 SDK 时，若通过第三方代理或自建代理访问，需在初始化时修改 `base_url` (或 `api_base`) 参数。\n\n## 基本使用\n\n### 1. 核心接口说明\n目前最常用且性价比最高的模型是 `gpt-3.5-turbo`。核心接口地址为 `\u002Fv1\u002Fchat\u002Fcompletions`。\n\n### 2. 最简单的使用示例 (cURL)\n\n以下命令展示了如何发起一次最基本的对话请求。请将 `YOUR_API_KEY` 替换为你的实际密钥，若使用第三方代理，请同时替换请求 URL。\n\n```bash\ncurl https:\u002F\u002Fapi.openai.com\u002Fv1\u002Fchat\u002Fcompletions \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -H 'Authorization: Bearer YOUR_API_KEY' \\\n  -d '{\n  \"model\": \"gpt-3.5-turbo\",\n  \"messages\": [{\"role\": \"user\", \"content\": \"Hello!\"}]\n}'\n```\n\n### 3. 关键参数解析\n\n*   `model`: 必填。建议使用 `gpt-3.5-turbo`（便宜且智能）。若使用 GPT-4，则填 `gpt-4`。\n*   `messages`: 必填。对话内容数组，格式为 `{\"role\": \"...\", \"content\": \"...\"}`。\n    *   `system`: 设定人设或提示词（例如：“你是一个翻译助手”）。\n    *   `user`: 用户输入的问题。\n    *   `assistant`: 模型之前的回答（用于保持多轮对话上下文）。\n*   `max_tokens`: 选填。限制生成内容的最大长度。\n*   `stream`: 选填。设为 `true` 可开启流式输出（SSE），实现打字机效果；设为 `false` 则一次性返回结果。\n\n### 4. 多轮对话示例\n\n为了让 AI“记住”上下文，需要在每次请求时携带历史聊天记录：\n\n```json\n[\n     {\"role\": \"system\", \"content\": \"You are a helpful assistant.\"},\n     {\"role\": \"user\", \"content\": \"Who won the world series in 2020?\"},\n     {\"role\": \"assistant\", \"content\": \"The Los Angeles Dodgers won the World Series in 2020.\"},\n     {\"role\": \"user\", \"content\": \"Where was it played?\"}\n]\n```\n\n### 5. 计费与 Token\n\n*   **计费方式**：按 Token 数量计费（输入 + 输出）。\n*   **参考价格**：`gpt-3.5-turbo` 约为 $0.002 \u002F 1K tokens。\n*   **计算工具**：开发时可利用在线工具估算 Token 消耗，或在代码中读取返回结果中的 `usage` 字段。\n\n> **合规提示**：若在国内运营相关应用，务必对输入和输出内容进行安全审核，以避免违规风险。","一位国内独立开发者试图快速构建一款基于 GPT-3.5 的垂直领域智能客服 SaaS，却因网络环境和文档缺失而举步维艰。\n\n### 没有 openai-gpt-dev-notes-for-cn-developer 时\n- **网络访问受阻**：开发者无法直接访问 OpenAI 官方文档和 API 接口，反复尝试注册账号和调用服务均因 IP 限制失败，项目启动即卡壳。\n- **技术选型迷茫**：分不清 ChatGPT 网页版与 OpenAI API 的区别，误以为必须使用不稳定的“无头浏览器”方案，导致开发架构复杂且易崩。\n- **核心参数困惑**：对 `stream` 流式输出、`system` 角色设定等关键参数理解模糊，调试耗时极长，甚至因不懂计费规则导致预算失控。\n- **合规风险未知**：不清楚国内上线运营 GPT 业务的红线与规避封号的具体策略，担心投入开发后账号被封或业务违规。\n\n### 使用 openai-gpt-dev-notes-for-cn-developer 后\n- **打通连接路径**：直接参考笔记中提供的第三方接口代理方案和注册指南，几分钟内成功调通 API，解决了“最后一公里”的网络难题。\n- **明确技术路线**：清晰认知到只需通过简单的 HTTP 请求调用 `gpt-3.5-turbo` 模型即可实现核心功能，摒弃了复杂的爬虫方案，大幅降低开发门槛。\n- **精准掌控细节**：依据笔记中的代码示例和参数详解，快速实现了流式回复效果，并掌握了通过 `system` 提示词定制专属客服人设的技巧。\n- **规避运营风险**：根据文中关于国内合规运营及防封号策略的指导，设计了安全的业务架构，确保应用能稳定上线并长期运行。\n\nopenai-gpt-dev-notes-for-cn-developer 将原本需要数周摸索的跨境开发难题，浓缩为一份可立即执行的实战指南，让国内开发者能专注于业务逻辑而非基础设施搭建。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Feasychen_openai-gpt-dev-notes-for-cn-developer_626151fc.png","easychen","Easy","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Feasychen_a6013e69.png",null,"ft07.com","Chongqing, China","http:\u002F\u002Fftqq.com","https:\u002F\u002Fgithub.com\u002Feasychen",[81],{"name":82,"color":83,"percentage":84},"Shell","#89e051",100,1546,104,"2026-04-05T05:01:07",1,"","未说明",{"notes":92,"python":90,"dependencies":93},"该工具并非本地运行的 AI 模型，而是一份关于如何调用 OpenAI API 的开发笔记。运行环境仅需能发起 HTTP 请求的任何操作系统或设备。核心依赖为有效的 OpenAI API Key（或第三方代理如 API2D 的 Key）。由于国内网络限制，直接访问 OpenAI 接口可能需要配置代理服务器或使用支持国内访问的第三方中转服务。开发语言不限，示例中使用 curl 命令，也可使用任意支持 HTTP 请求的编程语言（如 Python, Node.js 等）。",[],[35,14],"2026-03-27T02:49:30.150509","2026-04-11T00:44:11.649011",[],[]]