import_video_url

Import a public video link

Import one public YouTube, Facebook or TikTok video (up to 10 minutes and 250 MB) into the Library. Returns an asynchronous import: poll get_video_import until ready, then use its upload_id. Import costs no credits and uses storage quota. analyze_after_import runs the app analyst for 5 credits; leave false to analyze with your own model using measure_video and save_video_analysis. Private videos, playlists and live streams are unsupported.

Scope

generation.write — Makes, edits, imports, shares and deletes media in the account.

Behaviour

Writes: Creates or changes items in the caller's own account.
Adds or updates: Adds or updates; nothing the caller already has is deleted or overwritten.
Reaches outside: Downloads a public video from YouTube, Facebook or TikTok into the caller's library.
Idempotent: Calling it again with the same arguments has no further effect.

Credits

What the tool's description says about credits, verbatim.

Import costs no credits and uses storage quota. analyze_after_import runs the app analyst for 5 credits; leave false to analyze with your own model using measure_video and save_video_analysis.

Inputs

urlstring · required
at least 1 character · at most 2048 characters
productstring · optional
one of "kuro" · default "kuro"
analyze_after_importboolean · optional
default false

Example call

A tools/call request with the required arguments only, each a placeholder read off the schema. Replace them before sending.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "import_video_url",
    "arguments": {
      "url": "<url>"
    }
  }
}

Input schema

As the server sends it in tools/list.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048
    },
    "product": {
      "type": "string",
      "enum": [
        "kuro"
      ],
      "default": "kuro"
    },
    "analyze_after_import": {
      "type": "boolean",
      "default": false
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

Related tools

get_video_import
Read one import's progress by import_id, or omit it to recover recent imports.
measure_video
Measure an uploaded video so you can reverse-engineer its format: shot boundaries with real timestamps, one or more keyframe images per shot, a timed tran…
save_video_analysis
Store your beat sheet for an analysed video.

Every tool· This page as Markdown