302API 的开源开发者资料与接入示例（Apache-2.0）。 提供技术说明、Python / Node.js / cURL 示例、客户端配置和无框架依赖的前端组件。
| 内容 | 位置 |
|---|---|
| 快速开始、地址与协议选择 | docs/quick-start.md |
| 对外技术能力与边界 | docs/technical-overview.md |
| 常见接入问题 | docs/troubleshooting.md |
| Python：聊天、流式、Anthropic Messages | examples/python/ |
| Node.js：聊天、Responses | examples/node/ |
| cURL：模型列表、聊天 | examples/curl/ |
| DSH、Cherry Studio、Claude Code 配置 | clients/ |
| 代码复制、模型筛选、状态展示组件 | components/ |
| 不访问生产接口的组件演示 | demo/ |
| 本地账单验算器、公开价格快照与合成测试 | billing-calculator/ |
| 安全问题报告与贡献说明 | SECURITY.md、CONTRIBUTING.md |
这是第一阶段公开资料。没有公开生产后端、账户系统、支付回调、服务端计费结算实现、生产配置或用户数据。 验算器只公开客户端价格公式；前端组件为独立示例实现，不能把本仓库称为完整网站源码开源。
- 在 控制台 创建自己的 API Key。
- 查询该 Key 当前可用的模型 ID，并确认模型支持的协议。
- 选择一个下面的示例，配置环境变量后运行。
以下命令以 Bash 为例，Key 交互输入，不出现在命令历史中：
read -r -s -p '302API Key: ' API_302API_KEY; printf '\n'
export API_302API_KEY
export API_302API_BASE_URL='https://api.302api.com/v1'
# 先查看 Key 当前有权限访问的模型列表
bash examples/curl/models.sh
# 用上一步获得的真实 ID 替换占位符
export MODEL_ID='MODEL_ID_HERE'.env.example 只列出变量名称，脚本不自动加载该文件。不同 Shell 的交互输入语法不同，详见 快速开始。
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python examples/python/chat.py
python examples/python/stream.pyAnthropic 原生接口使用独立的模型变量与根地址：
export ANTHROPIC_BASE_URL='https://api.302api.com'
export ANTHROPIC_MODEL_ID='NATIVE_MODEL_ID_HERE'
python examples/python/anthropic_messages.py需要 Node.js 20 或以上。示例运行在服务端 / 本机 Node.js，不要将 Key 打包进公开网页。
npm install
node examples/node/chat.mjs
# 需先选择支持 Responses 的模型
node examples/node/responses.mjsbash examples/curl/chat.shcURL 示例需要较新的 cURL（支持 --fail-with-body）；聊天脚本还使用 Python 3 生成 JSON。
运行推理示例会产生相应调用费用。示例将 SDK 自动重试关闭，避免不清楚结果时反复调用；生产项目应自行设计超时、重试、去重与对账策略。
- DSH 最小 Profile 补丁：只增加 provider 和默认模型，不修改原有沙箱 / 审批权限。
- Cherry Studio：OpenAI 兼容地址与模型配置。
- Claude Code：Anthropic 原生入口、环境变量与模型选择。
客户端、模型和协议需要同时匹配。支持 OpenAI 兼容接口，不代表任意模型都支持 Responses、图片、工具调用或所有 OpenAI 产品功能。
python3 -m http.server 8080 --bind 127.0.0.1打开 http://127.0.0.1:8080/demo/。演示使用明确标注的虚构模型和未知状态，不携带 Key，不请求生产接口。复用方式见 组件文档。
- 接入示例不写死模型清单、价格、折扣或上下文上限。验算器另附有日期的公开价格快照，供离线演算，不代表实时或历史锁定价格。
- 本地账单验算器 为 Python 标准库纯函数，逐项展示文本、缓存、长上下文和分时公式；相关合成测试已执行，不产生调用费用。
- 核对真实历史账单需使用当时的价格、规则、完整用量及实际汇率；仅凭当前价格快照不能保证与历史扣费一致。
- 仓库内容已做凭据与私人信息扫描、语法检查、JSON / YAML 结构检查和相对文档链接检查。
- 本次未进行真实付费推理、第三方客户端、浏览器 / 移动设备或完整安全验收；示例和组件不能据此被视为所有环境都已验证。
- 公开资料不单独证明线上部署版本、上游来源或实时服务可用性；相应信息应结合公开规则、实际账单与真实观测核对。
本项目以 Apache License 2.0 开源：个人与企业均可免费使用、修改、商用和再分发，无需另行申请授权。
- 唯一要求：保留署名。 再分发本项目或其衍生作品时，须保留 NOTICE 中的项目名称“302API Developer Kit”与仓库地址
https://github.com/XinchengLabs/302api-developer-kit，并按 Apache-2.0 保留版权与许可声明、标明重要修改。 - 集成组件不需要把自有产品改成 302API 品牌，也不需要在界面上展示 302API 标志；把 NOTICE 随源码或发行包一起保留即可。
- Apache-2.0 不授予商标使用权：可以如实说明“基于 302API Developer Kit”，但不能暗示获得 302API 官方合作或背书。
API 调用费用、第三方 SDK 和客户端的许可另行适用。更多说明见 LICENSING.md。此前 MIT / PolyForm / 自定义许可版本已授予的权利不受影响。