Enterprise Power SI Engine API

viivaev SI Engine Developer API Documentation

viivaev SI Engine provides highly reliable, sub-5ms RESTful API endpoints for resolving dynamic 9×6 matrix strategies, compiling Gemini-optimized System Instructions, and driving high-depth technical documentation generation across potential transformers (PT/VT), current transformers (CT), power transformers, and switchgear assemblies.

Base URL/api/v1

Dispatch Latency SLA< 5 ms (Edge Cacheable)

AuthenticationOpen Query / Server Secret Proxy

API Endpoints Catalog

6 Core Endpoints Available

GET/api/v1/system-instructionSI Engine Core

Compile & Dispatch Dynamic System Instruction

Dynamically compiles an authoritative electrical engineering System Instruction and 9-module structured strategy optimized for Google Gemini API based on the 9-digit Rubik's code and target power equipment parameter.

Request Parameters

Parameter	Type	Required	Default	Description
code	string	Required	645341264	9-digit numeric state code (each digit 1-6), e.g. 645341264
articleTitle	string	Optional	0.2S Accuracy & Ferroresonance Suppression: Full-Lifecycle Deconstruction	[Mutually Exclusive A] Engineering white paper title. Dispatches 1500-word in-depth white paper directive (exclusive with productName).
productName	string	Optional	10kV Epoxy Resin Cast Potential Transformer (JDZ-10 / IEC 61869-3)	[Mutually Exclusive B] Power equipment model and specifications. Dispatches 600-word product datasheet directive (exclusive with articleTitle).
lang	string	Optional	en	Target language: "en" (default) or "zh" (optional)

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

GET/api/v1/matrixMatrix & Strategy

Get 9×6 Matrix Specification & Full 54 Strategies Dictionary

Exports all 9 electromagnetic engineering functional modules and the complete 54-strategy dictionary with color codes, normal vector mappings, and bilingual descriptions.

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

POST/api/v1/matrix/validateMatrix & Strategy

Validate 9-Digit Code & Resolve Module Mapping

Validates arbitrary 9-digit strings (length must be 9, digits 1-6), returning sanitized codes, structural errors if any, and exact module-strategy mappings.

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

POST/api/v1/matrix/randomMatrix & Strategy

Generate Compliant Random Code (Supports Pinning)

Generates fully compliant 9-digit random codes with support for pinning specific modules to designated variants (e.g., pin Module 1 to Variant 6, Module 8 to Variant 1).

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

POST/api/generateText Generation

Gemini 3.8 Flash End-to-End Document Generation

Direct server-side Google Gemini 3.8 Flash SDK call passing the compiled System Instruction and target parameters to generate bidding-grade technical documentation.

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

GET/api/healthSystem

System Health & Engine Status Check

Returns Next.js App Router engine operational status, deployment environment, and live server timestamp.

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