开发者集成文档

viivaev 电力 9×6 矩阵超级智能 (SI) REST API 接口规范

高可用、边缘加速的 REST 接口服务，用于实时编译下发动态系统指令、查询 9×6 矩阵 54 策略字典，以及直接调用 Gemini 3.8 Flash 模型。

可用 REST API 端点

Base URL: https://viivaev.com

GET/api/v1/system-instruction

SI Engine Core

编译并获取动态 System Instruction

根据 9 位魔方状态码及输配电设备参数，实时编译专为 Google Gemini API 优化的高阶电气工程系统指令及 9 模块结构化策略。

请求参数 (Query Parameters)

Parameter	Type	Required	Description	Default
code	string	Yes	9 位数字状态码（每位取值 1-6），例如 645341264	645341264
articleTitle	string	Optional	【互斥参数 A】拟定工程技术文章标题。传入时下发 1500 Words 深度技术白皮书长文指令（与 productName 互斥，二选一）	0.2S Accuracy & Ferroresonance Suppression: Full-Lifecycle Deconstruction
productName	string	Optional	【互斥参数 B】电力设备名称与规格型号。传入时下发 600 Words 设备产品工程规格导则指令（与 articleTitle 互斥，二选一）	10kV Epoxy Resin Cast Potential Transformer (JDZ-10 / IEC 61869-3)
lang	string	Optional	目标指令语言："en"（默认英文）或 "zh"（中文可选）	en

调用代码示例

curl -X GET "https://viivaev.com/api/v1/system-instruction?code=645341264&lang=en"

GET/api/v1/matrix

Matrix & Strategy

获取 9×6 矩阵规格与全 54 策略字典

导出 9 大电磁工程功能模块及全部 54 种变体策略字典、颜色标识体系与魔方六面法线映射表。

调用代码示例

curl -X GET "https://viivaev.com/api/v1/matrix"

POST/api/v1/matrix/validate

Matrix & Strategy

校验 9 位状态码并解析模块映射

校验传入的 9 位数字串是否符合规范（每位1-6），并即刻解析对应的 9 模块变体中文与英文映射。

调用代码示例

curl -X POST "https://viivaev.com/api/v1/matrix/validate" \
  -H "Content-Type: application/json" \
  -d '{"code": "645341264"}'

POST/api/v1/matrix/random

Matrix & Strategy

随机生成合规 9 位状态码（支持固定指定位）

从 10,077,696 种空间中抽取一组 9 位合规状态码，支持指定固定某些模块的变体。

调用代码示例

curl -X POST "https://viivaev.com/api/v1/matrix/random" \
  -H "Content-Type: application/json" \
  -d '{"fixed": {"1": 6}}'

POST/api/generate

Text Generation

Gemini 3.8 Flash 长文案端到端生成

服务端直连 Google Gemini API，传入编译好的 System Instruction 与产品工程规格，生成符合国家电网招投标与技术白皮书标准的万字/千字长文。

调用代码示例

curl -X POST "https://viivaev.com/api/generate" \
  -H "Content-Type: application/json" \
  -d '{
    "systemInstruction": "...",
    "productName": "10kV JDZ-10",
    "language": "en"
  }'

GET/api/health

System

系统运行与健康状态检查

返回 Next.js App Router 引擎服务状态、部署环境与实时服务端时间戳。

调用代码示例

curl -X GET "https://viivaev.com/api/health"