動画の登録

サーバに動画を登録します。動画の登録が完了すると、タイルの生成が自動的に開始されます。 さらに特定のパラメータを追加することで、自動タグ付けやnsfw(not safe for work)に 該当する動画の確率を返すことが可能になります。また、動画中から音声（日本語のみ）を取得 及び解析し、文字列を返すことも可能です。

POST /api/1/videos

ノート

メディアの有効化について：本 API を実行してもメディアは有効になりません。登録した動画（メディア）を fv に表示させるためには、メディアの有効化が必要になります。タイルの生成が完了してから、メディアの有効化 API によりメディアの有効化を行います。[詳細] 音声認識パラメータを付けて動画登録した場合は、動画から音声が抽出・解析が行われ、その中で名詞をデータベースに登録します。 登録された音声タグは[音声タグ取得API]により取得することが出来ます。

Parameters

  • output_type

    • Response 形式
      • x : XML 形式で出力
      • 指定無し : JSON 形式で出力

  • upfile [必須]

    • アップロードするファイル（バイナリ）200MBまで。

  • tile_type [必須]

    • タイル種別。1 種類のみ指定可能。
    • hd 16:9 / sd 4:3 / r 3:2 / s 1:1

  • duration

    • 生成するタイルの時間（1〜900秒）。整数で指定
      時間は登録動画の時間以内で指定してください。登録動画の時間を超えた値を指定すると自動的に duration は登録動画の時間までとなります。

  • levels

    • 生成するタイルのレベルを指定。カンマで複数指定が可能。指定なしの場合、レベル1 のタイルを生成。
      レベル1のタイルは動画登録時に自動的に生成されます。
      ex)
      level=2 と指定：レベル1,2 のタイルが生成
      level=3,4 と指定：レベル1,3,4 のタイルが生成

  • tile_qualitys [必須]

    • 生成するタイルの品質を指定。カンマで複数指定可能。指定なしの場合、エラーを返す。
      ex)
      tile_qualitys=2と指定：品質2のタイルが生成されます。
      tile_qualitys=1,2,3と指定：品質1,2,3のタイルが生成

  • audio_recog [オプション][本機能を利用するためには，別途お問い合わせ下さい．]

    • 登録された動画から音声情報を抽出・解析し、AudioTagとして登録するパラメータです。
      指定する場合は、”audio_recog=1”を指定して下さい。
      （但し本パラメータを指定すると動画登録プロセス処理速度が数秒遅くなります。）

  • autotag [オプション][本機能を利用するためには，別途お問い合わせ下さい．]

    • 登録された動画に対して画像・動画解析を行い、自動タグ付けを行うパラメータです。
      指定する場合は”autotag=1”を指定して下さい。
      (但し本パラメータを指定すると動画登録プロセス処理速度が数秒遅くなります。)

  • nsfw [オプション][本機能を利用するためには，別途お問い合わせ下さい．]

    • 登録された動画に対して画像・動画解析を行い、該当メディアがNot-Safe-For-Workである確率（百分率）の
      計算を行うパラメータです。
      指定する場合は”nsfw=1”を指定して下さい。
      (但し本パラメータを指定すると動画登録プロセス処理速度が数秒遅くなります。)

  • thumbnail_position

    • 登録動画のフレームレートに基づいたフレームを指定。10個まで指定可能。
      サムネイルはデフォルトでは 0フレーム目（最初のフレーム）から自動的に jpg ファイルを生成します。thumbnail_position でフレーム指定をしていても、デフォルトのサムネイル（ 0フレーム目 ）は生成されます。
      ex)
      thumbnail_position=5 と指定: 0,5フレームのサムネイルが生成（2枚生成）

  • crop_position

    • 入力サイズが、出力サイズより大きい場合に使用されるパラメータ
      1 : 中央
      2 : 左上
      3 : 右上
      4 : 左下
      5 : 右下

  • padding_position

    • 出力サイズが、入力サイズより大きい場合に使用されるパラメータ
      1 : 中央
      2 : 左上
      3 : 右上
      4 : 左下
      5 : 右下

  • crop_inheriting

    • 複数の出力サイズに対して、タイルを同時生成する場合のポリシーを選択します。
      0 (On) : 有効表示範囲をレベル間で統一
      1 (Off) : 有効表示範囲をレベル毎に最適化

  • crop_policy_ob

    • 出力サイズが、入力サイズより大きい場合の伸縮ポリシー
      0 : [Cover] アスペクト比を保ってリサイズ（リサイズ後登録動画 ⊃ 出力領域）
      1 : [Contain] アスペクト比を保ってリサイズ（リサイズ後登録動画 ⊂ 出力領域）
      2 : [Fill] アスペクト比を崩してリサイズ
      3 : [Dot by dot] 単純なパディング

  • crop_policy_ib

    • 入力サイズが、出力サイズより大きい場合の伸縮ポリシー
      0 : [Cover] アスペクト比を保ってリサイズ（リサイズ後登録動画 ⊃ 出力領域）
      1 : [Contain] アスペクト比を保ってリサイズ（リサイズ後登録動画 ⊂ 出力領域）
      2 : [Fill] アスペクト比を崩してリサイズ
      3 : [Dot by dot] 単純なクロップ

Sample Curl Command

  • Basic認証を使用した方法
curl --basic -u {your account}:{your password} \
  "https://example.com/api/1/videos?tile_type=hd&duration=10&levels=1,2&tile_qualitys=2&autotag=1&nsfw=1&audio_recog=1" \
  -X POST -F "upfile=@{upload_file_path}"
  • AccessToken認証を使用した方法
curl "https://example.com/api/1/videos?tile_type=hd&duration=10&levels=1,2&tile_qualitys=2&autotag=1&nsfw=1&audio_recog=1" \
  -H "Authorization: Bearer {your access_token}" \
  -X POST -F "upfile=@{upload_file_path}"

Response

  • status

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

  • media_id

    • 登録されたメディアID

  • autotags

    • 動画登録オプションにより”autotag=1”が指定された場合に、本パラメータが返却されます。
      配列であり，自動メディア解析及び付与されたタグが挿入されています。
      タグの数はメディアに応じて変わります。

  • nsfw

    • 動画登録オプションにより”nsfw=1”が指定された場合に、本パラメータが返却されます。
      該当メディアがNot-Safe-For-Workである確率を百分率で返します。

  • audio_recognition

    • 動画登録オプションにより”audio_recog=1”が指定され、かつ正常に分析が成功した場合に、
      本パラメータが返却されます。
      該当メディアからの音声を抽出し、その解析結果を文字列として返却致します。

Response Example - JSON

{
  "media_id":474,
  "status":"success",
  "autotags":["technology","screen"],
  "nsfw":"0.0019919699989259",
  "audio_recognition":["愛する奥さんへ","いつも朝早く起きておにぎりを握ってくれていつもありがとうあなたのおにぎりのおかげでいつも仕事頑張りますこれからも美味しいおにぎりを握ってくれくださいいつもありがとう"]
}

Response Example - XML

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <media_id>475</media_id>
  <status>success</status>
  <autotags>
      <entry>technology</entry>
      <entry>screen</entry>
  </autotags>
  <nsfw>0.0019919699989259</nsfw>