# 源奥搅拌 · 选型核算 API

> 搅拌器选型核算接口。认证：`X-Api-Key`（源奥发放）+ `X-Client-Id`（调用方标识）。
> 先 `GET /api/options` 取合法取值；`/api/pick` 输入**嵌套**（放 `input` 里），`/api/calc` 输入**平铺**。

## Docs

- [接入说明（Markdown —— agent 读这个）](https://yuanaoapi.chilintu.com/docs.md)
- [OpenAPI 3.0 规格](https://yuanaoapi.chilintu.com/openapi.json)
- [人读页面](https://yuanaoapi.chilintu.com/docs)

## Endpoints

- `GET  https://yuanaoapi.chilintu.com/api/options` — 取可选清单（材质/桨型/机架/减速机/管规格）
- `POST https://yuanaoapi.chilintu.com/api/pick` — 初步方案推荐（输入嵌套：`{"input": {...}, "output_speed_rpm": 63}`）
- `POST https://yuanaoapi.chilintu.com/api/calc` — 核算（输入平铺）

## 错误码

`401` 令牌无效 · `403` 设备绑定不符 · `400` 参数错误（响应带可读原因） · `429` 超频或额度用尽 · `500` 内部错误（已留痕）

## 各角色可见范围

核心 > 销售 > 经销商。推荐页可推档位：核心全给、销售 合格+良+优秀、经销商 仅 良+优秀。
机械校核原始量（弯矩/最小轴径/截面模数/临界转速/等效重量）仅核心可见。
永不返回：`steps`、`k_force`。