import axios, { type AxiosRequestConfig } from 'axios'
import { VoicevoxError, VoicevoxErrorCode, handleError } from './error'
import type { AudioQuery, Speaker } from './types'
export class VoicevoxApi {
private readonly baseUrl: string
constructor(baseUrl: string) {
this.baseUrl = this.normalizeUrl(baseUrl)
}
/**
* テキストから音声合成用クエリを生成
*/
public async generateQuery(text: string, speaker = 1): Promise<AudioQuery> {
try {
const endpoint = `/audio_query?text=${encodeURIComponent(text)}&speaker=${encodeURIComponent(speaker.toString())}`
const query = await this.makeRequest<AudioQuery>('post', endpoint, null, {
'Content-Type': 'application/json',
})
return query
} catch (error) {
throw handleError('音声クエリ生成中にエラーが発生しました', error)
}
}
/**
* 音声合成用クエリから音声ファイルを生成
*/
public async synthesize(query: AudioQuery, speaker = 1): Promise<ArrayBuffer> {
try {
return await this.makeRequest<ArrayBuffer>(
'post',
`/synthesis?speaker=${encodeURIComponent(speaker.toString())}`,
query,
{
'Content-Type': 'application/json',
Accept: 'audio/wav',
},
'arraybuffer'
)
} catch (error) {
throw handleError('音声合成中にエラーが発生しました', error)
}
}
/**
* プリセットを使用してテキストから音声合成用クエリを生成
*/
public async generateQueryFromPreset(text: string, presetId: number, coreVersion?: string): Promise<AudioQuery> {
try {
let endpoint = `/audio_query_from_preset?text=${encodeURIComponent(
text
)}&preset_id=${encodeURIComponent(presetId.toString())}`
if (coreVersion) {
endpoint += `&core_version=${encodeURIComponent(coreVersion)}`
}
const query = await this.makeRequest<AudioQuery>('post', endpoint, null, {
'Content-Type': 'application/json',
})
return query
} catch (error) {
throw handleError('プリセットを使用した音声クエリ生成中にエラーが発生しました', error)
}
}
/**
* スピーカーの一覧を取得
*/
public async getSpeakers(): Promise<Speaker[]> {
try {
const endpoint = '/speakers'
const response = await this.makeRequest<Speaker[]>('get', endpoint, null, {
'Content-Type': 'application/json',
})
return response
} catch (error) {
throw handleError('スピーカー一覧取得中にエラーが発生しました', error)
}
}
/**
* スピーカーの情報を取得
*/
public async getSpeakerInfo(uuid: string): Promise<Speaker> {
try {
const endpoint = `/speaker_info?speaker_uuid=${encodeURIComponent(uuid)}`
const response = await this.makeRequest<Speaker>('get', endpoint, null, {
'Content-Type': 'application/json',
})
return response
} catch (error) {
throw handleError('スピーカー情報取得中にエラーが発生しました', error)
}
}
/**
* VOICEVOX Engine の接続状態をチェック
* @returns 接続情報（connected, version, url）
*/
public async checkHealth(): Promise<{ connected: boolean; version?: string; url: string }> {
try {
// /version エンドポイントを使用（軽量）
const version = await this.makeRequest<string>('get', '/version')
return {
connected: true,
version,
url: this.baseUrl,
}
} catch {
return {
connected: false,
url: this.baseUrl,
}
}
}
/**
* APIリクエストを実行
* @private
*/
private async makeRequest<T>(
method: 'get' | 'post',
endpoint: string,
data: any = null,
headers: Record<string, string> = {},
responseType: 'json' | 'arraybuffer' = 'json'
): Promise<T> {
try {
const url = `${this.baseUrl}${endpoint}`
const config: AxiosRequestConfig = {
method,
url,
data,
headers,
responseType,
timeout: 30000,
}
const response = await axios(config)
if (response.status !== 200) {
throw new VoicevoxError(
`APIリクエストに失敗しました: ${response.status}`,
VoicevoxErrorCode.API_CONNECTION_ERROR
)
}
return response.data
} catch (error) {
if (axios.isAxiosError(error)) {
throw new VoicevoxError(`APIリクエストに失敗しました: ${error.message}`, VoicevoxErrorCode.API_CONNECTION_ERROR)
}
throw error
}
}
/**
* URLの正規化
* @private
*/
private normalizeUrl(url: string): string {
return url.endsWith('/') ? url.slice(0, -1) : url
}
}
