クイックスタート
1. デバイスを登録
管理画面からデバイスを登録します。デバイス ID と名前を設定してください。
2. API キーを取得
設定画面から API キーを発行します。このキーを使って API にアクセスできます。
3. API をテスト
API コンソールから実際に API を呼び出してみましょう。
API リファレンス
POST
/api/speakテキストを音声に変換して再生します。
{
"text": "こんにちは",
"voice": "default",
"speed": 1.0,
"volume": 1.0
}
POST
/api/chatユーザー発話に対して AI が応答します。
{
"message": "今日の天気は？",
"read_aloud": true
}
POST
/api/listen音声入力から STT → LLM → TTS まで一気通貫で処理します。
Content-Type: audio/wav
GET
/api/statusデバイスの現在の状態を取得します。
GETPOST
/api/settingsキャラクター設定を取得・更新します。
{
"persona": "friendly",
"dialect": "kansai",
"style": "cheerful",
"lang": "ja-JP"
}
SDK
TypeScript
TypeScript/JavaScript 向け SDK を提供しています。
npm install mia-kitPython
Python 向け SDK を提供しています。
pip install mia-kitサンプルコード
TypeScript で会話する
import { MiaKit } from 'mia-kit';
const client = new MiaKit({ apiKey: 'your_api_key' });
const response = await client.chat({
message: '今日の天気は？',
readAloud: true
});
Python でテキストを喋らせる
from miakit import MiaKit
client = MiaKit(api_key="your_api_key")
client.speak("こんにちは、ミーアです")