映像から抽出された音声タグの取得(日本語のみ対応)¶
本APIは指定されたパラメータにより取得出来る情報が異なります。 どのオプションパラメータも指定しない場合は、音声解析済みの登録ビデオのタグ統計が取得されます。 メディアIDを指定すると、該当のメディアに付けられた音声タグを返却致します。 JSONにより音声タグを指定して、該当音声タグが付けられたメディアIDを返却することも出来ます。
GET /api/1/videos/audiotag
Parameters¶
- output_type [オプション]
- Response 形式
- x : XML 形式で出力
- 指定無し : JSON 形式で出力
- Response 形式
- media_ids [オプション]
- 本パラメータにより指定するメディアID(複数指定可)に付けられた音声タグをJSONにより返却します。
- audio_tag [オプション]
- JSONにより特定の音声タグを指定し、該当するメディアIDを返却します。
Response¶
status
- 処理結果success : 成功それ以外 : 失敗
media_ids
- 該当するメディアID(配列)
statistics
- 音声タグの統計情報
- allnumtags
- 全音声タグ個数
- audio_tags
- 音声タグ情報(配列)
- audio_tag
- 音声タグ
- numtimes
- 該当音声タグが付けられているビデオの数
- audio_tag
- 音声タグ情報(配列)
- allnumtags
- 音声タグの統計情報
audio_tag_information
- 音声タグとメディアID組(配列)
- media_id
- メディアID
- audio_tag
- 該当メディアIDに付けられた音声タグ
- media_id
- 音声タグとメディアID組(配列)
Request Example 1¶
GET
https://example.com/api/1/videos/audiotag
Sample Curl Command 1¶
- Basic認証を使用した方法
curl --basic -u {your account}:{your password} "https://example.com/api/1/videos/audiotag"
- AccessToken認証を使用した方法(media_idsとlevelsで指定)
curl "https://example.com/api/1/videos/audiotag" \
-H "Authorization: Bearer {your access_token}"
Response Example 1 - JSON¶
{
"status":"success",
"statistics":
{
"allnumtags":9,
"audio_tags":[
{"audio_tag":"奥さん", "numtimes":1},
{"audio_tag":"おにぎり","numtimes":1},
{"audio_tag":"おかげ","numtimes":1},
{"audio_tag":"おじいちゃん","numtimes":1},
{"audio_tag":"92年間","numtimes":1},
{"audio_tag":"幼稚園","numtimes":1},
{"audio_tag":"90歳","numtimes":1},
{"audio_tag":"米","numtimes":1},
{"audio_tag":"野菜","numtimes":1}
]
}
}
Response Example - XML¶
<?xml version="1.0" encoding="UTF-8" ?>
<response>
<status>success</status>
<statistics>
<allnumtags>9</allnumtags>
<audio_tags>
<audio_tag>奥さん</audio_tag>
<numtimes>1</numtimes>
</audio_tags>
<audio_tags>
<audio_tag>おにぎり</audio_tag>
<numtimes>1</numtimes>
</audio_tags>
<audio_tags>
<audio_tag>おかげ</audio_tag>
<numtimes>1</numtimes>
</audio_tags>
<audio_tags>
<audio_tag>おじいちゃん</audio_tag>
<numtimes>1</numtimes>
</audio_tags>
<audio_tags>
<audio_tag>92年間</audio_tag>
<numtimes>1</numtimes>
</audio_tags>
<audio_tags>
<audio_tag>幼稚園</audio_tag>
<numtimes>1</numtimes>
</audio_tags>
<audio_tags>
<audio_tag>90歳</audio_tag>
<numtimes>1</numtimes>
</audio_tags>
<audio_tags>
<audio_tag>米</audio_tag>
<numtimes>1</numtimes>
</audio_tags>
<audio_tags>
<audio_tag>野菜</audio_tag>
<numtimes>1</numtimes>
</audio_tags>
</statistics>
</response>
Request Example 2¶
GET
https://example.com/api/1/videos/audiotag?media_ids=580,581
Sample Curl Command 2¶
- Basic認証を使用した方法
curl --basic -u {your account}:{your password} "https://example.com/api/1/videos/audiotag?media_ids=580,581"
Response Example 2 - JSON¶
{
"status":"success",
"audio_tag_information":[
{"media_id":580,
"audio_tag":[
"奥さん","おにぎり","おかげ"
]
},
{"media_id":581,
"audio_tag":[
"おじいちゃん","92年間","幼稚園","90歳","米","野菜"
]
}
]
}
Request Example 3¶
GET
https://example.com/api/1/videos/audiotag?audio_tag={"tag":"世界"}
Sample Curl Command 3¶
- Basic認証を使用した方法
curl --basic -u {your account}:{your password} "https://example.com/api/1/videos/audiotag?audio_tag=\{\"tag\":\"世界\"\}" -X GET
Response Example 3 - JSON¶
{
"status":"success",
"media_ids":[
"570","571"
]
}