メインコンテンツまでスキップ

AI サービス

新機能のご案内
  • サポート範囲: AI サービス（AI字幕、AI要約・チャプター、AI倍速）は v3 で新規追加された機能であり、v1 および v2 ではサポートされません。
  • 共通認証: すべての API はクエリストリングパラメータ（?access_token=）による共通認証方式が必須です。
AI サービス API v3 リファレンスへ

AI字幕生成​

  • v3: POST /media-contents/{upload_file_key}/ai-subtitles

リクエストボディ​

フィールドデータ型必須有無説明と許容値
language_codeString必須字幕生成対象の動画またはオーディオの主要使用言語（ko: 韓国語、en: 英語）
kindInteger必須字幕タイプの設定（0: メイン字幕、1: サブ字幕）
statusInteger必須字幕公開設定（0: 非公開、1: 公開）

レスポンス構造仕様​

{
  "data": {
    "task_id": "id",
    "message": "string"
  },
  "status": "ok"
}

AI要約・チャプターデータ照会​

  • v3: GET /media-contents/{upload_file_key}/ai-outlines

リクエストクエリパラメータ​

パラメータデータ型必須有無説明
language_codeStringオプション字幕言語フィルタリング（ko: 韓国語、en: 英語）

レスポンス構造仕様​

{
  "data": [
    {
      "language_code": "ko",
      "summary": [
        {
          "start_position": 0,
          "end_position": 120,
          "value": "string"
        }
      ],
      "chapter": [
        {
          "position": 0,
          "value": "string"
        }
      ],
      "keyword": [
        "string1", "string2"
      ]
    }
  ]
}

AI要約・チャプターデータ生成​

  • v3: POST /media-contents/{upload_file_key}/ai-outlines

リクエストボディ​

フィールドデータ型必須有無説明
language_codeString必須要約・チャプター生成対象の動画またはオーディオの主要使用言語（ko: 韓国語、en: 英語）
ai_subtitle_kindIntegerオプション連携される AI字幕のタイプ設定（0 または 1）
ai_subtitle_statusIntegerオプション連携される AI字幕の公開設定（0 または 1）

レスポンス構造と例外仕様​

  • 成功時: 別途のレスポンスデータボディなしで HTTP 204 No Content ステータスコードを返します。
  • 例外発生時
    • 403 Forbidden: 権限なし
    • 409 Conflict: すでに要約・チャプターデータが存在する

コンテンツAI倍速変換​

  • v3: POST /media-contents/{upload_file_key}/ai-scripts

リクエストボディ​

このエンドポイントはリクエストボディなしで、URL パス（Path）に指定された upload_file_key のみを使用してタスクを識別します。

レスポンス構造仕様​

{
  "data": {
    "task_id": "id"
  },
  "status": "ok"
}