# 大势历服务引擎 API

> 面向 Web、App、桌面与游戏后端的无状态命理计算服务。确定性引擎统一提供四柱个人盘、四柱合盘、紫微个人盘和紫微双人合参；LLM 只用于可选白话增强。

服务引擎使用 UTF-8 JSON。首先调用能力发现接口，再按 feature 调用统一执行接口。合盘与合参可独立执行，不要求先生成个人报告。生产客户端必须通过安全网关持有访问凭证。

## Start here

- [开发者文档](/api-docs.html): 快速开始、四能力请求示例、错误处理、前端与游戏接入说明
- [AI 能力清单](/docs/api/service-engine.json): 最小且结构化的服务、流程、feature、示例与错误码目录
- [OpenAPI JSON](/docs/api/openapi.json): 完整 OpenAPI 3.1 契约，适合代码生成、Schema 校验和 AI 工具调用
- [OpenAPI YAML](/docs/api/openapi.yaml): 完整契约的 YAML 原始版本
- [完整 AI 上下文](/llms-full.txt): 可直接交给 LLM/Agent 的集成说明与四个请求样例

## Source and SDK

- [服务引擎架构](/docs/service-engine.md): 服务边界、确定性与 LLM 约束、版本和游戏接入原则
- [JavaScript SDK](/docs/sdk/javascript.md): 浏览器、Node 与 React Native 的零依赖客户端
- [Unity 网关示例](/docs/sdk/unity.md): Steam/Unity 通过自有后端网关接入

## Optional

- [完整 API 指南](/docs/api.md): 持久化出生资料、命盘、报告、导出和关系授权接口
- [LLM Gateway](/docs/llm-openrouter-integration.md): 可选模型路由、脱敏、校验与安全回退