映像から抽出された音声タグの取得(日本語のみ対応)

本APIは指定されたパラメータにより取得出来る情報が異なります。 どのオプションパラメータも指定しない場合は、音声解析済みの登録ビデオのタグ統計が取得されます。 メディアIDを指定すると、該当のメディアに付けられた音声タグを返却致します。 JSONにより音声タグを指定して、該当音声タグが付けられたメディアIDを返却することも出来ます。

GET /api/1/videos/audiotag

Parameters

  • output_type [オプション]
    • Response 形式
      • x : XML 形式で出力
      • 指定無し : JSON 形式で出力
  • media_ids [オプション]
    • 本パラメータにより指定するメディアID(複数指定可)に付けられた音声タグをJSONにより返却します。
  • audio_tag [オプション]
    • JSONにより特定の音声タグを指定し、該当するメディアIDを返却します。

Response

  • status

    • 処理結果
      success : 成功
      それ以外 : 失敗
  • media_ids

    • 該当するメディアID(配列)
  • statistics

    • 音声タグの統計情報
      • allnumtags
        • 全音声タグ個数
      • audio_tags
        • 音声タグ情報(配列)
          • audio_tag
            • 音声タグ
          • numtimes
            • 該当音声タグが付けられているビデオの数
  • audio_tag_information

    • 音声タグとメディアID組(配列)
      • media_id
        • メディアID
      • audio_tag
        • 該当メディア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"
  ]
}