微信里的陪伴
自然一点，也更懂你欢迎来到
雨落的网上小屋

开发者在自己的后台创建独立用户。这些用户不会进入雨落网站用户表。

POST /auth/login
{"username":"demo","password":"********"}

未开启 TOTP 时直接返回 accessToken。开启 TOTP 时先返回 challengeId，再调用：

POST /auth/2fa/verify
{"challengeId":"…","code":"123456"}

POST /auth/introspect
{"accessToken":"…"}

POST /auth/logout
{"accessToken":"…"}

注销、独立用户封禁、开发者权限被撤销或网站账号被封禁后，已发放的会话立即失效。

聊天请求必须带唯一的 X-Request-Id（16–200 字符），并传入你的应用人设。

POST /ai/chat
X-Request-Id: 550e8400-e29b-41d4-a716-446655440000

{
  "userAccessToken":"…",
  "model":"可选；留空使用当前主模型",
  "persona":"你的应用本轮人设说明",
  "messages":[{"role":"user","content":"你好"}],
  "temperature":0.8,
  "maxTokens":800
}

只允许 user 和 assistant 消息角色。Token 计入开发者的网站账单。

生图使用管理员当前全局启用的唯一线路。开发者不能提交自定义 URL 或模型密钥。

POST /ai/images
X-Request-Id: 550e8400-e29b-41d4-a716-446655440001

{
  "userAccessToken":"…",
  "model":"可选；必须与当前启用模型一致",
  "prompt":"一张粉蓝色的二次元插画",
  "size":"1024x1024",
  "quality":"medium"
}

size 支持 1024x1024、1024x1536、1536x1024、2048x1152 和 1152x2048；quality 支持 low、medium 和 high。每次仅生成 1 张，返回 data[0].b64_json 及 mime_type，并按管理员设定的每张价格计费。

• /ai/chat 和 /ai/images 的 X-Request-Id 不可重复；重放请求会被拒绝。
• 调用前会校验 API Key、独立用户会话、开发者审批状态、封禁状态和网站余额。
• 审计记录保存来源 IP、接口、模型、状态码和用量，不保存聊天正文、人设或生图提示词。
• 常见状态：400 参数错误，401 API Key 无效，403 权限、会话或余额不可用，502 上游模型请求失败。