IOUXI 开发文档 v1.0 Beta

欢迎使用 IOUXI 开发者平台。本文档涵盖 FEAIA SDK、SkinPack 创作规范与 REST API 的完整参考。

当前 SDK 处于 Beta 阶段，需申请开发者资格获取 API Key。申请访问 →

安装

npm / yarn / pnpm

# npm
npm install @iouxi/feaia-sdk

# yarn
yarn add @iouxi/feaia-sdk

# pnpm
pnpm add @iouxi/feaia-sdk

Python

pip install iouxi-feaia

快速上手

三步集成 FEAIA 到您的应用：

index.ts
import { FeaiaClient } from '@iouxi/feaia-sdk'

// 1. 初始化客户端
const feaia = new FeaiaClient({ apiKey: process.env.IOUXI_API_KEY })

// 2. 发送消息
const reply = await feaia.chat({ message: 'Hello!' })

// 3. 使用回复
console.log(reply.text, reply.emotion, reply.expression)

REST API 端点参考

所有请求需携带 Authorization: Bearer YOUR_API_KEY 头。Base URL: https://api.voxvoy.com/v1

POST/feaia/chat发送消息，获取 AI 回复
GET/feaia/personas获取可用人格列表
POST/feaia/tts文字转语音合成
GET/skinpack/list获取皮肤市场列表
POST/skinpack/publish发布皮肤到市场
POST/points/grant发放積分（需管理员权限）

API 文档完整版正在整理中。申请开发者资格后可访问 Postman 集合与 OpenAPI 规范文件。联系我们 →

SkinPack 格式规范 v1.0

SkinPack 是 FEAIA 的皮肤包格式，一个 .iouxi-skin 文件实际上是标准 ZIP 包，包含以下结构：

my-skin.iouxi-skin (ZIP)
my-skin/
├── manifest.json        # 必填：皮肤元数据
├── model/
│   ├── model.json       # Live2D 模型描述文件
│   ├── *.moc3           # Live2D 模型文件
│   └── textures/        # 贴图资源
├── motions/             # 动作定义
├── expressions/         # 表情定义
├── sounds/              # 可选：语音包 (.wav/.mp3)
└── preview.png          # 必填：512×512 预览图