POST
$0.12 default
/api/downloadDescription
Create a paid StableTube download job. StableTube downloads the video server-side, uploads the mp4 to S3, and returns a temporary StableTube-owned download URL when ready.
Pricing
$0.12 default
Request schema
{
"additionalProperties": false,
"properties": {
"clientRequestId": {
"description": "Optional idempotency key scoped to the paying wallet.",
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"format": {
"default": "mp4",
"description": "Output container format. mp4 only for now.",
"enum": [
"mp4"
],
"type": "string"
},
"quality": {
"description": "Required target video quality. The request fails if unavailable.",
"enum": [
"360p",
"720p",
"1080p"
],
"type": "string"
},
"tier": {
"description": "Required output size tier: tube-100mb (100 MB, $0.05) | tube-500mb (500 MB, $0.10) | tube-1gb (1 GB, $0.20).",
"enum": [
"tube-100mb",
"tube-500mb",
"tube-1gb"
],
"type": "string"
},
"type": {
"default": "stabletube.download",
"enum": [
"stabletube.download"
],
"type": "string"
},
"url": {
"description": "Full YouTube URL of the video to download.",
"type": "string"
}
},
"required": [
"type",
"url",
"quality",
"tier",
"format"
],
"type": "object"
}Example response
{
"contentLengthBytes": 23456789,
"downloadUrl": "https://stabletube-bucket.s3.us-east-1.amazonaws.com/...",
"durationSec": 213,
"expiresAt": "2026-05-04T18:00:00.000Z",
"format": "mp4",
"jobId": "clxstabletubejob123",
"maxBytes": 524288000,
"mimeType": "video/mp4; codecs=\"avc1.64001F, mp4a.40.2\"",
"price": "0.10",
"quality": "720p",
"status": "complete",
"tier": "tube-500mb",
"title": "Rick Astley - Never Gonna Give You Up (Official Video)",
"videoId": "dQw4w9WgXcQ"
}