Server definition
- Hash
- sha256:4d89119fa326114665d151624564256fd9e486b22c556ff43029f36188274653
- What it is
- What a remote MCP server returned when asked what it offers: 14 tools
The blob, as servednamed by its sha256
{
"instructions": "Use the conversation for upload guidance, current price, visual wishes, explicit confirmation, processing status and errors. Prepare a free draft, present its current quote and concise visual brief in chat, then call start_karaoke only after the user confirms those terms. After starting, continue monitoring the same project in this turn with get_karaoke until a current ready MP4, failure, cancellation or required lyrics correction. This read waits up to 20 seconds per call while work is active; keep checking without asking the user for another status request. Report only meaningful progress changes. Do not end with only a launch receipt, repeat start or retry a failure automatically. If the host interrupts or ends the turn, do not promise future background messages. In ChatGPT, use prepare_karaoke with native host-provided file parameters first. Use create_local_upload only when the environment can both read the selected file and send an outbound HTTPS PUT. Reading a ChatGPT attachment does not prove that network access. After an environment network denial, do not loop renewing upload tickets; use supported native file delivery or offer the existing website upload page. After an upload timeout or lost response, always call get_karaoke with the issued ticket's project_id before declaring failure, renewing a ticket or creating another project. If an awaiting_start draft exists, resume its quote. An immediate not_found while that upload may be in flight is inconclusive: briefly wait and recheck the same ID once, without an indefinite loop. If still unknown, report unconfirmed receipt; a timeout alone does not prove server unavailability. Do not open show_karaoke at these stages. Resume and check with get_karaoke. Call show_karaoke only after get_karaoke verifies a current ready MP4 with no lyrics review; its UI is only a finished preview and download. Use returned can_* fields; never invent readiness or bypass needs_lyrics_review. Retries keep the same project and design. Use replace_karaoke_lyrics for explicit user-approved text and update_karaoke_visuals for a selected background file or supported formatting changes. Read saved text with get_karaoke_lyrics only when needed. A returned new quote still needs confirmation before start. Never invent lyrics, file references, image generation, or a completed correction. Only offer a download returned by the service. Studio handoff stops Quick automation.",
"tools": [
{
"description": "Cancel this Quick workflow when can_cancel is true. Stops successor stages; completed preparation charges follow the existing service rules.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"expected_revision": {
"minimum": 1,
"title": "Expected Revision",
"type": "integer"
},
"idempotency_key": {
"maxLength": 255,
"minLength": 1,
"pattern": "^[^\\x00-\\x1f\\x7f]+$",
"title": "Idempotency Key",
"type": "string"
},
"project_id": {
"maxLength": 64,
"minLength": 1,
"pattern": "^[a-z0-9][a-z0-9_-]*$",
"title": "Project Id",
"type": "string"
}
},
"required": [
"project_id",
"expected_revision",
"idempotency_key"
],
"title": "CommandInput",
"type": "object"
},
"name": "cancel_karaoke",
"outputSchema": {
"additionalProperties": false,
"oneOf": [
{
"required": [
"project_id",
"project_revision",
"command_version",
"status",
"stage",
"quote",
"can_start",
"can_retry",
"can_cancel",
"can_handoff",
"preview_ready",
"needs_lyrics_review",
"can_replace_lyrics",
"can_update_visuals",
"progress",
"visual_preferences",
"visual",
"visual_source",
"visual_warning",
"error",
"lyrics_source",
"lyrics_search_outcome",
"lyrics_search_provider",
"demo_mode",
"project",
"studio_url",
"media"
]
},
{
"maxProperties": 1,
"properties": {
"error": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
},
"required": [
"error"
]
}
],
"properties": {
"can_cancel": {
"type": "boolean"
},
"can_handoff": {
"type": "boolean"
},
"can_replace_lyrics": {
"type": "boolean"
},
"can_retry": {
"type": "boolean"
},
"can_start": {
"type": "boolean"
},
"can_update_visuals": {
"type": "boolean"
},
"command_version": {
"minimum": 1,
"type": "integer"
},
"demo_mode": {
"type": [
"boolean",
"null"
]
},
"error": {
"anyOf": [
{
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
{
"type": "null"
}
]
},
"lyrics_search_outcome": {
"enum": [
null,
"not_requested",
"no_accepted_candidate",
"timeout",
"error",
"found"
]
},
"lyrics_search_provider": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"lyrics_source": {
"enum": [
null,
"user_supplied",
"search_result",
"asr_fallback",
"unknown"
]
},
"media": {
"additionalProperties": false,
"properties": {
"download_url": {
"format": "uri",
"maxLength": 8192,
"type": [
"string",
"null"
]
},
"expires_in": {
"maximum": 3600,
"minimum": 1,
"type": "integer"
},
"preview_url": {
"format": "uri",
"maxLength": 8192,
"type": [
"string",
"null"
]
}
},
"required": [
"preview_url",
"download_url",
"expires_in"
],
"type": "object"
},
"needs_lyrics_review": {
"type": "boolean"
},
"preview_ready": {
"type": "boolean"
},
"progress": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"elapsed_seconds": {
"minimum": 0,
"type": "integer"
},
"label": {
"maxLength": 200,
"type": "string"
},
"percent": {
"maximum": 100,
"minimum": 0,
"type": [
"number",
"null"
]
},
"phase": {
"maxLength": 80,
"type": "string"
},
"started_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
}
},
"required": [],
"type": [
"object",
"null"
]
},
"project": {
"additionalProperties": false,
"properties": {
"artist": {
"maxLength": 500,
"type": [
"string",
"null"
]
},
"duration_seconds": {
"exclusiveMinimum": 0,
"maximum": 600,
"type": [
"number",
"null"
]
},
"export_status": {
"maxLength": 40,
"type": [
"string",
"null"
]
},
"has_export": {
"type": [
"boolean",
"null"
]
},
"has_lyrics": {
"type": [
"boolean",
"null"
]
},
"id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"revision": {
"minimum": 1,
"type": [
"integer",
"null"
]
},
"title": {
"maxLength": 500,
"type": [
"string",
"null"
]
},
"visual_settings": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"aspect_ratio": {
"maxLength": 20,
"type": "string"
},
"background_blur": {
"maximum": 24,
"minimum": 0,
"type": "number"
},
"background_dimming": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"bouncing_ball": {
"type": "boolean"
},
"effect": {
"maxLength": 40,
"type": "string"
},
"effect_particle_size": {
"maximum": 2,
"minimum": 0.5,
"type": "number"
},
"effect_particle_speed": {
"maximum": 2.5,
"minimum": 0.25,
"type": "number"
},
"font_size": {
"maximum": 96,
"minimum": 24,
"type": "integer"
},
"highlight_color": {
"maxLength": 30,
"type": "string"
},
"line_presentation": {
"maxLength": 40,
"type": "string"
},
"lyric_x": {
"maximum": 0.95,
"minimum": 0.05,
"type": "number"
},
"lyric_y": {
"maximum": 0.95,
"minimum": 0.05,
"type": "number"
},
"text_backdrop_color": {
"maxLength": 30,
"type": "string"
},
"text_backdrop_height": {
"maximum": 1,
"minimum": 0.2,
"type": "number"
},
"text_backdrop_opacity": {
"maximum": 0.8,
"minimum": 0,
"type": "number"
},
"text_color": {
"maxLength": 30,
"type": "string"
}
},
"required": [],
"type": [
"object",
"null"
]
}
},
"required": [
"id",
"title",
"artist",
"duration_seconds",
"revision",
"has_export",
"has_lyrics",
"export_status",
"visual_settings"
],
"type": "object"
},
"project_id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"project_revision": {
"minimum": 1,
"type": "integer"
},
"quote": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"ai_background_included": {
"type": "boolean"
},
"amount_minor": {
"minimum": 0,
"type": "integer"
},
"currency": {
"maxLength": 12,
"minLength": 1,
"type": "string"
},
"duration_seconds": {
"exclusiveMinimum": 0,
"maximum": 600,
"type": "number"
},
"expires_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 32,
"pattern": "^[0-9a-f]{32}$",
"type": "string"
},
"pricing_version": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"id",
"amount_minor",
"currency",
"expires_at"
],
"type": "object"
},
"stage": {
"maxLength": 40,
"minLength": 1,
"type": "string"
},
"status": {
"maxLength": 40,
"minLength": 1,
"type": "string"
},
"studio_url": {
"format": "uri",
"maxLength": 8192,
"minLength": 1,
"type": "string"
},
"visual": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"effect": {
"maxLength": 32,
"type": "string"
},
"mood": {
"maxLength": 40,
"type": "string"
},
"palette": {
"maxLength": 32,
"type": "string"
},
"source": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"style_name": {
"maxLength": 64,
"type": "string"
},
"warning": {
"maxLength": 2000,
"type": [
"string",
"null"
]
}
},
"required": [],
"type": [
"object",
"null"
]
},
"visual_preferences": {
"maxLength": 2000,
"type": "string"
},
"visual_source": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"visual_warning": {
"maxLength": 2000,
"type": [
"string",
"null"
]
}
},
"type": "object"
}
},
{
"description": "Authorize a short-lived upload of the user's selected local MP3 only when the current environment can both read that file and send an outbound HTTPS PUT, such as Codex Desktop or CLI. Reading a ChatGPT attachment in a code sandbox does not establish outbound network access; prefer prepare_karaoke with native file parameters in ChatGPT. Supply the filename, exact byte size and SHA256, then stream that file with the returned PUT URL and purpose-bound headers. Ticket issuance does not mean audio was received. No OAuth credentials are needed or exposed. The completed PUT creates a free Quick draft; read it with get_karaoke, then confirm its price before starting. After a timeout or lost upload response, always call get_karaoke with the ticket's project_id before declaring failure, renewing a ticket or creating another project. If an awaiting_start draft exists, resume its current quote. An immediate not_found may precede an in-flight upload commit; briefly wait and recheck that same ID once. If still unconfirmed, report unconfirmed receipt, not server unavailability inferred from a timeout. Keep the same file and key; do not repeatedly renew tickets after an environment network denial. Does not start processing or charge funds.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"artist": {
"default": "",
"maxLength": 500,
"title": "Artist",
"type": "string"
},
"byte_size": {
"maximum": 104857600,
"minimum": 1,
"title": "Byte Size",
"type": "integer"
},
"filename": {
"maxLength": 255,
"minLength": 1,
"title": "Filename",
"type": "string"
},
"idempotency_key": {
"maxLength": 255,
"minLength": 1,
"pattern": "^[^\\x00-\\x1f\\x7f]+$",
"title": "Idempotency Key",
"type": "string"
},
"language": {
"default": "auto",
"maxLength": 30,
"minLength": 1,
"title": "Language",
"type": "string"
},
"sha256": {
"maxLength": 64,
"minLength": 64,
"pattern": "^[0-9a-f]{64}$",
"title": "Sha256",
"type": "string"
},
"title": {
"default": "",
"maxLength": 500,
"title": "Title",
"type": "string"
}
},
"required": [
"filename",
"byte_size",
"sha256",
"idempotency_key"
],
"title": "LocalUploadInput",
"type": "object"
},
"name": "create_local_upload",
"outputSchema": {
"additionalProperties": false,
"oneOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"project_id",
"upload_url",
"method",
"headers",
"file",
"expires_at",
"max_bytes"
]
},
{
"maxProperties": 1,
"properties": {
"error": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
},
"required": [
"error"
]
}
],
"properties": {
"error": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
"expires_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"file": {
"additionalProperties": false,
"properties": {
"byte_size": {
"maximum": 104857600,
"minimum": 1,
"type": "integer"
},
"filename": {
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"sha256": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
}
},
"required": [
"filename",
"byte_size",
"sha256"
],
"type": "object"
},
"headers": {
"additionalProperties": false,
"properties": {
"Authorization": {
"maxLength": 8192,
"minLength": 1,
"type": "string"
},
"Content-Type": {
"const": "audio/mpeg"
}
},
"required": [
"Authorization",
"Content-Type"
],
"type": "object"
},
"max_bytes": {
"maximum": 104857600,
"minimum": 1,
"type": "integer"
},
"method": {
"const": "PUT"
},
"project_id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"upload_url": {
"format": "uri",
"maxLength": 8192,
"minLength": 1,
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Get the connected Karaoke Maker account, existing balance and supported Quick features.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"title": "ToolInput",
"type": "object"
},
"name": "get_account",
"outputSchema": {
"additionalProperties": false,
"oneOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"id",
"display_name",
"currency",
"balance_minor",
"reserved_minor",
"capabilities",
"account_url"
]
},
{
"maxProperties": 1,
"properties": {
"error": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
},
"required": [
"error"
]
}
],
"properties": {
"account_url": {
"format": "uri",
"maxLength": 8192,
"minLength": 1,
"type": "string"
},
"balance_minor": {
"minimum": 0,
"type": "integer"
},
"capabilities": {
"additionalProperties": false,
"properties": {
"aspect_ratios": {
"items": {
"enum": [
"16:9",
"9:16",
"4:3",
"16:10"
]
},
"maxItems": 4,
"minItems": 1,
"type": "array",
"uniqueItems": true
},
"custom_background": {
"type": "boolean"
},
"custom_lyrics": {
"type": "boolean"
},
"edit_visuals": {
"type": "boolean"
},
"quick_create": {
"type": "boolean"
},
"server_export": {
"type": "boolean"
},
"visual_preferences": {
"type": "boolean"
}
},
"required": [
"quick_create",
"visual_preferences",
"custom_lyrics",
"custom_background",
"edit_visuals",
"server_export",
"aspect_ratios"
],
"type": "object"
},
"currency": {
"maxLength": 12,
"minLength": 1,
"type": "string"
},
"display_name": {
"maxLength": 200,
"type": "string"
},
"error": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
"id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"reserved_minor": {
"minimum": 0,
"type": "integer"
}
},
"type": "object"
}
},
{
"description": "Read a Quick project's authoritative status, progress, allowed actions and current MP4 links. While processing, this read waits up to 20 seconds for completion or an actionable state and returns the newest status. After a start or a request to monitor, keep calling this tool for the same project in the current turn until ready, failure, cancellation or lyrics review; do not ask the user to request each check. Do not repeat start or automatically retry a failure. Always use the project_id returned by an upload ticket to reconcile a timeout or lost raw-upload response before declaring failure or creating another upload. An existing awaiting_start draft means the audio arrived: resume its current quote. For that issued ID only, an immediate not_found during an in-flight upload is inconclusive; briefly wait and recheck the same ID once, then report receipt as unconfirmed if it is still unavailable. Do not infer that the server is down from a timeout alone. Discuss quotes, processing, errors and corrections in the conversation. Only after this reports a current ready MP4 and no lyrics review, call show_karaoke to display the finished preview and download.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"project_id": {
"maxLength": 64,
"minLength": 1,
"pattern": "^[a-z0-9][a-z0-9_-]*$",
"title": "Project Id",
"type": "string"
}
},
"required": [
"project_id"
],
"title": "ProjectInput",
"type": "object"
},
"name": "get_karaoke",
"outputSchema": {
"additionalProperties": false,
"oneOf": [
{
"required": [
"project_id",
"project_revision",
"command_version",
"status",
"stage",
"quote",
"can_start",
"can_retry",
"can_cancel",
"can_handoff",
"preview_ready",
"needs_lyrics_review",
"can_replace_lyrics",
"can_update_visuals",
"progress",
"visual_preferences",
"visual",
"visual_source",
"visual_warning",
"error",
"lyrics_source",
"lyrics_search_outcome",
"lyrics_search_provider",
"demo_mode",
"project",
"studio_url",
"media"
]
},
{
"maxProperties": 1,
"properties": {
"error": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
},
"required": [
"error"
]
}
],
"properties": {
"can_cancel": {
"type": "boolean"
},
"can_handoff": {
"type": "boolean"
},
"can_replace_lyrics": {
"type": "boolean"
},
"can_retry": {
"type": "boolean"
},
"can_start": {
"type": "boolean"
},
"can_update_visuals": {
"type": "boolean"
},
"command_version": {
"minimum": 1,
"type": "integer"
},
"demo_mode": {
"type": [
"boolean",
"null"
]
},
"error": {
"anyOf": [
{
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
{
"type": "null"
}
]
},
"lyrics_search_outcome": {
"enum": [
null,
"not_requested",
"no_accepted_candidate",
"timeout",
"error",
"found"
]
},
"lyrics_search_provider": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"lyrics_source": {
"enum": [
null,
"user_supplied",
"search_result",
"asr_fallback",
"unknown"
]
},
"media": {
"additionalProperties": false,
"properties": {
"download_url": {
"format": "uri",
"maxLength": 8192,
"type": [
"string",
"null"
]
},
"expires_in": {
"maximum": 3600,
"minimum": 1,
"type": "integer"
},
"preview_url": {
"format": "uri",
"maxLength": 8192,
"type": [
"string",
"null"
]
}
},
"required": [
"preview_url",
"download_url",
"expires_in"
],
"type": "object"
},
"needs_lyrics_review": {
"type": "boolean"
},
"preview_ready": {
"type": "boolean"
},
"progress": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"elapsed_seconds": {
"minimum": 0,
"type": "integer"
},
"label": {
"maxLength": 200,
"type": "string"
},
"percent": {
"maximum": 100,
"minimum": 0,
"type": [
"number",
"null"
]
},
"phase": {
"maxLength": 80,
"type": "string"
},
"started_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
}
},
"required": [],
"type": [
"object",
"null"
]
},
"project": {
"additionalProperties": false,
"properties": {
"artist": {
"maxLength": 500,
"type": [
"string",
"null"
]
},
"duration_seconds": {
"exclusiveMinimum": 0,
"maximum": 600,
"type": [
"number",
"null"
]
},
"export_status": {
"maxLength": 40,
"type": [
"string",
"null"
]
},
"has_export": {
"type": [
"boolean",
"null"
]
},
"has_lyrics": {
"type": [
"boolean",
"null"
]
},
"id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"revision": {
"minimum": 1,
"type": [
"integer",
"null"
]
},
"title": {
"maxLength": 500,
"type": [
"string",
"null"
]
},
"visual_settings": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"aspect_ratio": {
"maxLength": 20,
"type": "string"
},
"background_blur": {
"maximum": 24,
"minimum": 0,
"type": "number"
},
"background_dimming": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"bouncing_ball": {
"type": "boolean"
},
"effect": {
"maxLength": 40,
"type": "string"
},
"effect_particle_size": {
"maximum": 2,
"minimum": 0.5,
"type": "number"
},
"effect_particle_speed": {
"maximum": 2.5,
"minimum": 0.25,
"type": "number"
},
"font_size": {
"maximum": 96,
"minimum": 24,
"type": "integer"
},
"highlight_color": {
"maxLength": 30,
"type": "string"
},
"line_presentation": {
"maxLength": 40,
"type": "string"
},
"lyric_x": {
"maximum": 0.95,
"minimum": 0.05,
"type": "number"
},
"lyric_y": {
"maximum": 0.95,
"minimum": 0.05,
"type": "number"
},
"text_backdrop_color": {
"maxLength": 30,
"type": "string"
},
"text_backdrop_height": {
"maximum": 1,
"minimum": 0.2,
"type": "number"
},
"text_backdrop_opacity": {
"maximum": 0.8,
"minimum": 0,
"type": "number"
},
"text_color": {
"maxLength": 30,
"type": "string"
}
},
"required": [],
"type": [
"object",
"null"
]
}
},
"required": [
"id",
"title",
"artist",
"duration_seconds",
"revision",
"has_export",
"has_lyrics",
"export_status",
"visual_settings"
],
"type": "object"
},
"project_id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"project_revision": {
"minimum": 1,
"type": "integer"
},
"quote": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"ai_background_included": {
"type": "boolean"
},
"amount_minor": {
"minimum": 0,
"type": "integer"
},
"currency": {
"maxLength": 12,
"minLength": 1,
"type": "string"
},
"duration_seconds": {
"exclusiveMinimum": 0,
"maximum": 600,
"type": "number"
},
"expires_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 32,
"pattern": "^[0-9a-f]{32}$",
"type": "string"
},
"pricing_version": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"id",
"amount_minor",
"currency",
"expires_at"
],
"type": "object"
},
"stage": {
"maxLength": 40,
"minLength": 1,
"type": "string"
},
"status": {
"maxLength": 40,
"minLength": 1,
"type": "string"
},
"studio_url": {
"format": "uri",
"maxLength": 8192,
"minLength": 1,
"type": "string"
},
"visual": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"effect": {
"maxLength": 32,
"type": "string"
},
"mood": {
"maxLength": 40,
"type": "string"
},
"palette": {
"maxLength": 32,
"type": "string"
},
"source": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"style_name": {
"maxLength": 64,
"type": "string"
},
"warning": {
"maxLength": 2000,
"type": [
"string",
"null"
]
}
},
"required": [],
"type": [
"object",
"null"
]
},
"visual_preferences": {
"maxLength": 2000,
"type": "string"
},
"visual_source": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"visual_warning": {
"maxLength": 2000,
"type": [
"string",
"null"
]
}
},
"type": "object"
}
},
{
"description": "Read a bounded range of this project's saved lyric lines and their revision, without changing processing. Use for a user-requested lyric check or correction; do not invent missing text or silently rewrite repeats. Respect content rights when discussing lyrics in chat. No review card is opened.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"line_count": {
"default": 50,
"maximum": 200,
"minimum": 1,
"title": "Line Count",
"type": "integer"
},
"project_id": {
"maxLength": 64,
"minLength": 1,
"pattern": "^[a-z0-9][a-z0-9_-]*$",
"title": "Project Id",
"type": "string"
},
"start_line": {
"default": 1,
"minimum": 1,
"title": "Start Line",
"type": "integer"
}
},
"required": [
"project_id"
],
"title": "LyricsReadInput",
"type": "object"
},
"name": "get_karaoke_lyrics",
"outputSchema": {
"additionalProperties": false,
"oneOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"project_id",
"project_revision",
"lyrics",
"start_line",
"line_count",
"total_lines",
"has_more",
"lyrics_source"
]
},
{
"maxProperties": 1,
"properties": {
"error": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
},
"required": [
"error"
]
}
],
"properties": {
"error": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
"has_more": {
"type": "boolean"
},
"line_count": {
"maximum": 200,
"minimum": 0,
"type": "integer"
},
"lyrics": {
"maxLength": 65536,
"type": "string"
},
"lyrics_source": {
"enum": [
null,
"user_supplied",
"search_result",
"asr_fallback",
"unknown"
]
},
"project_id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"project_revision": {
"minimum": 1,
"type": "integer"
},
"start_line": {
"minimum": 1,
"type": "integer"
},
"total_lines": {
"minimum": 0,
"type": "integer"
}
},
"type": "object"
}
},
{
"description": "List the connected account's Quick projects to find work to continue in this chat.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"cursor": {
"anyOf": [
{
"maxLength": 64,
"minLength": 1,
"pattern": "^[a-z0-9][a-z0-9_-]*$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Cursor"
},
"limit": {
"default": 20,
"maximum": 50,
"minimum": 1,
"title": "Limit",
"type": "integer"
}
},
"title": "ListInput",
"type": "object"
},
"name": "list_karaokes",
"outputSchema": {
"additionalProperties": false,
"oneOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"projects",
"next_cursor"
]
},
{
"maxProperties": 1,
"properties": {
"error": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
},
"required": [
"error"
]
}
],
"properties": {
"error": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
"next_cursor": {
"maxLength": 64,
"minLength": 1,
"type": [
"string",
"null"
]
},
"projects": {
"items": {
"additionalProperties": false,
"properties": {
"artist": {
"maxLength": 500,
"type": [
"string",
"null"
]
},
"created_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
},
"id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"quick": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"demo_mode": {
"type": "boolean"
},
"id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"stage": {
"maxLength": 40,
"type": "string"
},
"status": {
"maxLength": 40,
"type": "string"
},
"visual_source": {
"maxLength": 64,
"type": [
"string",
"null"
]
}
},
"required": [
"status"
],
"type": "object"
},
"title": {
"maxLength": 500,
"type": [
"string",
"null"
]
},
"updated_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"title",
"artist",
"created_at",
"updated_at",
"quick"
],
"type": "object"
},
"maxItems": 50,
"type": "array"
}
},
"type": "object"
}
},
{
"description": "Hand this project from automatic Quick processing to the full Studio editor when the user requests manual correction. Stops Quick automation; this is an intentional change, not just a preview link.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"expected_revision": {
"minimum": 1,
"title": "Expected Revision",
"type": "integer"
},
"idempotency_key": {
"maxLength": 255,
"minLength": 1,
"pattern": "^[^\\x00-\\x1f\\x7f]+$",
"title": "Idempotency Key",
"type": "string"
},
"project_id": {
"maxLength": 64,
"minLength": 1,
"pattern": "^[a-z0-9][a-z0-9_-]*$",
"title": "Project Id",
"type": "string"
}
},
"required": [
"project_id",
"expected_revision",
"idempotency_key"
],
"title": "CommandInput",
"type": "object"
},
"name": "open_in_studio",
"outputSchema": {
"additionalProperties": false,
"oneOf": [
{
"required": [
"project_id",
"project_revision",
"command_version",
"status",
"stage",
"quote",
"can_start",
"can_retry",
"can_cancel",
"can_handoff",
"preview_ready",
"needs_lyrics_review",
"can_replace_lyrics",
"can_update_visuals",
"progress",
"visual_preferences",
"visual",
"visual_source",
"visual_warning",
"error",
"lyrics_source",
"lyrics_search_outcome",
"lyrics_search_provider",
"demo_mode",
"project",
"studio_url",
"media"
]
},
{
"maxProperties": 1,
"properties": {
"error": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
},
"required": [
"error"
]
}
],
"properties": {
"can_cancel": {
"type": "boolean"
},
"can_handoff": {
"type": "boolean"
},
"can_replace_lyrics": {
"type": "boolean"
},
"can_retry": {
"type": "boolean"
},
"can_start": {
"type": "boolean"
},
"can_update_visuals": {
"type": "boolean"
},
"command_version": {
"minimum": 1,
"type": "integer"
},
"demo_mode": {
"type": [
"boolean",
"null"
]
},
"error": {
"anyOf": [
{
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
{
"type": "null"
}
]
},
"lyrics_search_outcome": {
"enum": [
null,
"not_requested",
"no_accepted_candidate",
"timeout",
"error",
"found"
]
},
"lyrics_search_provider": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"lyrics_source": {
"enum": [
null,
"user_supplied",
"search_result",
"asr_fallback",
"unknown"
]
},
"media": {
"additionalProperties": false,
"properties": {
"download_url": {
"format": "uri",
"maxLength": 8192,
"type": [
"string",
"null"
]
},
"expires_in": {
"maximum": 3600,
"minimum": 1,
"type": "integer"
},
"preview_url": {
"format": "uri",
"maxLength": 8192,
"type": [
"string",
"null"
]
}
},
"required": [
"preview_url",
"download_url",
"expires_in"
],
"type": "object"
},
"needs_lyrics_review": {
"type": "boolean"
},
"preview_ready": {
"type": "boolean"
},
"progress": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"elapsed_seconds": {
"minimum": 0,
"type": "integer"
},
"label": {
"maxLength": 200,
"type": "string"
},
"percent": {
"maximum": 100,
"minimum": 0,
"type": [
"number",
"null"
]
},
"phase": {
"maxLength": 80,
"type": "string"
},
"started_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
}
},
"required": [],
"type": [
"object",
"null"
]
},
"project": {
"additionalProperties": false,
"properties": {
"artist": {
"maxLength": 500,
"type": [
"string",
"null"
]
},
"duration_seconds": {
"exclusiveMinimum": 0,
"maximum": 600,
"type": [
"number",
"null"
]
},
"export_status": {
"maxLength": 40,
"type": [
"string",
"null"
]
},
"has_export": {
"type": [
"boolean",
"null"
]
},
"has_lyrics": {
"type": [
"boolean",
"null"
]
},
"id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"revision": {
"minimum": 1,
"type": [
"integer",
"null"
]
},
"title": {
"maxLength": 500,
"type": [
"string",
"null"
]
},
"visual_settings": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"aspect_ratio": {
"maxLength": 20,
"type": "string"
},
"background_blur": {
"maximum": 24,
"minimum": 0,
"type": "number"
},
"background_dimming": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"bouncing_ball": {
"type": "boolean"
},
"effect": {
"maxLength": 40,
"type": "string"
},
"effect_particle_size": {
"maximum": 2,
"minimum": 0.5,
"type": "number"
},
"effect_particle_speed": {
"maximum": 2.5,
"minimum": 0.25,
"type": "number"
},
"font_size": {
"maximum": 96,
"minimum": 24,
"type": "integer"
},
"highlight_color": {
"maxLength": 30,
"type": "string"
},
"line_presentation": {
"maxLength": 40,
"type": "string"
},
"lyric_x": {
"maximum": 0.95,
"minimum": 0.05,
"type": "number"
},
"lyric_y": {
"maximum": 0.95,
"minimum": 0.05,
"type": "number"
},
"text_backdrop_color": {
"maxLength": 30,
"type": "string"
},
"text_backdrop_height": {
"maximum": 1,
"minimum": 0.2,
"type": "number"
},
"text_backdrop_opacity": {
"maximum": 0.8,
"minimum": 0,
"type": "number"
},
"text_color": {
"maxLength": 30,
"type": "string"
}
},
"required": [],
"type": [
"object",
"null"
]
}
},
"required": [
"id",
"title",
"artist",
"duration_seconds",
"revision",
"has_export",
"has_lyrics",
"export_status",
"visual_settings"
],
"type": "object"
},
"project_id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"project_revision": {
"minimum": 1,
"type": "integer"
},
"quote": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"ai_background_included": {
"type": "boolean"
},
"amount_minor": {
"minimum": 0,
"type": "integer"
},
"currency": {
"maxLength": 12,
"minLength": 1,
"type": "string"
},
"duration_seconds": {
"exclusiveMinimum": 0,
"maximum": 600,
"type": "number"
},
"expires_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 32,
"pattern": "^[0-9a-f]{32}$",
"type": "string"
},
"pricing_version": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"id",
"amount_minor",
"currency",
"expires_at"
],
"type": "object"
},
"stage": {
"maxLength": 40,
"minLength": 1,
"type": "string"
},
"status": {
"maxLength": 40,
"minLength": 1,
"type": "string"
},
"studio_url": {
"format": "uri",
"maxLength": 8192,
"minLength": 1,
"type": "string"
},
"visual": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"effect": {
"maxLength": 32,
"type": "string"
},
"mood": {
"maxLength": 40,
"type": "string"
},
"palette": {
"maxLength": 32,
"type": "string"
},
"source": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"style_name": {
"maxLength": 64,
"type": "string"
},
"warning": {
"maxLength": 2000,
"type": [
"string",
"null"
]
}
},
"required": [],
"type": [
"object",
"null"
]
},
"visual_preferences": {
"maxLength": 2000,
"type": "string"
},
"visual_source": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"visual_warning": {
"maxLength": 2000,
"type": [
"string",
"null"
]
}
},
"type": "object"
}
},
{
"description": "Import the user's selected MP3 and prepare a free Quick draft with a price quote. In ChatGPT, use this native file-parameter route first: audio_file receives the real host-provided download_url and file_id, and this server downloads the file. Do not invent file references or choose raw sandbox upload merely because an attachment is readable; raw upload additionally requires supported outbound HTTPS PUT. No processing starts. Discuss the returned price and visual wishes in the conversation, without opening a card. Use only a file the user selected for this task.",
"inputSchema": {
"$defs": {
"OpenAIFile": {
"additionalProperties": false,
"properties": {
"download_url": {
"maxLength": 8192,
"minLength": 1,
"title": "Download Url",
"type": "string"
},
"file_id": {
"maxLength": 256,
"minLength": 1,
"title": "File Id",
"type": "string"
},
"file_name": {
"anyOf": [
{
"maxLength": 255,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "File Name"
},
"mime_type": {
"anyOf": [
{
"maxLength": 120,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mime Type"
}
},
"required": [
"download_url",
"file_id"
],
"title": "OpenAIFile",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"artist": {
"default": "",
"maxLength": 500,
"title": "Artist",
"type": "string"
},
"audio_file": {
"$ref": "#/$defs/OpenAIFile"
},
"idempotency_key": {
"maxLength": 255,
"minLength": 1,
"pattern": "^[^\\x00-\\x1f\\x7f]+$",
"title": "Idempotency Key",
"type": "string"
},
"language": {
"default": "auto",
"maxLength": 30,
"minLength": 1,
"title": "Language",
"type": "string"
},
"title": {
"default": "",
"maxLength": 500,
"title": "Title",
"type": "string"
}
},
"required": [
"audio_file",
"idempotency_key"
],
"title": "PrepareInput",
"type": "object"
},
"name": "prepare_karaoke",
"outputSchema": {
"additionalProperties": false,
"oneOf": [
{
"required": [
"project_id",
"project_revision",
"command_version",
"status",
"stage",
"quote",
"can_start",
"can_retry",
"can_cancel",
"can_handoff",
"preview_ready",
"needs_lyrics_review",
"can_replace_lyrics",
"can_update_visuals",
"progress",
"visual_preferences",
"visual",
"visual_source",
"visual_warning",
"error",
"lyrics_source",
"lyrics_search_outcome",
"lyrics_search_provider",
"demo_mode",
"project",
"studio_url",
"media"
]
},
{
"maxProperties": 1,
"properties": {
"error": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
},
"required": [
"error"
]
}
],
"properties": {
"can_cancel": {
"type": "boolean"
},
"can_handoff": {
"type": "boolean"
},
"can_replace_lyrics": {
"type": "boolean"
},
"can_retry": {
"type": "boolean"
},
"can_start": {
"type": "boolean"
},
"can_update_visuals": {
"type": "boolean"
},
"command_version": {
"minimum": 1,
"type": "integer"
},
"demo_mode": {
"type": [
"boolean",
"null"
]
},
"error": {
"anyOf": [
{
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
{
"type": "null"
}
]
},
"lyrics_search_outcome": {
"enum": [
null,
"not_requested",
"no_accepted_candidate",
"timeout",
"error",
"found"
]
},
"lyrics_search_provider": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"lyrics_source": {
"enum": [
null,
"user_supplied",
"search_result",
"asr_fallback",
"unknown"
]
},
"media": {
"additionalProperties": false,
"properties": {
"download_url": {
"format": "uri",
"maxLength": 8192,
"type": [
"string",
"null"
]
},
"expires_in": {
"maximum": 3600,
"minimum": 1,
"type": "integer"
},
"preview_url": {
"format": "uri",
"maxLength": 8192,
"type": [
"string",
"null"
]
}
},
"required": [
"preview_url",
"download_url",
"expires_in"
],
"type": "object"
},
"needs_lyrics_review": {
"type": "boolean"
},
"preview_ready": {
"type": "boolean"
},
"progress": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"elapsed_seconds": {
"minimum": 0,
"type": "integer"
},
"label": {
"maxLength": 200,
"type": "string"
},
"percent": {
"maximum": 100,
"minimum": 0,
"type": [
"number",
"null"
]
},
"phase": {
"maxLength": 80,
"type": "string"
},
"started_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
}
},
"required": [],
"type": [
"object",
"null"
]
},
"project": {
"additionalProperties": false,
"properties": {
"artist": {
"maxLength": 500,
"type": [
"string",
"null"
]
},
"duration_seconds": {
"exclusiveMinimum": 0,
"maximum": 600,
"type": [
"number",
"null"
]
},
"export_status": {
"maxLength": 40,
"type": [
"string",
"null"
]
},
"has_export": {
"type": [
"boolean",
"null"
]
},
"has_lyrics": {
"type": [
"boolean",
"null"
]
},
"id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"revision": {
"minimum": 1,
"type": [
"integer",
"null"
]
},
"title": {
"maxLength": 500,
"type": [
"string",
"null"
]
},
"visual_settings": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"aspect_ratio": {
"maxLength": 20,
"type": "string"
},
"background_blur": {
"maximum": 24,
"minimum": 0,
"type": "number"
},
"background_dimming": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"bouncing_ball": {
"type": "boolean"
},
"effect": {
"maxLength": 40,
"type": "string"
},
"effect_particle_size": {
"maximum": 2,
"minimum": 0.5,
"type": "number"
},
"effect_particle_speed": {
"maximum": 2.5,
"minimum": 0.25,
"type": "number"
},
"font_size": {
"maximum": 96,
"minimum": 24,
"type": "integer"
},
"highlight_color": {
"maxLength": 30,
"type": "string"
},
"line_presentation": {
"maxLength": 40,
"type": "string"
},
"lyric_x": {
"maximum": 0.95,
"minimum": 0.05,
"type": "number"
},
"lyric_y": {
"maximum": 0.95,
"minimum": 0.05,
"type": "number"
},
"text_backdrop_color": {
"maxLength": 30,
"type": "string"
},
"text_backdrop_height": {
"maximum": 1,
"minimum": 0.2,
"type": "number"
},
"text_backdrop_opacity": {
"maximum": 0.8,
"minimum": 0,
"type": "number"
},
"text_color": {
"maxLength": 30,
"type": "string"
}
},
"required": [],
"type": [
"object",
"null"
]
}
},
"required": [
"id",
"title",
"artist",
"duration_seconds",
"revision",
"has_export",
"has_lyrics",
"export_status",
"visual_settings"
],
"type": "object"
},
"project_id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"project_revision": {
"minimum": 1,
"type": "integer"
},
"quote": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"ai_background_included": {
"type": "boolean"
},
"amount_minor": {
"minimum": 0,
"type": "integer"
},
"currency": {
"maxLength": 12,
"minLength": 1,
"type": "string"
},
"duration_seconds": {
"exclusiveMinimum": 0,
"maximum": 600,
"type": "number"
},
"expires_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 32,
"pattern": "^[0-9a-f]{32}$",
"type": "string"
},
"pricing_version": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"id",
"amount_minor",
"currency",
"expires_at"
],
"type": "object"
},
"stage": {
"maxLength": 40,
"minLength": 1,
"type": "string"
},
"status": {
"maxLength": 40,
"minLength": 1,
"type": "string"
},
"studio_url": {
"format": "uri",
"maxLength": 8192,
"minLength": 1,
"type": "string"
},
"visual": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"effect": {
"maxLength": 32,
"type": "string"
},
"mood": {
"maxLength": 40,
"type": "string"
},
"palette": {
"maxLength": 32,
"type": "string"
},
"source": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"style_name": {
"maxLength": 64,
"type": "string"
},
"warning": {
"maxLength": 2000,
"type": [
"string",
"null"
]
}
},
"required": [],
"type": [
"object",
"null"
]
},
"visual_preferences": {
"maxLength": 2000,
"type": "string"
},
"visual_source": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"visual_warning": {
"maxLength": 2000,
"type": [
"string",
"null"
]
}
},
"type": "object"
}
},
{
"description": "Refresh an expired, unstarted project's quote and status. Show the returned terms before starting. Does not reserve funds or launch processing.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"project_id": {
"maxLength": 64,
"minLength": 1,
"pattern": "^[a-z0-9][a-z0-9_-]*$",
"title": "Project Id",
"type": "string"
}
},
"required": [
"project_id"
],
"title": "ProjectInput",
"type": "object"
},
"name": "refresh_karaoke_quote",
"outputSchema": {
"additionalProperties": false,
"oneOf": [
{
"required": [
"project_id",
"project_revision",
"command_version",
"status",
"stage",
"quote",
"can_start",
"can_retry",
"can_cancel",
"can_handoff",
"preview_ready",
"needs_lyrics_review",
"can_replace_lyrics",
"can_update_visuals",
"progress",
"visual_preferences",
"visual",
"visual_source",
"visual_warning",
"error",
"lyrics_source",
"lyrics_search_outcome",
"lyrics_search_provider",
"demo_mode",
"project",
"studio_url",
"media"
]
},
{
"maxProperties": 1,
"properties": {
"error": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
},
"required": [
"error"
]
}
],
"properties": {
"can_cancel": {
"type": "boolean"
},
"can_handoff": {
"type": "boolean"
},
"can_replace_lyrics": {
"type": "boolean"
},
"can_retry": {
"type": "boolean"
},
"can_start": {
"type": "boolean"
},
"can_update_visuals": {
"type": "boolean"
},
"command_version": {
"minimum": 1,
"type": "integer"
},
"demo_mode": {
"type": [
"boolean",
"null"
]
},
"error": {
"anyOf": [
{
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
{
"type": "null"
}
]
},
"lyrics_search_outcome": {
"enum": [
null,
"not_requested",
"no_accepted_candidate",
"timeout",
"error",
"found"
]
},
"lyrics_search_provider": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"lyrics_source": {
"enum": [
null,
"user_supplied",
"search_result",
"asr_fallback",
"unknown"
]
},
"media": {
"additionalProperties": false,
"properties": {
"download_url": {
"format": "uri",
"maxLength": 8192,
"type": [
"string",
"null"
]
},
"expires_in": {
"maximum": 3600,
"minimum": 1,
"type": "integer"
},
"preview_url": {
"format": "uri",
"maxLength": 8192,
"type": [
"string",
"null"
]
}
},
"required": [
"preview_url",
"download_url",
"expires_in"
],
"type": "object"
},
"needs_lyrics_review": {
"type": "boolean"
},
"preview_ready": {
"type": "boolean"
},
"progress": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"elapsed_seconds": {
"minimum": 0,
"type": "integer"
},
"label": {
"maxLength": 200,
"type": "string"
},
"percent": {
"maximum": 100,
"minimum": 0,
"type": [
"number",
"null"
]
},
"phase": {
"maxLength": 80,
"type": "string"
},
"started_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
}
},
"required": [],
"type": [
"object",
"null"
]
},
"project": {
"additionalProperties": false,
"properties": {
"artist": {
"maxLength": 500,
"type": [
"string",
"null"
]
},
"duration_seconds": {
"exclusiveMinimum": 0,
"maximum": 600,
"type": [
"number",
"null"
]
},
"export_status": {
"maxLength": 40,
"type": [
"string",
"null"
]
},
"has_export": {
"type": [
"boolean",
"null"
]
},
"has_lyrics": {
"type": [
"boolean",
"null"
]
},
"id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"revision": {
"minimum": 1,
"type": [
"integer",
"null"
]
},
"title": {
"maxLength": 500,
"type": [
"string",
"null"
]
},
"visual_settings": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"aspect_ratio": {
"maxLength": 20,
"type": "string"
},
"background_blur": {
"maximum": 24,
"minimum": 0,
"type": "number"
},
"background_dimming": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"bouncing_ball": {
"type": "boolean"
},
"effect": {
"maxLength": 40,
"type": "string"
},
"effect_particle_size": {
"maximum": 2,
"minimum": 0.5,
"type": "number"
},
"effect_particle_speed": {
"maximum": 2.5,
"minimum": 0.25,
"type": "number"
},
"font_size": {
"maximum": 96,
"minimum": 24,
"type": "integer"
},
"highlight_color": {
"maxLength": 30,
"type": "string"
},
"line_presentation": {
"maxLength": 40,
"type": "string"
},
"lyric_x": {
"maximum": 0.95,
"minimum": 0.05,
"type": "number"
},
"lyric_y": {
"maximum": 0.95,
"minimum": 0.05,
"type": "number"
},
"text_backdrop_color": {
"maxLength": 30,
"type": "string"
},
"text_backdrop_height": {
"maximum": 1,
"minimum": 0.2,
"type": "number"
},
"text_backdrop_opacity": {
"maximum": 0.8,
"minimum": 0,
"type": "number"
},
"text_color": {
"maxLength": 30,
"type": "string"
}
},
"required": [],
"type": [
"object",
"null"
]
}
},
"required": [
"id",
"title",
"artist",
"duration_seconds",
"revision",
"has_export",
"has_lyrics",
"export_status",
"visual_settings"
],
"type": "object"
},
"project_id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"project_revision": {
"minimum": 1,
"type": "integer"
},
"quote": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"ai_background_included": {
"type": "boolean"
},
"amount_minor": {
"minimum": 0,
"type": "integer"
},
"currency": {
"maxLength": 12,
"minLength": 1,
"type": "string"
},
"duration_seconds": {
"exclusiveMinimum": 0,
"maximum": 600,
"type": "number"
},
"expires_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 32,
"pattern": "^[0-9a-f]{32}$",
"type": "string"
},
"pricing_version": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"id",
"amount_minor",
"currency",
"expires_at"
],
"type": "object"
},
"stage": {
"maxLength": 40,
"minLength": 1,
"type": "string"
},
"status": {
"maxLength": 40,
"minLength": 1,
"type": "string"
},
"studio_url": {
"format": "uri",
"maxLength": 8192,
"minLength": 1,
"type": "string"
},
"visual": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"effect": {
"maxLength": 32,
"type": "string"
},
"mood": {
"maxLength": 40,
"type": "string"
},
"palette": {
"maxLength": 32,
"type": "string"
},
"source": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"style_name": {
"maxLength": 64,
"type": "string"
},
"warning": {
"maxLength": 2000,
"type": [
"string",
"null"
]
}
},
"required": [],
"type": [
"object",
"null"
]
},
"visual_preferences": {
"maxLength": 2000,
"type": "string"
},
"visual_source": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"visual_warning": {
"maxLength": 2000,
"type": [
"string",
"null"
]
}
},
"type": "object"
}
},
{
"description": "Save only the complete replacement lyrics explicitly supplied or approved by the user. Preserves the same project. An unstarted or unprepared review draft is saved without starting or charging; discuss any returned fresh quote before start_karaoke. An already prepared project uses Studio's full realignment and retains its current version until success. Use the current revision and reuse the same command key after a lost response. Never treat an unverified ASR draft or invented words as user-approved lyrics. Discuss progress in chat.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"expected_revision": {
"minimum": 1,
"title": "Expected Revision",
"type": "integer"
},
"idempotency_key": {
"maxLength": 255,
"minLength": 1,
"pattern": "^[^\\x00-\\x1f\\x7f]+$",
"title": "Idempotency Key",
"type": "string"
},
"lyrics": {
"maxLength": 65536,
"minLength": 1,
"title": "Lyrics",
"type": "string"
},
"project_id": {
"maxLength": 64,
"minLength": 1,
"pattern": "^[a-z0-9][a-z0-9_-]*$",
"title": "Project Id",
"type": "string"
}
},
"required": [
"project_id",
"expected_revision",
"idempotency_key",
"lyrics"
],
"title": "LyricsReplaceInput",
"type": "object"
},
"name": "replace_karaoke_lyrics",
"outputSchema": {
"additionalProperties": false,
"oneOf": [
{
"required": [
"project_id",
"project_revision",
"command_version",
"status",
"stage",
"quote",
"can_start",
"can_retry",
"can_cancel",
"can_handoff",
"preview_ready",
"needs_lyrics_review",
"can_replace_lyrics",
"can_update_visuals",
"progress",
"visual_preferences",
"visual",
"visual_source",
"visual_warning",
"error",
"lyrics_source",
"lyrics_search_outcome",
"lyrics_search_provider",
"demo_mode",
"project",
"studio_url",
"media"
]
},
{
"maxProperties": 1,
"properties": {
"error": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
},
"required": [
"error"
]
}
],
"properties": {
"can_cancel": {
"type": "boolean"
},
"can_handoff": {
"type": "boolean"
},
"can_replace_lyrics": {
"type": "boolean"
},
"can_retry": {
"type": "boolean"
},
"can_start": {
"type": "boolean"
},
"can_update_visuals": {
"type": "boolean"
},
"command_version": {
"minimum": 1,
"type": "integer"
},
"demo_mode": {
"type": [
"boolean",
"null"
]
},
"error": {
"anyOf": [
{
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
{
"type": "null"
}
]
},
"lyrics_search_outcome": {
"enum": [
null,
"not_requested",
"no_accepted_candidate",
"timeout",
"error",
"found"
]
},
"lyrics_search_provider": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"lyrics_source": {
"enum": [
null,
"user_supplied",
"search_result",
"asr_fallback",
"unknown"
]
},
"media": {
"additionalProperties": false,
"properties": {
"download_url": {
"format": "uri",
"maxLength": 8192,
"type": [
"string",
"null"
]
},
"expires_in": {
"maximum": 3600,
"minimum": 1,
"type": "integer"
},
"preview_url": {
"format": "uri",
"maxLength": 8192,
"type": [
"string",
"null"
]
}
},
"required": [
"preview_url",
"download_url",
"expires_in"
],
"type": "object"
},
"needs_lyrics_review": {
"type": "boolean"
},
"preview_ready": {
"type": "boolean"
},
"progress": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"elapsed_seconds": {
"minimum": 0,
"type": "integer"
},
"label": {
"maxLength": 200,
"type": "string"
},
"percent": {
"maximum": 100,
"minimum": 0,
"type": [
"number",
"null"
]
},
"phase": {
"maxLength": 80,
"type": "string"
},
"started_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
}
},
"required": [],
"type": [
"object",
"null"
]
},
"project": {
"additionalProperties": false,
"properties": {
"artist": {
"maxLength": 500,
"type": [
"string",
"null"
]
},
"duration_seconds": {
"exclusiveMinimum": 0,
"maximum": 600,
"type": [
"number",
"null"
]
},
"export_status": {
"maxLength": 40,
"type": [
"string",
"null"
]
},
"has_export": {
"type": [
"boolean",
"null"
]
},
"has_lyrics": {
"type": [
"boolean",
"null"
]
},
"id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"revision": {
"minimum": 1,
"type": [
"integer",
"null"
]
},
"title": {
"maxLength": 500,
"type": [
"string",
"null"
]
},
"visual_settings": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"aspect_ratio": {
"maxLength": 20,
"type": "string"
},
"background_blur": {
"maximum": 24,
"minimum": 0,
"type": "number"
},
"background_dimming": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"bouncing_ball": {
"type": "boolean"
},
"effect": {
"maxLength": 40,
"type": "string"
},
"effect_particle_size": {
"maximum": 2,
"minimum": 0.5,
"type": "number"
},
"effect_particle_speed": {
"maximum": 2.5,
"minimum": 0.25,
"type": "number"
},
"font_size": {
"maximum": 96,
"minimum": 24,
"type": "integer"
},
"highlight_color": {
"maxLength": 30,
"type": "string"
},
"line_presentation": {
"maxLength": 40,
"type": "string"
},
"lyric_x": {
"maximum": 0.95,
"minimum": 0.05,
"type": "number"
},
"lyric_y": {
"maximum": 0.95,
"minimum": 0.05,
"type": "number"
},
"text_backdrop_color": {
"maxLength": 30,
"type": "string"
},
"text_backdrop_height": {
"maximum": 1,
"minimum": 0.2,
"type": "number"
},
"text_backdrop_opacity": {
"maximum": 0.8,
"minimum": 0,
"type": "number"
},
"text_color": {
"maxLength": 30,
"type": "string"
}
},
"required": [],
"type": [
"object",
"null"
]
}
},
"required": [
"id",
"title",
"artist",
"duration_seconds",
"revision",
"has_export",
"has_lyrics",
"export_status",
"visual_settings"
],
"type": "object"
},
"project_id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"project_revision": {
"minimum": 1,
"type": "integer"
},
"quote": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"ai_background_included": {
"type": "boolean"
},
"amount_minor": {
"minimum": 0,
"type": "integer"
},
"currency": {
"maxLength": 12,
"minLength": 1,
"type": "string"
},
"duration_seconds": {
"exclusiveMinimum": 0,
"maximum": 600,
"type": "number"
},
"expires_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 32,
"pattern": "^[0-9a-f]{32}$",
"type": "string"
},
"pricing_version": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"id",
"amount_minor",
"currency",
"expires_at"
],
"type": "object"
},
"stage": {
"maxLength": 40,
"minLength": 1,
"type": "string"
},
"status": {
"maxLength": 40,
"minLength": 1,
"type": "string"
},
"studio_url": {
"format": "uri",
"maxLength": 8192,
"minLength": 1,
"type": "string"
},
"visual": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"effect": {
"maxLength": 32,
"type": "string"
},
"mood": {
"maxLength": 40,
"type": "string"
},
"palette": {
"maxLength": 32,
"type": "string"
},
"source": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"style_name": {
"maxLength": 64,
"type": "string"
},
"warning": {
"maxLength": 2000,
"type": [
"string",
"null"
]
}
},
"required": [],
"type": [
"object",
"null"
]
},
"visual_preferences": {
"maxLength": 2000,
"type": "string"
},
"visual_source": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"visual_warning": {
"maxLength": 2000,
"type": [
"string",
"null"
]
}
},
"type": "object"
}
},
{
"description": "Retry a failed or stale Quick stage only when can_retry is true. Keeps the existing project, saved visual preferences and completed stages. This does not request a new creative design.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"expected_revision": {
"minimum": 1,
"title": "Expected Revision",
"type": "integer"
},
"idempotency_key": {
"maxLength": 255,
"minLength": 1,
"pattern": "^[^\\x00-\\x1f\\x7f]+$",
"title": "Idempotency Key",
"type": "string"
},
"project_id": {
"maxLength": 64,
"minLength": 1,
"pattern": "^[a-z0-9][a-z0-9_-]*$",
"title": "Project Id",
"type": "string"
}
},
"required": [
"project_id",
"expected_revision",
"idempotency_key"
],
"title": "CommandInput",
"type": "object"
},
"name": "retry_karaoke",
"outputSchema": {
"additionalProperties": false,
"oneOf": [
{
"required": [
"project_id",
"project_revision",
"command_version",
"status",
"stage",
"quote",
"can_start",
"can_retry",
"can_cancel",
"can_handoff",
"preview_ready",
"needs_lyrics_review",
"can_replace_lyrics",
"can_update_visuals",
"progress",
"visual_preferences",
"visual",
"visual_source",
"visual_warning",
"error",
"lyrics_source",
"lyrics_search_outcome",
"lyrics_search_provider",
"demo_mode",
"project",
"studio_url",
"media"
]
},
{
"maxProperties": 1,
"properties": {
"error": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
},
"required": [
"error"
]
}
],
"properties": {
"can_cancel": {
"type": "boolean"
},
"can_handoff": {
"type": "boolean"
},
"can_replace_lyrics": {
"type": "boolean"
},
"can_retry": {
"type": "boolean"
},
"can_start": {
"type": "boolean"
},
"can_update_visuals": {
"type": "boolean"
},
"command_version": {
"minimum": 1,
"type": "integer"
},
"demo_mode": {
"type": [
"boolean",
"null"
]
},
"error": {
"anyOf": [
{
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
{
"type": "null"
}
]
},
"lyrics_search_outcome": {
"enum": [
null,
"not_requested",
"no_accepted_candidate",
"timeout",
"error",
"found"
]
},
"lyrics_search_provider": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"lyrics_source": {
"enum": [
null,
"user_supplied",
"search_result",
"asr_fallback",
"unknown"
]
},
"media": {
"additionalProperties": false,
"properties": {
"download_url": {
"format": "uri",
"maxLength": 8192,
"type": [
"string",
"null"
]
},
"expires_in": {
"maximum": 3600,
"minimum": 1,
"type": "integer"
},
"preview_url": {
"format": "uri",
"maxLength": 8192,
"type": [
"string",
"null"
]
}
},
"required": [
"preview_url",
"download_url",
"expires_in"
],
"type": "object"
},
"needs_lyrics_review": {
"type": "boolean"
},
"preview_ready": {
"type": "boolean"
},
"progress": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"elapsed_seconds": {
"minimum": 0,
"type": "integer"
},
"label": {
"maxLength": 200,
"type": "string"
},
"percent": {
"maximum": 100,
"minimum": 0,
"type": [
"number",
"null"
]
},
"phase": {
"maxLength": 80,
"type": "string"
},
"started_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
}
},
"required": [],
"type": [
"object",
"null"
]
},
"project": {
"additionalProperties": false,
"properties": {
"artist": {
"maxLength": 500,
"type": [
"string",
"null"
]
},
"duration_seconds": {
"exclusiveMinimum": 0,
"maximum": 600,
"type": [
"number",
"null"
]
},
"export_status": {
"maxLength": 40,
"type": [
"string",
"null"
]
},
"has_export": {
"type": [
"boolean",
"null"
]
},
"has_lyrics": {
"type": [
"boolean",
"null"
]
},
"id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"revision": {
"minimum": 1,
"type": [
"integer",
"null"
]
},
"title": {
"maxLength": 500,
"type": [
"string",
"null"
]
},
"visual_settings": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"aspect_ratio": {
"maxLength": 20,
"type": "string"
},
"background_blur": {
"maximum": 24,
"minimum": 0,
"type": "number"
},
"background_dimming": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"bouncing_ball": {
"type": "boolean"
},
"effect": {
"maxLength": 40,
"type": "string"
},
"effect_particle_size": {
"maximum": 2,
"minimum": 0.5,
"type": "number"
},
"effect_particle_speed": {
"maximum": 2.5,
"minimum": 0.25,
"type": "number"
},
"font_size": {
"maximum": 96,
"minimum": 24,
"type": "integer"
},
"highlight_color": {
"maxLength": 30,
"type": "string"
},
"line_presentation": {
"maxLength": 40,
"type": "string"
},
"lyric_x": {
"maximum": 0.95,
"minimum": 0.05,
"type": "number"
},
"lyric_y": {
"maximum": 0.95,
"minimum": 0.05,
"type": "number"
},
"text_backdrop_color": {
"maxLength": 30,
"type": "string"
},
"text_backdrop_height": {
"maximum": 1,
"minimum": 0.2,
"type": "number"
},
"text_backdrop_opacity": {
"maximum": 0.8,
"minimum": 0,
"type": "number"
},
"text_color": {
"maxLength": 30,
"type": "string"
}
},
"required": [],
"type": [
"object",
"null"
]
}
},
"required": [
"id",
"title",
"artist",
"duration_seconds",
"revision",
"has_export",
"has_lyrics",
"export_status",
"visual_settings"
],
"type": "object"
},
"project_id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"project_revision": {
"minimum": 1,
"type": "integer"
},
"quote": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"ai_background_included": {
"type": "boolean"
},
"amount_minor": {
"minimum": 0,
"type": "integer"
},
"currency": {
"maxLength": 12,
"minLength": 1,
"type": "string"
},
"duration_seconds": {
"exclusiveMinimum": 0,
"maximum": 600,
"type": "number"
},
"expires_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 32,
"pattern": "^[0-9a-f]{32}$",
"type": "string"
},
"pricing_version": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"id",
"amount_minor",
"currency",
"expires_at"
],
"type": "object"
},
"stage": {
"maxLength": 40,
"minLength": 1,
"type": "string"
},
"status": {
"maxLength": 40,
"minLength": 1,
"type": "string"
},
"studio_url": {
"format": "uri",
"maxLength": 8192,
"minLength": 1,
"type": "string"
},
"visual": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"effect": {
"maxLength": 32,
"type": "string"
},
"mood": {
"maxLength": 40,
"type": "string"
},
"palette": {
"maxLength": 32,
"type": "string"
},
"source": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"style_name": {
"maxLength": 64,
"type": "string"
},
"warning": {
"maxLength": 2000,
"type": [
"string",
"null"
]
}
},
"required": [],
"type": [
"object",
"null"
]
},
"visual_preferences": {
"maxLength": 2000,
"type": "string"
},
"visual_source": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"visual_warning": {
"maxLength": 2000,
"type": [
"string",
"null"
]
}
},
"type": "object"
}
},
{
"description": "Display only the finished karaoke MP4 preview and download. First call get_karaoke and verify ready/handed_off, project.has_export=true, project.export_status=ready and no lyrics review. Never use this for upload, a price quote, confirmation, processing or errors: handle those in the conversation. Omit visual_preferences; the legacy optional field cannot change a saved design. Does not start processing.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"project_id": {
"maxLength": 64,
"minLength": 1,
"pattern": "^[a-z0-9][a-z0-9_-]*$",
"title": "Project Id",
"type": "string"
},
"visual_preferences": {
"anyOf": [
{
"maxLength": 2000,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Visual Preferences"
}
},
"required": [
"project_id"
],
"title": "ShowInput",
"type": "object"
},
"name": "show_karaoke",
"outputSchema": {
"additionalProperties": false,
"oneOf": [
{
"required": [
"project_id",
"project_revision",
"command_version",
"status",
"stage",
"quote",
"can_start",
"can_retry",
"can_cancel",
"can_handoff",
"preview_ready",
"needs_lyrics_review",
"can_replace_lyrics",
"can_update_visuals",
"progress",
"visual_preferences",
"visual",
"visual_source",
"visual_warning",
"error",
"lyrics_source",
"lyrics_search_outcome",
"lyrics_search_provider",
"demo_mode",
"project",
"studio_url",
"media"
]
},
{
"maxProperties": 1,
"properties": {
"error": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
},
"required": [
"error"
]
}
],
"properties": {
"can_cancel": {
"type": "boolean"
},
"can_handoff": {
"type": "boolean"
},
"can_replace_lyrics": {
"type": "boolean"
},
"can_retry": {
"type": "boolean"
},
"can_start": {
"type": "boolean"
},
"can_update_visuals": {
"type": "boolean"
},
"command_version": {
"minimum": 1,
"type": "integer"
},
"demo_mode": {
"type": [
"boolean",
"null"
]
},
"error": {
"anyOf": [
{
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
{
"type": "null"
}
]
},
"lyrics_search_outcome": {
"enum": [
null,
"not_requested",
"no_accepted_candidate",
"timeout",
"error",
"found"
]
},
"lyrics_search_provider": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"lyrics_source": {
"enum": [
null,
"user_supplied",
"search_result",
"asr_fallback",
"unknown"
]
},
"media": {
"additionalProperties": false,
"properties": {
"download_url": {
"format": "uri",
"maxLength": 8192,
"type": [
"string",
"null"
]
},
"expires_in": {
"maximum": 3600,
"minimum": 1,
"type": "integer"
},
"preview_url": {
"format": "uri",
"maxLength": 8192,
"type": [
"string",
"null"
]
}
},
"required": [
"preview_url",
"download_url",
"expires_in"
],
"type": "object"
},
"needs_lyrics_review": {
"type": "boolean"
},
"presentation_visual_preferences": {
"maxLength": 2000,
"type": "string"
},
"preview_ready": {
"type": "boolean"
},
"progress": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"elapsed_seconds": {
"minimum": 0,
"type": "integer"
},
"label": {
"maxLength": 200,
"type": "string"
},
"percent": {
"maximum": 100,
"minimum": 0,
"type": [
"number",
"null"
]
},
"phase": {
"maxLength": 80,
"type": "string"
},
"started_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
}
},
"required": [],
"type": [
"object",
"null"
]
},
"project": {
"additionalProperties": false,
"properties": {
"artist": {
"maxLength": 500,
"type": [
"string",
"null"
]
},
"duration_seconds": {
"exclusiveMinimum": 0,
"maximum": 600,
"type": [
"number",
"null"
]
},
"export_status": {
"maxLength": 40,
"type": [
"string",
"null"
]
},
"has_export": {
"type": [
"boolean",
"null"
]
},
"has_lyrics": {
"type": [
"boolean",
"null"
]
},
"id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"revision": {
"minimum": 1,
"type": [
"integer",
"null"
]
},
"title": {
"maxLength": 500,
"type": [
"string",
"null"
]
},
"visual_settings": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"aspect_ratio": {
"maxLength": 20,
"type": "string"
},
"background_blur": {
"maximum": 24,
"minimum": 0,
"type": "number"
},
"background_dimming": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"bouncing_ball": {
"type": "boolean"
},
"effect": {
"maxLength": 40,
"type": "string"
},
"effect_particle_size": {
"maximum": 2,
"minimum": 0.5,
"type": "number"
},
"effect_particle_speed": {
"maximum": 2.5,
"minimum": 0.25,
"type": "number"
},
"font_size": {
"maximum": 96,
"minimum": 24,
"type": "integer"
},
"highlight_color": {
"maxLength": 30,
"type": "string"
},
"line_presentation": {
"maxLength": 40,
"type": "string"
},
"lyric_x": {
"maximum": 0.95,
"minimum": 0.05,
"type": "number"
},
"lyric_y": {
"maximum": 0.95,
"minimum": 0.05,
"type": "number"
},
"text_backdrop_color": {
"maxLength": 30,
"type": "string"
},
"text_backdrop_height": {
"maximum": 1,
"minimum": 0.2,
"type": "number"
},
"text_backdrop_opacity": {
"maximum": 0.8,
"minimum": 0,
"type": "number"
},
"text_color": {
"maxLength": 30,
"type": "string"
}
},
"required": [],
"type": [
"object",
"null"
]
}
},
"required": [
"id",
"title",
"artist",
"duration_seconds",
"revision",
"has_export",
"has_lyrics",
"export_status",
"visual_settings"
],
"type": "object"
},
"project_id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"project_revision": {
"minimum": 1,
"type": "integer"
},
"quote": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"ai_background_included": {
"type": "boolean"
},
"amount_minor": {
"minimum": 0,
"type": "integer"
},
"currency": {
"maxLength": 12,
"minLength": 1,
"type": "string"
},
"duration_seconds": {
"exclusiveMinimum": 0,
"maximum": 600,
"type": "number"
},
"expires_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 32,
"pattern": "^[0-9a-f]{32}$",
"type": "string"
},
"pricing_version": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"id",
"amount_minor",
"currency",
"expires_at"
],
"type": "object"
},
"stage": {
"maxLength": 40,
"minLength": 1,
"type": "string"
},
"status": {
"maxLength": 40,
"minLength": 1,
"type": "string"
},
"studio_url": {
"format": "uri",
"maxLength": 8192,
"minLength": 1,
"type": "string"
},
"visual": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"effect": {
"maxLength": 32,
"type": "string"
},
"mood": {
"maxLength": 40,
"type": "string"
},
"palette": {
"maxLength": 32,
"type": "string"
},
"source": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"style_name": {
"maxLength": 64,
"type": "string"
},
"warning": {
"maxLength": 2000,
"type": [
"string",
"null"
]
}
},
"required": [],
"type": [
"object",
"null"
]
},
"visual_preferences": {
"maxLength": 2000,
"type": "string"
},
"visual_source": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"visual_warning": {
"maxLength": 2000,
"type": [
"string",
"null"
]
}
},
"type": "object"
}
},
{
"description": "Start the quoted Quick karaoke only after the user explicitly confirms its current price and visual preferences in the conversation. Reserves the existing account balance and launches background processing. Use the current quote and revision; reuse the same key after a lost response. After starting, continue monitoring this same project with get_karaoke in the current turn until a current ready MP4, failure, cancellation or required lyrics correction. Do not finish with only a launch receipt or ask the user to request another status check. Report meaningful progress in chat; open show_karaoke only when the current MP4 is ready.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"expected_revision": {
"minimum": 1,
"title": "Expected Revision",
"type": "integer"
},
"idempotency_key": {
"maxLength": 255,
"minLength": 1,
"pattern": "^[^\\x00-\\x1f\\x7f]+$",
"title": "Idempotency Key",
"type": "string"
},
"project_id": {
"maxLength": 64,
"minLength": 1,
"pattern": "^[a-z0-9][a-z0-9_-]*$",
"title": "Project Id",
"type": "string"
},
"quote_id": {
"pattern": "^[0-9a-f]{32}$",
"title": "Quote Id",
"type": "string"
},
"visual_preferences": {
"default": "",
"maxLength": 2000,
"title": "Visual Preferences",
"type": "string"
}
},
"required": [
"project_id",
"expected_revision",
"idempotency_key",
"quote_id"
],
"title": "StartInput",
"type": "object"
},
"name": "start_karaoke",
"outputSchema": {
"additionalProperties": false,
"oneOf": [
{
"required": [
"project_id",
"project_revision",
"command_version",
"status",
"stage",
"quote",
"can_start",
"can_retry",
"can_cancel",
"can_handoff",
"preview_ready",
"needs_lyrics_review",
"can_replace_lyrics",
"can_update_visuals",
"progress",
"visual_preferences",
"visual",
"visual_source",
"visual_warning",
"error",
"lyrics_source",
"lyrics_search_outcome",
"lyrics_search_provider",
"demo_mode",
"project",
"studio_url",
"media"
]
},
{
"maxProperties": 1,
"properties": {
"error": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
},
"required": [
"error"
]
}
],
"properties": {
"can_cancel": {
"type": "boolean"
},
"can_handoff": {
"type": "boolean"
},
"can_replace_lyrics": {
"type": "boolean"
},
"can_retry": {
"type": "boolean"
},
"can_start": {
"type": "boolean"
},
"can_update_visuals": {
"type": "boolean"
},
"command_version": {
"minimum": 1,
"type": "integer"
},
"demo_mode": {
"type": [
"boolean",
"null"
]
},
"error": {
"anyOf": [
{
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
{
"type": "null"
}
]
},
"lyrics_search_outcome": {
"enum": [
null,
"not_requested",
"no_accepted_candidate",
"timeout",
"error",
"found"
]
},
"lyrics_search_provider": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"lyrics_source": {
"enum": [
null,
"user_supplied",
"search_result",
"asr_fallback",
"unknown"
]
},
"media": {
"additionalProperties": false,
"properties": {
"download_url": {
"format": "uri",
"maxLength": 8192,
"type": [
"string",
"null"
]
},
"expires_in": {
"maximum": 3600,
"minimum": 1,
"type": "integer"
},
"preview_url": {
"format": "uri",
"maxLength": 8192,
"type": [
"string",
"null"
]
}
},
"required": [
"preview_url",
"download_url",
"expires_in"
],
"type": "object"
},
"needs_lyrics_review": {
"type": "boolean"
},
"preview_ready": {
"type": "boolean"
},
"progress": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"elapsed_seconds": {
"minimum": 0,
"type": "integer"
},
"label": {
"maxLength": 200,
"type": "string"
},
"percent": {
"maximum": 100,
"minimum": 0,
"type": [
"number",
"null"
]
},
"phase": {
"maxLength": 80,
"type": "string"
},
"started_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
}
},
"required": [],
"type": [
"object",
"null"
]
},
"project": {
"additionalProperties": false,
"properties": {
"artist": {
"maxLength": 500,
"type": [
"string",
"null"
]
},
"duration_seconds": {
"exclusiveMinimum": 0,
"maximum": 600,
"type": [
"number",
"null"
]
},
"export_status": {
"maxLength": 40,
"type": [
"string",
"null"
]
},
"has_export": {
"type": [
"boolean",
"null"
]
},
"has_lyrics": {
"type": [
"boolean",
"null"
]
},
"id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"revision": {
"minimum": 1,
"type": [
"integer",
"null"
]
},
"title": {
"maxLength": 500,
"type": [
"string",
"null"
]
},
"visual_settings": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"aspect_ratio": {
"maxLength": 20,
"type": "string"
},
"background_blur": {
"maximum": 24,
"minimum": 0,
"type": "number"
},
"background_dimming": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"bouncing_ball": {
"type": "boolean"
},
"effect": {
"maxLength": 40,
"type": "string"
},
"effect_particle_size": {
"maximum": 2,
"minimum": 0.5,
"type": "number"
},
"effect_particle_speed": {
"maximum": 2.5,
"minimum": 0.25,
"type": "number"
},
"font_size": {
"maximum": 96,
"minimum": 24,
"type": "integer"
},
"highlight_color": {
"maxLength": 30,
"type": "string"
},
"line_presentation": {
"maxLength": 40,
"type": "string"
},
"lyric_x": {
"maximum": 0.95,
"minimum": 0.05,
"type": "number"
},
"lyric_y": {
"maximum": 0.95,
"minimum": 0.05,
"type": "number"
},
"text_backdrop_color": {
"maxLength": 30,
"type": "string"
},
"text_backdrop_height": {
"maximum": 1,
"minimum": 0.2,
"type": "number"
},
"text_backdrop_opacity": {
"maximum": 0.8,
"minimum": 0,
"type": "number"
},
"text_color": {
"maxLength": 30,
"type": "string"
}
},
"required": [],
"type": [
"object",
"null"
]
}
},
"required": [
"id",
"title",
"artist",
"duration_seconds",
"revision",
"has_export",
"has_lyrics",
"export_status",
"visual_settings"
],
"type": "object"
},
"project_id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"project_revision": {
"minimum": 1,
"type": "integer"
},
"quote": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"ai_background_included": {
"type": "boolean"
},
"amount_minor": {
"minimum": 0,
"type": "integer"
},
"currency": {
"maxLength": 12,
"minLength": 1,
"type": "string"
},
"duration_seconds": {
"exclusiveMinimum": 0,
"maximum": 600,
"type": "number"
},
"expires_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 32,
"pattern": "^[0-9a-f]{32}$",
"type": "string"
},
"pricing_version": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"id",
"amount_minor",
"currency",
"expires_at"
],
"type": "object"
},
"stage": {
"maxLength": 40,
"minLength": 1,
"type": "string"
},
"status": {
"maxLength": 40,
"minLength": 1,
"type": "string"
},
"studio_url": {
"format": "uri",
"maxLength": 8192,
"minLength": 1,
"type": "string"
},
"visual": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"effect": {
"maxLength": 32,
"type": "string"
},
"mood": {
"maxLength": 40,
"type": "string"
},
"palette": {
"maxLength": 32,
"type": "string"
},
"source": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"style_name": {
"maxLength": 64,
"type": "string"
},
"warning": {
"maxLength": 2000,
"type": [
"string",
"null"
]
}
},
"required": [],
"type": [
"object",
"null"
]
},
"visual_preferences": {
"maxLength": 2000,
"type": "string"
},
"visual_source": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"visual_warning": {
"maxLength": 2000,
"type": [
"string",
"null"
]
}
},
"type": "object"
}
},
{
"description": "Apply the user's selected PNG, JPEG or WebP background and/or supported visual settings to this same project. A draft is saved without starting; a prepared project rebuilds only the MP4, reusing its music and timing. Import only a file the user selected for this task; a ChatGPT-generated image must have an actual host-provided file reference. Do not invent image URLs. This does not generate a new background or rerun audio alignment. Use the current revision and the same key after a lost response. Discuss changes in chat; display show_karaoke only when the new MP4 is ready.",
"inputSchema": {
"$defs": {
"OpenAIFile": {
"additionalProperties": false,
"properties": {
"download_url": {
"maxLength": 8192,
"minLength": 1,
"title": "Download Url",
"type": "string"
},
"file_id": {
"maxLength": 256,
"minLength": 1,
"title": "File Id",
"type": "string"
},
"file_name": {
"anyOf": [
{
"maxLength": 255,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "File Name"
},
"mime_type": {
"anyOf": [
{
"maxLength": 120,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mime Type"
}
},
"required": [
"download_url",
"file_id"
],
"title": "OpenAIFile",
"type": "object"
},
"VisualSettingsPatch": {
"additionalProperties": false,
"properties": {
"aspect_ratio": {
"anyOf": [
{
"enum": [
"16:9",
"9:16",
"4:3",
"16:10"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Aspect Ratio"
},
"background_blur": {
"anyOf": [
{
"maximum": 24,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Background Blur"
},
"background_dimming": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Background Dimming"
},
"bouncing_ball": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Bouncing Ball"
},
"effect": {
"anyOf": [
{
"enum": [
"none",
"dust",
"snow",
"sparks",
"stars",
"rain"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Effect"
},
"font_size": {
"anyOf": [
{
"maximum": 96,
"minimum": 24,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Font Size"
},
"highlight_color": {
"anyOf": [
{
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Highlight Color"
},
"line_presentation": {
"anyOf": [
{
"enum": [
"smooth_scroll",
"alternating_lines"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Line Presentation"
},
"text_color": {
"anyOf": [
{
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Text Color"
}
},
"title": "VisualSettingsPatch",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"background_file": {
"$ref": "#/$defs/OpenAIFile"
},
"expected_revision": {
"minimum": 1,
"title": "Expected Revision",
"type": "integer"
},
"idempotency_key": {
"maxLength": 255,
"minLength": 1,
"pattern": "^[^\\x00-\\x1f\\x7f]+$",
"title": "Idempotency Key",
"type": "string"
},
"project_id": {
"maxLength": 64,
"minLength": 1,
"pattern": "^[a-z0-9][a-z0-9_-]*$",
"title": "Project Id",
"type": "string"
},
"visual_settings": {
"anyOf": [
{
"$ref": "#/$defs/VisualSettingsPatch"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"project_id",
"expected_revision",
"idempotency_key"
],
"title": "VisualUpdateInput",
"type": "object"
},
"name": "update_karaoke_visuals",
"outputSchema": {
"additionalProperties": false,
"oneOf": [
{
"required": [
"project_id",
"project_revision",
"command_version",
"status",
"stage",
"quote",
"can_start",
"can_retry",
"can_cancel",
"can_handoff",
"preview_ready",
"needs_lyrics_review",
"can_replace_lyrics",
"can_update_visuals",
"progress",
"visual_preferences",
"visual",
"visual_source",
"visual_warning",
"error",
"lyrics_source",
"lyrics_search_outcome",
"lyrics_search_provider",
"demo_mode",
"project",
"studio_url",
"media"
]
},
{
"maxProperties": 1,
"properties": {
"error": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
},
"required": [
"error"
]
}
],
"properties": {
"can_cancel": {
"type": "boolean"
},
"can_handoff": {
"type": "boolean"
},
"can_replace_lyrics": {
"type": "boolean"
},
"can_retry": {
"type": "boolean"
},
"can_start": {
"type": "boolean"
},
"can_update_visuals": {
"type": "boolean"
},
"command_version": {
"minimum": 1,
"type": "integer"
},
"demo_mode": {
"type": [
"boolean",
"null"
]
},
"error": {
"anyOf": [
{
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"code": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"message": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
{
"type": "null"
}
]
},
"lyrics_search_outcome": {
"enum": [
null,
"not_requested",
"no_accepted_candidate",
"timeout",
"error",
"found"
]
},
"lyrics_search_provider": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"lyrics_source": {
"enum": [
null,
"user_supplied",
"search_result",
"asr_fallback",
"unknown"
]
},
"media": {
"additionalProperties": false,
"properties": {
"download_url": {
"format": "uri",
"maxLength": 8192,
"type": [
"string",
"null"
]
},
"expires_in": {
"maximum": 3600,
"minimum": 1,
"type": "integer"
},
"preview_url": {
"format": "uri",
"maxLength": 8192,
"type": [
"string",
"null"
]
}
},
"required": [
"preview_url",
"download_url",
"expires_in"
],
"type": "object"
},
"needs_lyrics_review": {
"type": "boolean"
},
"preview_ready": {
"type": "boolean"
},
"progress": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"elapsed_seconds": {
"minimum": 0,
"type": "integer"
},
"label": {
"maxLength": 200,
"type": "string"
},
"percent": {
"maximum": 100,
"minimum": 0,
"type": [
"number",
"null"
]
},
"phase": {
"maxLength": 80,
"type": "string"
},
"started_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
}
},
"required": [],
"type": [
"object",
"null"
]
},
"project": {
"additionalProperties": false,
"properties": {
"artist": {
"maxLength": 500,
"type": [
"string",
"null"
]
},
"duration_seconds": {
"exclusiveMinimum": 0,
"maximum": 600,
"type": [
"number",
"null"
]
},
"export_status": {
"maxLength": 40,
"type": [
"string",
"null"
]
},
"has_export": {
"type": [
"boolean",
"null"
]
},
"has_lyrics": {
"type": [
"boolean",
"null"
]
},
"id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"revision": {
"minimum": 1,
"type": [
"integer",
"null"
]
},
"title": {
"maxLength": 500,
"type": [
"string",
"null"
]
},
"visual_settings": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"aspect_ratio": {
"maxLength": 20,
"type": "string"
},
"background_blur": {
"maximum": 24,
"minimum": 0,
"type": "number"
},
"background_dimming": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"bouncing_ball": {
"type": "boolean"
},
"effect": {
"maxLength": 40,
"type": "string"
},
"effect_particle_size": {
"maximum": 2,
"minimum": 0.5,
"type": "number"
},
"effect_particle_speed": {
"maximum": 2.5,
"minimum": 0.25,
"type": "number"
},
"font_size": {
"maximum": 96,
"minimum": 24,
"type": "integer"
},
"highlight_color": {
"maxLength": 30,
"type": "string"
},
"line_presentation": {
"maxLength": 40,
"type": "string"
},
"lyric_x": {
"maximum": 0.95,
"minimum": 0.05,
"type": "number"
},
"lyric_y": {
"maximum": 0.95,
"minimum": 0.05,
"type": "number"
},
"text_backdrop_color": {
"maxLength": 30,
"type": "string"
},
"text_backdrop_height": {
"maximum": 1,
"minimum": 0.2,
"type": "number"
},
"text_backdrop_opacity": {
"maximum": 0.8,
"minimum": 0,
"type": "number"
},
"text_color": {
"maxLength": 30,
"type": "string"
}
},
"required": [],
"type": [
"object",
"null"
]
}
},
"required": [
"id",
"title",
"artist",
"duration_seconds",
"revision",
"has_export",
"has_lyrics",
"export_status",
"visual_settings"
],
"type": "object"
},
"project_id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"project_revision": {
"minimum": 1,
"type": "integer"
},
"quote": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"ai_background_included": {
"type": "boolean"
},
"amount_minor": {
"minimum": 0,
"type": "integer"
},
"currency": {
"maxLength": 12,
"minLength": 1,
"type": "string"
},
"duration_seconds": {
"exclusiveMinimum": 0,
"maximum": 600,
"type": "number"
},
"expires_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"id": {
"maxLength": 32,
"pattern": "^[0-9a-f]{32}$",
"type": "string"
},
"pricing_version": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"id",
"amount_minor",
"currency",
"expires_at"
],
"type": "object"
},
"stage": {
"maxLength": 40,
"minLength": 1,
"type": "string"
},
"status": {
"maxLength": 40,
"minLength": 1,
"type": "string"
},
"studio_url": {
"format": "uri",
"maxLength": 8192,
"minLength": 1,
"type": "string"
},
"visual": {
"additionalProperties": true,
"maxProperties": 32,
"properties": {
"effect": {
"maxLength": 32,
"type": "string"
},
"mood": {
"maxLength": 40,
"type": "string"
},
"palette": {
"maxLength": 32,
"type": "string"
},
"source": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"style_name": {
"maxLength": 64,
"type": "string"
},
"warning": {
"maxLength": 2000,
"type": [
"string",
"null"
]
}
},
"required": [],
"type": [
"object",
"null"
]
},
"visual_preferences": {
"maxLength": 2000,
"type": "string"
},
"visual_source": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"visual_warning": {
"maxLength": 2000,
"type": [
"string",
"null"
]
}
},
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:4d89119fa326114665d151624564256fd9e486b22c556ff43029f36188274653 | sha256sum