Cire — Cosmetic Ingredient Risk Engine

CIRE API — 化妆品成分风险引擎

面向 AI Agent 的确定性 INCI 安全评分 API。
专为购物 Agent、目录筛选、合规工作流和 K-beauty 推荐引擎设计。

---

什么是 CIRE？

CIRE 会对化妆品成分列表（INCI 格式）进行评分，评估 5 个类别的安全风险：

类别	描述
irritation_risk	皮肤刺激可能性
allergen_risk	已知过敏原
pregnancy_risk	孕期不安全的成分
acne_risk	致粉刺成分
interaction_risk	危险的成分组合

完全确定性，基于规则，无机器学习，始终返回有效的 JSON。

---

快速开始

curl -X POST https://web-production-9cdb4.up.railway.app/v1/analyze \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inci": "Water, Retinol, Glycolic Acid"}'

响应：

{
  "risk_score": 52,
  "risk_level": "moderate",
  "confidence_score": 65,
  "category_results": { ... },
  "matches": { ... }
}

• risk_score：0–100（分数越高 = 越安全）
• risk_level：low / moderate / high
• confidence_score：证据强度（0–100）

---

身份验证

在 X-API-Key 请求头中传入 API 密钥。

X-API-Key: cire-xxxxxxxxxxxx

获取 API 密钥 → cire.ai

---

定价

方案	调用次数	价格
Starter	1,000	$9
Growth	10,000	$49
Scale	100,000	$299

级别行为

• 免费级别 API 密钥：可调用 /v1/analyze、/v1/credits 和账单/账户端点
• Pro 级别 API 密钥：包含免费端点，以及 /v1/synergy 和 /v1/optimal
• 使用免费密钥调用 Pro 端点时会返回：
  • 403 Forbidden
  • 明确的消息：Pro tier required for this endpoint...

---

API 参考

完整交互式文档：/docs

开发者入口：

• 开发者快速入门

使用场景文章：

• AI 购物 Agent 安全 API
• K-Beauty 合规 INCI API
• CIRE Pro：Synergy + Optimal

POST /v1/analyze

分析 INCI 字符串。消耗 1 个额度。

POST /v1/batch

每个请求最多批量分析 100 个 INCI 字符串。每项消耗 1 个额度。

请求：

{ "inci_list": ["Water, Glycerin", "Water, Retinol, Glycolic Acid"] }

POST /v1/synergy (Pro 级别)

对有益和有风险的组合进行确定性配对评分。

请求：

{ "inci": "Water, Adapalene, Benzoyl Peroxide" }

响应包含：

• synergy_score
• conflict_score
• evidence_level
• evidence_refs

POST /v1/optimal (Pro 级别)

基于目标的确定性推荐端点。

请求：

{ "inci": "Water, Niacinamide", "goal": "acne" }

响应包含：

• recommended_additions
• avoid_with_current
• evidence_level
• evidence_refs

GET /v1/credits

查看剩余额度和密钥级别。

账单自动化（Paddle）

• /v1/webhook 处理 transaction.completed 事件。
• 存在 custom_data.credits 时，会自动添加额度。
• 当 custom_data.tier 为 pro/enterprise 时，会自动升级 API 密钥级别。
• 支持的 Pro 订阅结账套餐 ID：pro_monthly、pro_yearly（需要在 env 中设置 Paddle 价格 ID）。

---

使用场景

• 购物 Agent — 根据孕期安全性、过敏原风险筛选产品
• 目录管理人员 — 批量扫描数千个 SKU
• 合规工作流 — 检查欧盟/K-beauty 出口法规
• 推荐引擎 — 根据安全特征为产品排序

---

技术

• 纯 Python，无机器学习依赖
• 确定性输出 — 相同输入始终返回相同输出
• 基于证据：欧盟限制清单、FDA 安全警示、CIR 报告和同行评审共识
• 13/13 项冒烟测试通过

Pro 数据增强（幂等）

为 Pro 配方表补充数据且不重复添加行：

cd cire-api
python scripts/enrich_pro_seed.py

此脚本会追加缺失的记录：

• evidence_refs
• ingredient_pairs
• formulation_goals

---

为 AI Agent 生态系统打造。CIRE 认证。