API · 公开端点

公开 API 文档

最后更新: 2026 年 6 月 8 日

Luxe Copilot 的核心决策能力均为公开端点, 任何人可以直接发起请求, 无需 API key (受速率限制). 以下端点是 reviewer / B2B 集成方 / 第三方研究者最常用的 9 个; 完整 OpenAPI schema 见live OpenAPI UI(Swagger). 服务部署在 Render free 层, 首次请求可能有 30-60s 冷启动.

Base URL

https://luxe-copilot-api.onrender.com

速率限制

60 req/min/IP

认证

公开端点无需 (admin/* 除外)

端点列表

POST/verdict

对挂牌价给出 deal / fair / overpriced 判定 (P10/P50/P90 锚定, 包类用 resale 中位).

curl -X POST https://luxe-copilot-api.onrender.com/verdict \
  -H "Content-Type: application/json" \
  -d '{"product_id": 1, "asking_price_usd": 9800, "currency": "USD"}'

GET/resale-score/{product_id}

返回某 SKU 的二级市场表现: 中位、P10/P90、保值率、流动性 score (n ≥ 30 才出 high_confidence).

curl https://luxe-copilot-api.onrender.com/resale-score/1

POST/future-value

3 年残值预测 + 残值率 + 推荐持有 / 出手. 基于品牌 / 款式 / 流动性三因子模型.

curl -X POST https://luxe-copilot-api.onrender.com/future-value \
  -H "Content-Type: application/json" \
  -d '{"product_id": 1, "purchase_price_usd": 12000, "condition": "excellent"}'

POST/match

SKU-free 同款匹配 v3: char-trigram + Cohere multilingual embedding 加权, 跨语言对齐.

curl -X POST https://luxe-copilot-api.onrender.com/match \
  -H "Content-Type: application/json" \
  -d '{"text": "黑色 Togo Birkin 25"}'

POST/lens

图片 → SKU 归一 → verdict + future_value 串联. vision: gpt-4.1, fallback: Haiku 4.5.

curl -X POST https://luxe-copilot-api.onrender.com/lens \
  -H "Content-Type: application/json" \
  -d '{"image_url": "https://example.com/bag.jpg", "asking_price_usd": 8500}'

GET/wardrobe/{user_id}

用户衣橱估值汇总: 总投入、当前估值、3 年残值、ROI、出手建议 (per-item + summary).

curl https://luxe-copilot-api.onrender.com/wardrobe/1

GET/products?limit=80

产品目录 (212 SKU, 32 品牌). 字段含 msrp_usd / category / iconic / style_code.

curl "https://luxe-copilot-api.onrender.com/products?limit=10"

GET/export/skus.csv

全量 SKU 导出 CSV (LOI 附件 / 第三方接入用). brand,name,category,msrp_usd,style_code,iconic.

curl https://luxe-copilot-api.onrender.com/export/skus.csv -o skus.csv

GET/health

Liveness probe. 返回 {status: 'ok', db: <bool>}.

curl https://luxe-copilot-api.onrender.com/health

Provenance 字段定义

所有数值字段返回时附带 provenance 标签, 指明数据来源. UI 上对应一颗带颜色的 dot:

manual · 人工核对 (品牌门店报价 + 联盟 feed 双确认).
real · 真实样本 (二手平台公开页直接观测, 含日期).
llm_synth · AI 合成估算 (训练数据 + 同类 SKU 插值, 标日期, 不用于 verdict 锚定).
null · 暂无数据 (前端会显式标注, 不输出 fake number).

误差范围

二手中位置信区间: ±10% (样本 ≥ 30 件)
残值 3 年预测: ±15% (基于品牌 / 款式 / 流动性三因子模型)
样本 n < 30 时, response 会带 "low_confidence": true

联盟链接 (FTC §255)

本 API 不直接处理联盟跳转, 但 verdict / future-value response 中可能含retailer_url 字段. 当用户从前端点击该链接成单时, 我们会通过 Awin / CJ / Rakuten / Impact 获得佣金, 这不影响零售商定价, 也不影响 verdict 评分模型 (对所有零售商一视同仁). 详见/terms 第 4 条.

联系

API 接入 / B2B 集成: hello@luxecopilot.com. Bug / schema 问题: 直接发邮件附 curl 重现步骤.

本页与 live OpenAPI UI 同源生成 · 方法论 / 数据来源边界见 /methodology.