droid2api

OpenAI 兼容的 API 代理服务器，统一访问不同的 LLM 模型。

功能特性

• 🎯 标准 OpenAI API 接口 - 使用熟悉的 OpenAI API 格式访问所有模型
• 🔄 自动格式转换 - 自动处理不同 LLM 提供商的格式差异
• 🌊 流式响应支持 - 支持实时流式输出
• 🔐 自动认证管理 - 自动刷新和管理 API 访问令牌
• ⚙️ 灵活配置 - 通过配置文件自定义模型和端点

安装

npm install

快速开始

1. 配置认证

设置环境变量或配置文件：

# 方式1：环境变量
export DROID_REFRESH_KEY="your_refresh_token_here"

# 方式2：配置文件 ~/.factory/auth.json
{
  "access_token": "your_access_token",
  "refresh_token": "your_refresh_token"
}

2. 配置模型（可选）

编辑 config.json 添加或修改模型：

{
  "port": 3000,
  "models": [
    {
      "name": "Claude Opus 4",
      "id": "claude-opus-4-1-20250805",
      "type": "anthropic"
    },
    {
      "name": "GPT-5",
      "id": "gpt-5-2025-08-07",
      "type": "openai"
    }
  ]
}

使用方法

启动服务器

npm start

或使用快捷脚本：

./start.sh

服务器默认运行在 http://localhost:3000。

API 使用

获取模型列表

curl http://localhost:3000/v1/models

对话补全

使用标准 OpenAI 格式调用任何模型：

curl http://localhost:3000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-1-20250805",
    "messages": [
      {"role": "user", "content": "你好"}
    ],
    "stream": true
  }'

支持的参数：

• model - 模型 ID（必需）
• messages - 对话消息数组（必需）
• stream - 是否流式输出（默认 true）
• max_tokens - 最大输出长度
• temperature - 温度参数（0-1）

常见问题

如何更改端口？

编辑 config.json 中的 port 字段：

{
  "port": 8080
}

如何启用调试日志？

在 config.json 中设置：

{
  "dev_mode": true
}

故障排查

认证失败

确保已正确配置 refresh token：

• 设置环境变量 DROID_REFRESH_KEY
• 或创建 ~/.factory/auth.json 文件

模型不可用

检查 config.json 中的模型配置，确保模型 ID 和类型正确。

许可证

MIT