这是一个企业级的、高性能的百度文心一言网页版API代理服务。它不仅将API封装成与OpenAI格式兼容的标准接口，还通过Nginx粘性会话、令牌认证等高级功能，提供了极致的稳定性和安全性。

本项目是 Qwen-2api 的姊妹项目，继承了其稳定、高效、易于部署的核心设计哲学，并针对文心一言独特的认证机制进行了深度定制。

• 🚀 企业级架构: 采用 Nginx + FastAPI 的生产级架构，Nginx负责负载均衡与会话保持，FastAPI负责核心AI逻辑，性能卓越。
• 🎯 终极粘性会话: 利用 Nginx 对 Authorization 头进行哈希，100%确保同一用户的连续请求命中同一后台实例，从根本上解决流式对话的潜在问题。
• 🛡️ 高稳定性: 基于个人长期有效的认证信息，服务稳定可靠。
• 🔒 令牌认证: 内置 API_MASTER_KEY 认证，保护您的API服务不被滥用。
• 🐳 一键部署: 提供标准的 Docker Compose 配置，无论是本地还是服务器，都能轻松启动。
• 💡 智能流解析: 自动将文心一言的SSE事件流实时转换为标准的OpenAI增量流格式，完美兼容各类客户端。

作为姊妹项目，Ernie-2api 沿用了 Qwen-2api 的黄金标准架构。然而，由于逆向目标的不同，它们在核心技术挑战和实现上各有侧重。

总结: Qwen-2api 的技术难点在于**“如何处理数据”，而 Ernie-2api 的技术难点在于“如何通过验证”**。本项目针对文心一言独特的认证机制，在 baidu_provider.py 中构建了专门的请求签名和头信息生成逻辑。

您可以根据需求选择最适合您的部署方式：

• 方案一：本地部署 - (推荐) 在您自己的电脑或服务器上快速运行，享受完整功能。
• 方案二：Hugging Face 云端部署 - (实验性) 免费将服务部署到云端，获得一个可公开访问的API网址。

通过 Docker，只需几步即可在您的电脑上拥有一个私有的、高性能的文心一言API服务。

• 已安装 Docker 和 Docker Compose。
• 已安装 Git。

打开您的命令行（终端），克隆本项目到您的电脑上。

git clone https://github.com/lzA6/Ernie-2api.git
cd Ernie-2api

本项目通过模拟网页版请求实现，因此需要您提供三项核心认证信息。

1. 使用您的浏览器登录 文心一言官网。

2. 按 F12 打开开发者工具，并切换到 网络 (Network) 面板。

3. 随便发送一条消息，在网络请求列表中找到一个名为 conversation/v2 的请求。

4. 点击该请求，在右侧面板中仔细查找并完整复制以下三项信息：

   • Cookie:
     • 在 标头 (Headers) -> 请求标头 (Request Headers) 中找到 cookie 字段。它的值非常长。
   • acs-token:
     • 同样在 请求标头 (Request Headers) 中找到 acs-token 字段。
   • sign:
     • 切换到 有效负载 (Payload) 选项卡，在 请求负载 (Request Payload) 中找到 sign 字段。

⚠️ 重要提示: acs-token 和 sign 可能具有时效性。如果服务在一段时间后开始报错，您可能需要重复此步骤来获取新的凭证。

1. 在 Ernie-2api 文件夹中，找到名为 .env.example 的文件。
2. 将它复制并重命名为 .env。
3. 用文本编辑器打开这个新的 .env 文件，将您在第 2 步中获取到的三项信息，以及您自定义的API密钥，填写到对应的位置。

# .env (配置示例)
LISTEN_PORT=8083
API_MASTER_KEY=your_super_secret_master_key_123
BAIDU_ACCOUNT_1_COOKIE="在这里粘贴你的完整Cookie"
BAIDU_ACCOUNT_1_ACS_TOKEN="在这里粘贴你的acs-token"
BAIDU_ACCOUNT_1_SIGN="在这里粘贴你的sign值"

由于本项目采用多容器架构，需要创建一个共享网络让它们互相通信。

docker network create shared_network

回到您的命令行（确保仍在 Ernie-2api 文件夹内），运行以下命令：

docker compose up -d --build```
Docker 将会自动构建镜像并在后台启动Nginx和Python服务。

### 第 6 步：测试您的本地API

```bash
curl http://localhost:8083/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your_super_secret_master_key_123" \
  -d '{
    "model": "ernie-4.5-turbo",
    "messages": [{"role": "user", "content": "你好，请用中文介绍一下你自己！"}]
  }'

注意： 请将 your_super_secret_master_key_123 替换为您在 .env 文件中设置的 API_MASTER_KEY。

如果成功返回了文心一言的回答，恭喜您，本地部署成功！

⚠️ 架构限制: Hugging Face Spaces 的免费实例目前不支持 Docker Compose 多容器部署。因此，部署到HF时，我们将绕过Nginx，直接暴露FastAPI服务。这意味着您将失去Nginx带来的粘性会话和性能优势，但这对于轻量级使用或公开演示仍然是一个很好的选择。

1. 访问 Hugging Face New Space 页面。
2. Space name: 给它起一个全局唯一的名字，例如 my-ernie-api。
3. Space SDK: 务必选择 Docker，模板选择 Blank。
4. Public/Private: 选择 Public 以享受免费资源。
5. 点击 Create Space。

这是云端部署最核心的一步。我们需要把本地 .env 文件里的所有配置，安全地设置到Hugging Face的后台。

1. 在您刚刚创建的Space页面，点击 Settings 选项卡。
2. 在左侧菜单中，点击 Secrets。
3. 点击 New secret，然后逐一添加您在本地 .env 文件中配置的所有变量。

您需要添加以下所有Secrets：

1. 修改 README.md 以适配Hugging Face 用文本编辑器打开您本地 Ernie-2api 文件夹中的 README.md 文件（也就是本文档），在最顶部加入以下内容：

   ---
   title: Ernie 2API
   emoji: 🤖
   colorFrom: blue
   colorTo: green
   sdk: docker
   app_port: 8083
   ---

   （sdk: docker 和 app_port: 8083 这两行是告诉Hugging Face如何运行您的项目的关键！）

2. 推送代码到Hugging Face 回到您的命令行（确保在 Ernie-2api 文件夹内），执行以下命令：

   # 设置您的Git身份 (如果是第一次使用)
   git config --global user.name "你的GitHub或HF用户名"
   git config --global user.email "你的邮箱"
   
   # 关联并推送代码
   git init
   git remote add huggingface https://huggingface.co/spaces/[你的HF用户名]/[你的Space名]
   git add .
   git commit -m "Deploy to Hugging Face"
   git push --force huggingface main

   （推送时，用户名为您的HF用户名，密码为您在HF Access Tokens页面创建的write权限的Token。）

推送成功后，Hugging Face会自动部署您的服务。等待Space状态变为 Running 后，您就可以使用它的公开网址进行测试了！

# 将URL替换成您的Space地址
curl https://[你的HF用户名]-[你的Space名].hf.space/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your_super_secret_master_key_123" \
  -d '{
    "model": "ernie-4.5-turbo",
    "messages": [{"role": "user", "content": "你好，你现在部署在Hugging Face上了吗？"}]
  }'

本项目采用 Apache License 2.0 开源。