AI Services

Notice

This document is a machine-translated draft and is currently undergoing review. Some content may be inaccurate or differ from the original Korean version. For the most precise information, refer to the Korean documentation.

Go to AI Services API v3 Reference→

New Feature Notice

• Supported scope: AI services(AI Subtitle, AI Summary, AI Speed) are new features added in v3, and are not supported in v1 or v2.
• Common authentication: All APIs require the common authentication method via a query string parameter (?access_token=).

---

Create AI Subtitle

• Supported version (v3): POST /media-contents/{upload_file_key}/ai-subtitles

Request body

Field	Data Type	Required	Description and Allowed Values
language_code	String	Required	Primary language used in the video or audio for which subtitles are generated (ko: Korean, en: English)
kind	Integer	Required	Subtitle type setting (0: main subtitle, 1: sub subtitle)
status	Integer	Required	Subtitle visibility setting (0: private, 1: public)

Response structure specification

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

---

Retrieve AI Summary data

• Supported version (v3): GET /media-contents/{upload_file_key}/ai-outlines

Request query parameters

Parameter	Data Type	Required	Description
language_code	String	Optional	Filter by subtitle language (ko: Korean, en: English)

Response structure specification

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

---

Create AI Summary data

• Supported version (v3): POST /media-contents/{upload_file_key}/ai-outlines

Request body

Field	Data Type	Required	Description
language_code	String	Required	Primary language used in the video or audio for which the summary and chapters are generated (ko: Korean, en: English)
ai_subtitle_kind	Integer	Optional	Type setting for the linked AI Subtitle (0 or 1)
ai_subtitle_status	Integer	Optional	Visibility setting for the linked AI Subtitle (0 or 1)

Response structure and exception specification

• On success: Returns an HTTP 204 No Content status code with no separate response data body.
• On exception
  • 403 Forbidden: No permission
  • 409 Conflict: Summary and chapter data already exists

---

Convert content to AI Speed

• Supported version (v3): POST /media-contents/{upload_file_key}/ai-scripts

Request body

This endpoint identifies the task using only the upload_file_key specified in the URL path, without a request body.

Response structure specification

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