Cloud API (Form-Data)

単語辞書の作成

基本情報

Path： /v1/hotwords

Method： POST

APIの説明： 単語リストをアップロードして、単語辞書を作成します。単語辞書の作成に上限はありません。

単語リストファイルの形式

UTF-8エンコードのテキストファイル。

単語の手動抽出

1行に1つ/1セットの単語を記入し、1行あたり30文字以内、最大20000行。言語に応じて異なるフォーマットを設定します。

日本語/日英混合：["表記,読み,クラス", "表記,読み,クラス", ...]
中国語/中英混合/英語： ["表記", "表記", ...]

不適切な単語は、プラットフォームによって自動的にフィルタリングされます。フィルタリング条件:

1列または2列のみが存在する場合（日本語および日英混合の言語のみ適用）
クラスがドロップダウンリストの値に含まれていない
すべてが句読点のみ
文字数制限を超えている
絵文字や特殊文字を含んでいる
内容が空である
重複項目
読みがひらがなまたは全角カタカナで入力されていない
1列を超える場合（英語&中国語&中英混合の言語のみ適用）

ファイル内容の例：

早稲田大学,ワセダダイガク,固有名詞
新横浜,シンヨコハマ,地名

単語の自動抽出

テキスト内容は100万文字以内、サイズは30MB以下です。 auto_extraction = true パラメータを設定する必要があります。現在、中国語および中英混合の言語のみ対応しています。

ファイル内容の例：

中国第40次南极考察内陆队北京时间16日在中山站举行出征仪式，29名队员将分别前往泰山站、昆仑站和格罗夫山地区，开展相关科学考察。本次考察由自然资源部组织。这是中国首次派出3艘船执行南极考察任务，即雪龙号、雪龙二号和天惠轮。

リクエストパラメータ

Body（form-data）

名前	タイプ	必須	説明	デフォルト値
name	string	いいえ	単語辞書名	空
lang_type	string	はい	言語、開発ガイド-言語サポートを参照してください	必須
file	file	はい	単語リストファイル	必須
auto_extraction	boolean	いいえ	単語リストの内容から自動的にキーワードを抽出するかどうか。現在、中国語および中英混合の言語のみ対応しています。	false
id	string	いいえ	単語辞書ID。数字、英字（大文字と小文字を区別しない）、アンダースコア、ハイフンのみ（`[a-zA-Z0-9_-]`）がサポートされています。長さは150文字を超えてはいけません。 IDを指定しない場合は、システムが自動的にIDを生成します。	Null

レスポンスパラメータ

名前	タイプ	説明
status	string	ステータスコード
message	string	ステータスコードの説明
data	object	データ
├─ id	string	単語辞書ID

リクエスト例

curl --location 'https://api.voice.dolphin-ai.jp/v1/hotwords' \
--header 'Authorization: ••••••' \
--form 'file=@"name.txt"' \
--form 'lang_type="ja-JP"' \
--form 'name="test"'

レスポンス例

{
    "status": "000000",
    "message": "Success",
    "data": {
        "id": "HWABF229C4"
    }
}

単語辞書情報リストの取得

基本情報

Path： /v1/hotwords

Method： GET

APIの説明： 全ての単語辞書情報を取得します。

リクエストパラメータ

名前	タイプ	必須	説明	デフォルト値
name	string	否	単語辞書名または単語辞書ID	無し
lang_type	string	否	言語	無し
page_size	int	否	1ページあたりの項目数、最大100	10
page_index	int	否	ページ番号	1

レスポンスパラメータ

名前	タイプ	説明
status	string	ステータスコード
message	string	ステータスコードの説明
data	object	データ
├─ amount	int	フィルタ条件に合致する単語辞書の数（単語辞書名やID、言語のフィルタリングが行われた場合）
├─ used	int	総数
├─ list	object[]
├─├─id	string	単語辞書ID
├─├─ name	string	単語辞書名
├─├─ lang_type	string	言語
├─├─ status	int	ステータス 0:未使用 1: 使用中
├─├─ amount	int	単語数
├─├─ update_time	string	最終更新時間

リクエスト例

curl --location 'https://api.voice.dolphin-ai.jp/v1/hotwords' \
--header 'Authorization: ••••••'

レスポンス例

{
    "status": "000000",
    "message": "Success",
    "data": {
        "list": [
            {
                "id": "HWF21FA445",
                "name": "xxx",
                "lang_type": "ja-JP",
                "status": 0,
                "amount": 2,
                "updated_time": "2025-02-10 17:23:01"
            }
        ],
        "amount": 13,
        "used": 13
    }
}

単語辞書の削除

基本情報

Path：/v1/hotwords/{hotwords_id}

Method： DELETE

APIの説明： 指定されたIDの単語辞書を削除します。現在認識リクエストが呼び出されていない辞書のみ削除できます。

リクエスト例

curl --location --request DELETE 'https://api.voice.dolphin-ai.jp/v1/hotwords/HWA3B0FD4F' \
--header 'Authorization: ••••••'

レスポンス例

{
    "status": "00000",
    "message": "success",
    "data": null
}

レスポンスパラメータ

名前	タイプ	説明
status	string	ステータスコード
message	string	ステータスコードの説明
data	object	無し

単語辞書情報の変更

基本情報

Path： /v1/hotwords/{hotwords_id}

Method： PUT

APIの説明： 既存の単語辞書名または単語リストを変更します。注意：単語リストを変更する場合、辞書内の全ての単語が新しいリストの内容で上書きされます。

リクエストパラメータ

Body（form-data）

名前	タイプ	必須	説明	デフォルト値
name	string	いいえ	単語辞書名（fileと少なくとも一方が空でないこと）	無し
file	file	いいえ	単語リスト（nameと少なくとも一方が空でないこと）	無し
auto_extraction	boolean	いいえ	単語リストの内容から自動的にキーワードを抽出するかどうか。現在、中国語および中英混合の言語のみ対応しています。	false

レスポンスパラメータ

名前	タイプ	説明
status	string	ステータスコード
message	string	ステータスコードの説明
data	object	データ
├─ id	string	単語辞書ID

リクエスト例

辞書名の変更

curl --location --request PUT 'https://api.voice.dolphin-ai.jp/v1/hotwords/HWABF229C4' \
--header 'Authorization: ••••••' \
--form 'name="test2"'

単語リストファイルの変更

curl --location --request PUT 'https://api.voice.dolphin-ai.jp/v1/hotwords/HWABF229C4' \
--header 'Authorization: ••••••' \
--form 'file=@"new.txt"'

レスポンス例

{
    "status": "000000",
    "message": "Success",
    "data": {
        "id": "HWABF229C4"
    }
}

単語辞書情報の取得

基本情報

Path： /v1/hotwords/{hotwords_id}

Method： GET

APIの説明： 指定されたIDの単語辞書の情報を取得します。

レスポンスパラメータ

名前	タイプ	説明
status	string	ステータスコード
message	string	ステータスコードの説明
data	object	データ
├─ id	string	単語辞書ID
├─ name	string	単語辞書名
├─ lang_type	string	言語
├─ status	int	ステータス 0: 未使用 1: 使用中
├─ update_time	string	最終更新時間
├─ words	list<string>	単語リスト
├─ amount	int	単語数

リクエスト例

curl --location 'https://api.voice.dolphin-ai.jp/v1/hotwords/HWABF229C4' \
--header 'Authorization: ••••••'

レスポンス例

{
    "status": "000000",
    "message": "S
    
    uccess",
    "data": {
        "id": "HWABF229C4",
        "name": "test2",
        "lang_type": "ja-JP",
        "status": 0,
        "updated_time": "2025-01-22 15:09:14",
        "words": [
            "早稲田大学,ワセダダイガク,固有名詞"
        ],
        "amount": 1
    }
}

単語辞書のダウンロード

基本情報

Path： /v1/hotwords/download/{hotwords_id}

Method： GET

APIの説明： 指定されたIDの単語辞書をダウンロードします。

リクエスト例

curl --location 'https://api.voice.dolphin-ai.jp/v1/hotwords/download/HWF8C024CA' \
--header 'Authorization: ••••••'

レスポンス例

Starting from the second line, enter one hot word per line. Note: For hot words in Japanese or mixed Japanese-English languages, you need to maintain 'writing, pronunciation, class' with three items separated by commas. If any item is missing, it is considered an invalid hot word. For hot words in other languages, only the 'writing' needs to be maintained.
インスパイア,コンニチハ,固有名詞
カタカナ,コンニチハ,固有名詞
プレゼント,コンニチハ,固有名詞

目次