YouTube

The video's file (own or licensed content)

Copies the video (mp4) or its audio (mp3) to your storage so you can cut, caption or dub it with /v1/studio/* — the whole dub, from this call to publishing on YouTube, is the recipe /skills/full-dub-video.md. Open to every account, for your own channel or content you are licensed to use: every call records the license you declare together with the video it is for (source in the answer; GET /v1/usage?tag=<job> lists it with the job's other calls). creative-commons is refused for a video YouTube lists under its standard licence. Private, age-restricted and live videos cannot be taken. The file is deleted after 24 hours like every upload. An account that took files it had no rights to is closed for YouTube files (403 youtube_files_not_enabled).

Billing: 5 provider credits (the transfer) — plus the storage · Rate limit: 6/min

post/v1/youtube/videos/{id}/file

Request

  • Base URL: https://apihub.co.il
  • URL: https://apihub.co.il/v1/youtube/videos/{id}/file
  • Auth: HTTP bearer

Path parameters

idstring required

Video id or a YouTube link

Headers

Idempotency-Keystring

Replay-safe: the same execution is returned instead of charging twice

X-Tagstring

Group calls into one job (e.g. one video) — see GET /v1/usage?tag=…

Request body

kind'video' | 'audio'

video = the video file (mp4) · audio = its sound only (mp3)

creditstring

The credit line you will show (Creative Commons)

license'own' | 'creative-commons' | 'licensed' required

Your basis for using this video, recorded with your account: own = a channel you control · creative-commons = the video is published under Creative Commons (license in the search; keep the credit line on screen) · licensed = you hold written permission from the owner

Response

Completed

idstring

Execution id — stable across internal retries; use it with GET /v1/executions/{id}

status'pending' | 'processing' | 'completed' | 'partial' | 'failed' | 'cancelled' | 'timeout'
operationstring
tagstring nullable

Your X-Tag, if sent

created_atstring date-time
completed_atstring date-time nullable
outputobject

Operation result (see each operation). While a Studio render is processing: stage (queued · transcribing · downloading · preparing · cleaning_voice · mixing_audio · rendering · finishing), phase (the engine's: download · prepare · voice · audio · encode · qa · upload, or null), progress (a percent, 0–100) and progress_fraction (0–1), eta_seconds (seconds left, never below 0) and estimate_seconds

errorstring nullable

Changes

No recorded changes to this operation across all 2 revisions of this API.