中枢EN Console

API 文档

用 Master Brain
构建你的系统

LMNIC 自主决策引擎的完整 API 参考文档。

概览 / 身份验证 / 端点 / 代码示例 / 错误 / 速率限制

001 — 入门指南

API 概览

LMNIC API 支持将自主决策引擎直接集成到你的企业系统中。单一 REST 端点即可处理多源数据压缩、潜在推理与执行意图交付。

专为静默运行设计——没有冗长的思维链输出，没有进度提示。提交上下文和数据，获得决策结果。支持实时处理，并可通过 webhook 回调实现异步工作流。

实时决策

为时间敏感型执行提供亚秒级响应。潜在推理以毫秒级完成，而非分钟级。

批量处理

单次调用提交多个决策请求。并行处理并返回聚合结果。

Webhook 与事件

决策完成后异步通知，无需轮询。采用静默的事件驱动架构。

多租户隔离

每个 API 密钥享有完全的数据隔离。企业级分离，配备专属处理管道。

002 — 安全优先

身份验证

Bearer Token 身份验证

所有 LMNIC API 请求都需要使用 Bearer token 进行身份验证。请在每个请求的 Authorization 请求头中包含你的 API 密钥。

▸

API 密钥（Bearer Token） — 推荐用于服务器间集成

▸

OAuth 2.0 — 用于用户授权访问流程

▸

服务账户密钥 — 用于无人值守的自主 agent

获取 API 密钥

  1. 01

    登录 LMNIC 控制台

  2. 02

    进入 设置 → API 密钥

  3. 03

    点击"生成新密钥"

  4. 04

    复制密钥并妥善保存（仅显示一次）

# Authentication header example
Authorization: Bearer lmnic_sk_prod_1a2b3c4d5e6f7g8h

# Request example with curl
curl -X POST https://api.lmnic.com/v1/decisions \
  -H "Authorization: Bearer lmnic_sk_prod_..." \
  -H "Content-Type: application/json" \
  -d '{{
    "context": "capital structure optimization",
    "data": {{...}}
  }}'

003 — 核心端点

端点参考

POST

创建决策请求

https://api.lmnic.com/v1/decisions

提交一个新的自主决策请求。返回决策 ID，可用于轮询或 webhook 回调。

请求参数

← 左右滑动查看完整表格 →

参数 类型 说明
context string（必填） 决策所属的业务场景或用例
data object（必填） 用于分析的多源数据对象
timeout integer（可选） 最长处理时间，单位秒（默认：30）
callback_url string（可选） 用于异步通知的 webhook URL

响应示例 

{{
  "id": "req_1a2b3c4d5e",
  "status": "processing",
  "context": "capital structure optimization",
  "decision": {{
    "recommendation": "Restructure allocation across 3 tiers",
    "confidence": 0.947,
    "reasoning_summary": "Multi-source compression analysis..."
  }},
  "metadata": {{
    "processing_time_ms": 2340,
    "signal_strength": 0.982,
    "created_at": "2024-01-15T10:30:45Z"
  }}
}}
GET

获取决策状态

https://api.lmnic.com/v1/decisions/{id}

获取已提交决策请求的状态与结果。

路径参数

← 左右滑动查看完整表格 →

参数 类型 说明
id string（必填） POST /decisions 返回的决策请求 ID

响应示例 

{{
  "id": "req_1a2b3c4d5e",
  "status": "completed",
  "decision": {{
    "recommendation": "Restructure allocation across 3 tiers",
    "confidence": 0.947,
    "execution_intent": "autonomous"
  }},
  "metadata": {{
    "processing_time_ms": 2340,
    "completed_at": "2024-01-15T10:30:47Z"
  }}
}}
GET

获取近期决策列表

https://api.lmnic.com/v1/decisions?limit=20&offset=0

获取指定 API 密钥对应的近期决策请求的分页列表。

查询参数

← 左右滑动查看完整表格 →

参数 类型 说明
limit integer（可选） 每页返回结果数量（默认：20，最大：100）
offset integer（可选） 分页时跳过的结果数量
status string（可选） 按状态筛选：processing、completed、failed

004 — 实施指南

代码示例

Python SDK 

import lmnic

# Initialize client
client = lmnic.Client(api_key="lmnic_sk_prod_...")

# Create decision request
decision = client.decisions.create(
    context="capital structure optimization",
    data={{
        "current_allocation": {{...}},
        "market_data": {{...}},
        "risk_profile": "moderate"
    }}
)

# Poll for result
while decision.status == "processing":
    decision.refresh()
    time.sleep(0.5)

print(decision.recommendation)
print(f"Confidence: {{decision.confidence}}")

JavaScript / Node.js 

const lmnic = require('@lmnic/sdk');

const client = new lmnic.Client({{
  apiKey: 'lmnic_sk_prod_...'
}});

async function makeDecision() {{
  const decision = await client.decisions.create({{
    context: 'capital structure optimization',
    data: {{
      currentAllocation: {{...}},
      marketData: {{...}}
    }}
  }});
  
  const result = await decision.waitForCompletion();
  console.log(result.recommendation);
}}

cURL 

curl -X POST https://api.lmnic.com/v1/decisions \
  -H "Authorization: Bearer lmnic_sk_prod_..." \
  -H "Content-Type: application/json" \
  -d '{{
    "context": "capital structure optimization",
    "data": {{
      "current_allocation": {{...}},
      "market_data": {{...}}
    }},
    "callback_url": "https://your-app.com/webhooks/lmnic"
  }}'

005 — 错误管理

错误响应

LMNIC API 返回标准 HTTP 状态码，并以 JSON 格式提供详细错误信息。每个错误都包含用于排查问题的请求 ID。

← 左右滑动查看完整表格 →

代码 状态 说明
401 Unauthorized API 密钥无效或缺失
400 Bad Request 请求格式错误或参数无效
429 Rate Limited 请求次数过多，请延迟后重试
500 Server Error 服务器内部错误，请联系支持团队

错误响应格式 

{{
  "error": {{
    "code": "invalid_context",
    "message": "Context field is required",
    "details": {{
      "field": "context",
      "reason": "missing_required_field"
    }}
  }},
  "request_id": "req_xyz"
}}

006 — 速率限制

速率限制

LMNIC 对每个 API 密钥执行速率限制，以确保公平使用和系统稳定。限额因套餐等级而异，并按滚动窗口重置。

← 左右滑动查看完整表格 →

套餐 每分钟 每日
Starter 100 次请求 10,000 次请求
Professional 1,000 次请求 1,000,000 次请求
Enterprise 定制 定制

速率限制响应头

每个 API 响应都包含表明当前速率限制状态的响应头。 

# Response headers
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 947
X-RateLimit-Reset: 1705312200

# Python: Parse rate limit headers
remaining = response.headers["X-RateLimit-Remaining"]
reset_time = response.headers["X-RateLimit-Reset"]

if int(remaining) < 100:
    print("Approaching rate limit")

— 参考

API 不是一个工具，而是一个已经做出的决策——静默地交付到你的系统中。