← 返回首页

Developer Center

黑蜂AI情感 · 开发者中心

本页是 黑蜂AI情感 (BlackBee AI) 所有开发者资源的官方入口。无论你是构建聊天工具、婚恋 App、内容社区，还是希望 Claude Code / Codex 等智能体能调用高情商回复引擎——都从这里开始。

API 基础信息

Base URL：https://api.blackbeeai.love（生产环境）/ https://api-staging.blackbeeai.love（测试环境）

鉴权方式：所有接口需在请求头携带 Authorization: Bearer <your-api-key>。API Key 通过产品内「开发者中心 → 创建密钥」生成，密钥仅在创建时完整展示一次，请妥善保存。

请求格式：Content-Type: application/json; charset=utf-8，所有入参为 JSON。

响应格式：统一返回 JSON，结构为 { "code": 0, "data": {...}, "msg": "ok" }。业务错误码非 0，HTTP 状态码同步反映（如 401 / 429 / 500）。

频率限制：默认 60 req/min，按 API Key 维度计数。需更高额度请通过商务通道申请。

语言与编码：所有接口默认 UTF-8。接口支持中文输入与输出，AI 引擎训练数据以中文情感语料为主。

REST 接口

POST/api/v1/replyPROD

输入对方消息 + 场景上下文，生成高情商回复。支持标准版（30-45 秒深度推演）、极速版（约 3 秒）、完美版（深度推演 + 多策略对比）。

请求参数

{
  "mode": "perfect",          // "standard" | "fast" | "perfect"
  "message": "你不会是见色起意吧",
  "context": "暧昧期，她刚发过来",
  "scene": "ambiguous",       // 9 大场景: chat / ambiguous / dating / humor / conflict / social / work / breakup / proposal
  "reply_count": 3            // 返回几条候选，默认 1
}

返回示例

{
  "code": 0,
  "data": {
    "replies": [
      { "text": "承认，但带钩子：要不你帮我鉴定一下是不是？", "score": 0.92, "eq_analysis": "先接住再反抛..." }
    ],
    "request_id": "req_abc123",
    "mode": "perfect",
    "tokens_used": 1247
  }
}

POST/api/v1/analyzePROD

只做情感意图分析，不生成回复。适合需要在客户端展示情绪雷达图、决定下一步回复策略的场景。

请求参数

{
  "message": "你这人怎么这么没意思",
  "context": "约会被拒绝后对方消息"
}

返回示例

{
  "code": 0,
  "data": {
    "emotion": "frustrated",          // 主情绪
    "intensity": 0.72,                // 强度 0-1
    "underlying_need": "希望被重视",   // 潜在需求
    "relationship_stage": "ambiguous",
    "suggested_strategy": "先承认情绪再澄清事实"
  }
}

GET/api/v1/quotaPROD

查询当前 API Key 在三个模式下的剩余配额与有效期。

GET /api/v1/quota HTTP/1.1
Host: api.blackbeeai.love
Authorization: Bearer bba_live_xxxxx

返回示例

{
  "code": 0,
  "data": {
    "quota": { "standard": 1240, "fast": 8930, "perfect": 87 },
    "expire_at": "2026-12-31T23:59:59+08:00",
    "tier": "pro"
  }
}

OpenAPI 3.0 规范

完整 OpenAPI 3.0 规范文件可机器读取下载：

JSON 格式：/openapi.json
YAML 格式：/openapi.yaml（即将上线）

可直接导入 Postman / Insomnia / Swagger UI / Stoplight Elements 用于本地调试和文档生成。

SKILL 集成

SKILL 是黑蜂为 AI 智能体（Claude Code、Codex、OpenClaw、Hermes 等）提供的零代码集成层。SKILL 文件遵循 .agents/skills/ 目录规范，包含 SKILL.md（人读）和 manifest.json（机读）两个核心文件。

使用方式：

Claude Code：把黑蜂 SKILL 放入 ~/.claude/skills/blackbee-reply/，在 Agent 模式下指令调用 /blackbee-reply "她这么说怎么回"
Codex / Cursor：把 SKILL 放入 .codex/skills/ 或 .cursor/skills/，可与编码场景联动
OpenClaw / Hermes：支持参数化配置，可通过 YAML 文件指定调用模式与场景

当前状态：内测中 — 已开放申请，联系商务通道获取 SKILL 包。

MCP Server 接入

黑蜂已实现 Anthropic Model Context Protocol (MCP) Server，支持 Claude Desktop、Cursor 等 MCP 兼容客户端直接调用高情商回复能力。

配置示例（Claude Desktop claude_desktop_config.json）：

{
  "mcpServers": {
    "blackbee-reply": {
      "command": "npx",
      "args": ["-y", "@blackbee/mcp-server-reply"],
      "env": { "BLACKBEE_API_KEY": "bba_live_xxxxx" }
    }
  }
}

当前状态：内测中 — npm 包名 @blackbee/mcp-server-reply 已注册，正式版预计 2026 年 Q4 发布。

Webhooks 与异步回调

完美版（perfect 模式）耗时较长（30-90 秒），建议使用异步接口 + Webhook 回调而非轮询。

异步流程：

1) 客户端调用 POST /api/v1/reply/async，立即返回 task_id
2) 服务端生成完成后，POST 到你预先配置的 webhook_url，body 含 task_id 与完整 replies
3) 也可调用 GET /api/v1/task/{task_id} 主动查询状态

Webhook 签名机制：每个回调请求头携带 X-BlackBee-Signature: sha256=<hex>，hex 由 HMAC-SHA256(secret, body) 计算。请在服务端验证签名以避免被伪造。

API 计费与配额

API 按调用消耗的 token 计费，与产品内会员体系共享额度：

标准版：每千输入 token 1 单位配额，每千输出 token 3 单位配额
极速版：每千输入 token 0.5 单位，每千输出 token 1 单位
完美版：每千输入 token 2 单位，每千输出 token 6 单位（含多策略对比）

免费试用：注册即送每模式 100 单位配额。生产使用建议订阅 Pro 或 Ultra 套餐。

📌 商务合作：需要超过 10 万单位/月、企业定制 SLA、专属 API Key 或私有部署，请通过微信公众号「黑蜂AI社交」联系我们，注明公司、用途与预计调用量。

联系与支持

技术问题：产品内反馈入口或微信公众号「黑蜂AI社交」
商务合作：同上，注明「API 合作」
安全报告：微信公众号留言，我们会在 48 小时内回复

响应时间：工作日 10:00–20:00（GMT+8），一般 24 小时内回复。