辞書削除

mocoVoice API リファレンス (1.2.0)

mocoVoice APIでは、音声ファイルの書き起こしが行えます。

書き起こしAPIでは、音声ファイルをアップロードし、書き起こしを開始し、その結果を取得することができます。

辞書APIでは、書き起こし精度を高めるために、辞書を作成し、単語を登録することができます。

Servers

mocoVoice APIサーバー

https://api.mocomoco.ai/

書き起こしAPI

書き起こしAPIでは、音声ファイルをアップロードし、書き起こしを開始し、その結果を取得することができます。
書き起こしの際には、辞書を指定することもできます。

主な機能
• 音声のファイルアップロードする
• 書き起こしを開始する
• 書き起こし結果を取得する

Operations

辞書API

辞書APIでは、書き起こし精度を高めるために、単語とその読みを登録した辞書を作成することができます。

主な機能
• 辞書を作成する
• 辞書に単語を登録する
• 辞書を参照する

Operations

辞書リスト取得

Request

チームに関連付けられた辞書のリストを取得します。ページネーションが可能です。

Query

pageinteger

取得するページ番号（デフォルトは1）

Default 1

curl -i -X GET \
  'https://api.mocomoco.ai/api/v1/dictionaries?page=1' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

辞書のリストを取得しました。

Bodyapplication/jsonArray [

dictionary_idstring

辞書の一意な識別子

team_idstring

辞書が所属するチームのID

namestring

辞書の名前

created_atstring(date-time)

辞書が作成された日時

updated_atstring(date-time)

辞書が最後に更新された日時

]

Response

application/json

[
  {
    "dictionary_id": "string",
    "team_id": "string",
    "name": "string",
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
  }
]

辞書作成

Request

新しい辞書を作成します。辞書は書き起こし時に使用することができます。

Bodyapplication/jsonrequired

namestringrequired

作成する辞書の名前

curl -i -X POST \
  https://api.mocomoco.ai/api/v1/dictionaries \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE' \
  -d '{
    "name": "string"
  }'

Responses

辞書が正常に作成されました。

Bodyapplication/json

dictionary_idstring

辞書の一意な識別子

team_idstring

辞書が所属するチームのID

namestring

辞書の名前

wordsArray of arrays

辞書に含まれる単語の配列

created_atstring(date-time)

辞書が作成された日時

updated_atstring(date-time)

辞書が最後に更新された日時

Response

application/json

{
  "dictionary_id": "string",
  "team_id": "string",
  "name": "string",
  "words": [],
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z"
}

辞書取得

Request

指定した辞書IDの詳細情報を取得します。辞書に含まれる単語の一覧も取得できます。

Path

dictionary_idstringrequired

取得したい辞書のID

curl -i -X GET \
  'https://api.mocomoco.ai/api/v1/dictionaries/{dictionary_id}' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

辞書の詳細情報を取得しました。

Bodyapplication/json

dictionary_idstring

辞書の一意な識別子

team_idstring

辞書が所属するチームのID

namestring

辞書の名前

wordsArray of arrays

辞書に含まれる単語の配列

created_atstring(date-time)

辞書が作成された日時

updated_atstring(date-time)

辞書が最後に更新された日時

Response

application/json

{
  "dictionary_id": "string",
  "team_id": "string",
  "name": "string",
  "words": [],
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z"
}

辞書アップデート

Request

指定した辞書の情報を更新します。辞書名の変更などが可能です。

Path

dictionary_idstringrequired

更新したい辞書のID

Bodyapplication/jsonrequired

namestring

更新する辞書の新しい名前

curl -i -X PATCH \
  'https://api.mocomoco.ai/api/v1/dictionaries/{dictionary_id}' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE' \
  -d '{
    "name": "string"
  }'

Responses

辞書が正常に更新されました。

Bodyapplication/json

dictionary_idstring

辞書の一意な識別子

team_idstring

辞書が所属するチームのID

namestring

辞書の名前

wordsArray of arrays

辞書に含まれる単語の配列

created_atstring(date-time)

辞書が作成された日時

updated_atstring(date-time)

辞書が最後に更新された日時

Response

application/json

{
  "dictionary_id": "string",
  "team_id": "string",
  "name": "string",
  "words": [],
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z"
}

辞書削除

Request

指定した辞書を削除します。削除すると、その辞書に関連付けられた単語もすべて削除されます。

Path

dictionary_idstringrequired

削除したい辞書のID

curl -i -X DELETE \
  'https://api.mocomoco.ai/api/v1/dictionaries/{dictionary_id}' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

辞書が正常に削除されました。

Bodyapplication/json

any

Response

application/json

null

単語登録

Request

指定した辞書に新しい単語を登録します。書き起こし時に正確な変換が可能になります。

Path

dictionary_idstringrequired

単語を追加したい辞書のID

Bodyapplication/jsonrequired

wordstringrequired

登録する単語

readingstring

単語の読み仮名（任意）

curl -i -X POST \
  'https://api.mocomoco.ai/api/v1/dictionaries/{dictionary_id}/words' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE' \
  -d '{
    "word": "string",
    "reading": "string"
  }'

Responses

単語が正常に登録されました。

Bodyapplication/json

word_idstring

単語の一意な識別子

dictionary_idstring

単語が所属する辞書のID

wordstring

辞書に登録する単語

readingstring

単語の読み仮名（任意）

created_atstring(date-time)

単語が作成された日時

updated_atstring(date-time)

単語が最後に更新された日時

Response

application/json

{
  "word_id": "string",
  "dictionary_id": "string",
  "word": "string",
  "reading": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z"
}

複数の単語登録

Request

指定した辞書に複数の単語を一括で登録します。大量の単語を効率的に追加できます。

Path

dictionary_idstringrequired

単語を追加したい辞書のID

Bodyapplication/jsonrequiredArray [

wordstringrequired

登録する単語

readingstring

単語の読み仮名（任意）

]

curl -i -X POST \
  'https://api.mocomoco.ai/api/v1/dictionaries/{dictionary_id}/words/bulk' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE' \
  -d '[
    {
      "word": "string",
      "reading": "string"
    }
  ]'

Responses

単語が正常に登録されました。

Bodyapplication/jsonArray [

word_idstring

単語の一意な識別子

dictionary_idstring

単語が所属する辞書のID

wordstring

辞書に登録する単語

readingstring

単語の読み仮名（任意）

created_atstring(date-time)

単語が作成された日時

updated_atstring(date-time)

単語が最後に更新された日時

]

Response

application/json

[
  {
    "word_id": "string",
    "dictionary_id": "string",
    "word": "string",
    "reading": "string",
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
  }
]

単語取得

Request

指定した単語IDの詳細情報を取得します。

Path

dictionary_idstringrequired

単語が含まれる辞書のID

word_idstringrequired

取得したい単語のID

curl -i -X GET \
  'https://api.mocomoco.ai/api/v1/dictionaries/{dictionary_id}/words/{word_id}' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

単語の詳細情報を取得しました。

Bodyapplication/json

word_idstring

単語の一意な識別子

dictionary_idstring

単語が所属する辞書のID

wordstring

辞書に登録する単語

readingstring

単語の読み仮名（任意）

created_atstring(date-time)

単語が作成された日時

updated_atstring(date-time)

単語が最後に更新された日時

Response

application/json

{
  "word_id": "string",
  "dictionary_id": "string",
  "word": "string",
  "reading": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z"
}

単語削除

Request

指定した単語を辞書から削除します。

Path

dictionary_idstringrequired

単語が含まれる辞書のID

word_idstringrequired

削除したい単語のID

curl -i -X DELETE \
  'https://api.mocomoco.ai/api/v1/dictionaries/{dictionary_id}/words/{word_id}' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

単語が正常に削除されました。

Bodyapplication/json

any

Response

application/json

null