D DS2API
图形化文档
图形化导览

从部署到调用，一屏看清 DS2API

这页保留常用路径、请求链路和外部存储入口。需要长期保存响应记录时，请优先查看外部存储说明。

推荐阅读顺序

  • 先看部署指南，确认 Docker、Vercel 或源码运行方式。
  • 再看外部存储说明，决定使用内置 JSON 还是外部数据库。
  • 最后按接口文档接入 OpenAI、Claude 或 Gemini 客户端。

请求链路

DS2API 将不同协议的请求归一化，再复用同一套账号池、会话和流式处理逻辑。

1. 客户端OpenAI / Claude / Gemini SDK 发起兼容请求。
2. 协议适配协议层转换为统一请求模型， 保留工具调用和历史上下文。
3. 运行时账号池、PoW、上传文件和流式解析统一处理。
4. 兼容响应按目标协议渲染返回，包含用量、状态和工具调用结果。

部署入口

Docker、Vercel、Zeabur 和源码运行路径集中在部署指南。

管理面板

上线后进入 /admin 管理账号、API Key、代理、设置和响应记录。

兼容接口

/v1/chat/completions、/v1/responses、/anthropic 和 Gemini 路径共存。

外部存储怎么选

DS2API 默认用内置 JSON 文件保存 Chat history。需要跨冷启动、跨容器或多实例共享响应记录时，可以切换到外部 SQL 数据库。

  • 支持 PostgreSQL、MySQL 和 MariaDB。
  • 至少设置 DS2API_DATABASE_MODE=external、DS2API_DATABASE_TYPE 和 DS2API_DATABASE_DSN。
  • 外部存储只保存 Chat history，不保存账号、API Key、代理、Admin 密码或运行时设置。

常用连接串示例

  • PostgreSQL：postgres://user:pass@host:5432/ds2api?sslmode=disable
  • MySQL / MariaDB：user:pass@tcp(host:3306)/ds2api?parseTime=true
  • 多套实例共用同一数据库时，用 DS2API_DATABASE_TABLE_PREFIX 隔离表名。

常用 GitHub 文档

部署指南Docker、Vercel、Zeabur、源码运行与常见问题。 外部存储说明PostgreSQL、MySQL、MariaDB、自动建表和环境变量示例。 接口文档鉴权、模型、Chat、Responses、Claude、Gemini 与 Admin API。 架构说明模块边界、协议适配、运行时和 WebUI 的关系。 配置示例API Keys、账号池、模型别名、并发和自动删除配置。

快速检查

  • 打开 /v1/models 确认 API 服务可访问。
  • 打开 /admin 登录管理台并导入配置。
  • 按 GitHub 文档设置客户端 base URL 和 API Key。
  • 遇到部署问题时优先查看 GitHub Issues 和部署指南。