v1

latestOpenAPI 3.1.02026-07-266827131.9 KB

Submit Screenplay Task

post/screenplay/tasks

Request body

mode'short_drama' | 'korean_drama' | 'prompt_script' required

Extraction mode

episodesobject required

Map of episode number to asset_id

Example request

{
  "mode": "short_drama",
  "episodes": {
    "1": "re_657739295220518912",
    "2": "re_657739295220518913",
    "3": "re_657739295220518914"
  },
  "config": {
    "language": "zh-CN",
    "use_face_recognition": true,
    "require_json": true,
    "concurrency": 100
  }
}

Response

Task submitted successfully

codeinteger

Response code indicating the result status

msgstring

Response message

successboolean

Indicates whether the operation was successful

failedboolean

Indicates whether the operation failed

Example response

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "ros-sd-20260313-a3f8c2b1",
    "status": "pending",
    "mode": "short_drama",
    "created_at": "2026-03-13T10:00:00Z",
    "total_duration_seconds": 450.5
  },
  "success": true
}