F
FACEGOOD®

开发者文档与 SDK

EmotionAI API 完整参考文档

快速开始

5 分钟内完成 EmotionAI API 接入

第 1 步：获取 API Key

在控制台的 Dashboard 页面创建您的 API Key。每个 Key 绑定一个项目。

# 复制您的 API Key

export EMOTIONAI_API_KEY="eak_live_xxxxxxxxxxxx"

第 2 步：安装 SDK

Python

pip install emotionai

Node.js

npm install @facegood/emotionai

C++ / Unity

从 SDK 页面下载

第 3 步：发送第一个请求

import

{ EmotionAI } from '@facegood/emotionai';

// 初始化客户端

const client = new EmotionAI({

apiKey: process.env.EMOTIONAI_API_KEY,

region: 'cn-east-1',

});

// 情绪识别

const result = await client.recognize({

image: './face.jpg',

model: 'emotion-v3',

});

console.log(result.emotions);

// > [{ type: 'Happy', confidence: 0.94, muscles: [...] }]

💡 提示

EmotionAI 支持 170 维面部肌群信号解析，远超传统 ARKit 的 52 个 BlendShape。建议在高精度场景使用 emotion-v3-hd 模型。

© 2026 FACEGOOD Inc. 保留所有权利。

API v3.2.1所有系统正常运行