Skip to content

YoungLee-coder/Captra

Repository files navigation

Captra

基于 AI 大模型的验证码识别 API 服务,支持 OpenAI 和 Anthropic 模型。

✨ 特性

  • 🤖 AI 驱动: 支持 OpenAI 和 Anthropic 模型
  • 🎨 现代 UI: 基于 Next.js 15 + shadcn/ui + Tailwind CSS
  • 🧪 在线测试: 内置测试页面,支持实时验证码识别
  • 🔒 后台管理: 安全的配置管理和状态监控
  • 📚 API 文档: 完整的使用文档和代码示例

🌐 一键部署

Vercel 部署

Deploy to Vercel

注意: 部署完成后需要在 Vercel 项目设置中手动添加环境变量。

Netlify 部署

Deploy to Netlify

部署后必须配置: 在 Netlify 环境变量设置中添加您的 API_URLAPI_KEY

🚀 本地开发

  1. 克隆项目

    git clone https://github.com/YoungLee-coder/Captra.git
    cd Captra
  2. 安装依赖

    pnpm install
  3. 配置环境变量

    cp env.example .env.local
  4. 启动服务

    pnpm dev

访问 http://localhost:3000 开始使用。

📖 API 使用

POST /api/recognize

{
  "image": "base64编码的图片数据"
}

响应

{
  "success": true,
  "result": "ABC123",
  "processingTime": 1200
}

🎯 功能页面

  • 首页: API 文档和使用指南
  • 在线测试: 上传验证码图片即时测试
  • 后台管理: 模型配置、状态监控和测试

⚙️ 环境变量配置

必需配置

变量名 说明 示例值
ADMIN_PASSWORD 后台管理密码 admin123
API_KEY 大模型 API 密钥 sk-xxx...sk-ant-xxx...

模型配置

变量名 说明 默认值 可选值
API_URL API 请求地址 https://api.openai.com/v1/chat/completions OpenAI 或其他兼容的 API 端点
MODEL_NAME 模型名称 gpt-4o-mini gpt-4o, gpt-4o-mini, claude-3-5-sonnet-20241022
REQUEST_FORMAT 请求格式 openai openai, anthropic

高级配置

变量名 说明 默认值 示例
ADDITIONAL_PARAMS 附加参数(可选) {"thinking": "disabled"}
NEXTAUTH_SECRET 会话密钥 default-secret 随机生成的安全字符串
NEXTAUTH_URL 应用地址 http://localhost:3000 生产环境的完整域名

配置说明

附加参数 (ADDITIONAL_PARAMS)

  • 作用: 为模型 API 请求添加任意自定义参数
  • 格式: JSON 字符串格式
  • 使用: 设置后会将参数合并到 API 请求中
  • 支持参数: thinkingtemperaturetop_pmax_tokens 等任何模型支持的参数
  • 示例:
    # 思考模式控制
    ADDITIONAL_PARAMS={"thinking": "disabled"}
    
    # 多个参数组合
    ADDITIONAL_PARAMS={"thinking": "disabled", "temperature": 0.5}
    
    # 覆盖默认参数
    ADDITIONAL_PARAMS={"temperature": 0.8, "max_tokens": 150}
    
    # 不设置则不添加任何附加参数(默认行为)
    ADDITIONAL_PARAMS=

模型格式配置

根据您使用的模型提供商选择对应的配置:

OpenAI 配置:

API_URL=https://api.openai.com/v1/chat/completions
API_KEY=sk-your-openai-key
MODEL_NAME=gpt-4o-mini
REQUEST_FORMAT=openai

Anthropic 配置:

API_URL=https://api.anthropic.com/v1/messages
API_KEY=sk-ant-your-anthropic-key
MODEL_NAME=claude-3-5-sonnet-20241022
REQUEST_FORMAT=anthropic

完整配置示例

# 后台管理
ADMIN_PASSWORD=your-secure-password-123

# 大模型API配置
API_URL=https://api.openai.com/v1/chat/completions
API_KEY=sk-your-api-key-here
MODEL_NAME=gpt-4o-mini
REQUEST_FORMAT=openai

# 附加参数配置(可选)
ADDITIONAL_PARAMS={"thinking": "disabled"}

# NextAuth配置
NEXTAUTH_SECRET=your-super-secure-nextauth-secret-key
NEXTAUTH_URL=http://localhost:3000

📄 许可证

MIT License


Captra - 让验证码识别变得简单高效 🚀

About

基于LLM的验证码识别API服务

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published