Endpoints: 76,849MCP servers: 32,730Payout addresses: 3,825Paid calls: 6,171Letters: 84Defects: 3,898counted 3 min ago
teppi

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 yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:4d89119fa326114665d151624564256fd9e486b22c556ff43029f36188274653 | sha256sum