jogg-lip-sync

# Jogg Lip Sync Use this skill to execute lip sync tasks directly, not to generate integration code. All paths in this document are relative to the current skill root directory. Runner: - `sh "run.sh"` ## Trigger - User asks to run lip sync - User asks to check lip sync task status - User provides video and audio and expects the final driven video result ## Required Inputs - video input: URL or local file path - audio input: URL or local file path Optional: - `JOGG_BASE_URL`, default `https://api.jogg.ai` - `JOGG_API_PLATFORM`, default `openclaw` - `playback_type`, default `normal` - `poll_interval_seconds`, default `10` - `max_wait_seconds`, default `1800` If any required input is missing, ask only for the missing item. Default values used when unset: - `JOGG_BASE_URL=https://api.jogg.ai` - `JOGG_API_PLATFORM=openclaw` - `JOGG_LIP_SYNC_DEFAULT_PLAYBACK_TYPE=normal` - `JOGG_LIP_SYNC_DEFAULT_POLL_INTERVAL_SECONDS=10` - `JOGG_LIP_SYNC_DEFAULT_MAX_WAIT_SECONDS=1800` - `JOGG_API_KEY` is required. - Other current environment variables are optional. - If `JOGG_API_KEY` is empty, stop and tell the user to purchase an API plan at `https://www.jogg.ai/api-pricing/` and obtain an API key before continuing. ## Hard Rules - Execute the existing runner in the current run. - Prefer the fixed runner over handwritten HTTP calls. - Use `run.sh` as the only runner entrypoint. - Do not write scripts, helper files, SDKs, wrappers, or temporary executors. - Do not replace execution with code generation. - Do not create duplicate tasks for the same normalized inputs in one run. - Reuse existing tasks whenever allowed by the decision rules. - Prefer returning the final video result over producing artifacts. ## Endpoints - `POST /v2/upload/asset` - `GET /v2/lip_sync_video` - `POST /v2/create_lip_sync_video` - `GET /v2/lip_sync_video/:task_id` Header: - `X-Api-Key: $JOGG_API_KEY` - optional `x-api-platform: $JOGG_API_PLATFORM` ## Procedure 1. Collect missing inputs only. 2. For create or reuse flow, execute the runner with `--no-poll` first. 3. Parse the returned JSON and read `task_id` plus `status`. 4. If status is `pending` or `processing`, call the runner again with `--task-id` to query or poll. 5. Return the execution result directly in the conversation. Output contract: - `stdout`: final machine-readable JSON result only - `stderr`: progress logs during upload, query, create, and polling - Recommended agent pattern: create with `--no-poll`, then query by `task_id` ## Runner Modes Create or reuse a task: ```bash sh "run.sh" \ --video "<video-url-or-file>" \ --audio "<audio-url-or-file>" \ --playback-type "normal" \ --no-poll ``` Query a task by `task_id`: ```bash sh "run.sh" \ --task-id "<task-id>" ``` Useful flags: - `--force-recreate`: only when the user explicitly asks to regenerate after a terminal task - `--poll`: wait until terminal state in `task_id` mode - `--no-poll`: return immediately in create or reuse mode; recommended for the first runner call from the skill - `--poll-interval-seconds` - `--max-wait-seconds` `run.sh` behavior: - Uses the native shell implementation directly. - Requires `curl` and `jq`. - Uses the system default values when optional environment variables are unset. ## Decision Rules - `playback_type` defaults to `normal` if omitted. - The query endpoint returns the latest matching task under the current authenticated user and space. - Reuse `pending`, `processing`, and `success` tasks by default. - Do not recreate a `failed` task unless the user explicitly requests a retry. - Query before every create attempt. Allowed `playback_type` values: - `normal` - `normal_reverse` - `normal_reverse_by_audio` ## Output Return only execution results: - `action` - `reused` - Whether an existing task was reused or a new one was created - `task_id` - Current `status` - `data.result_url` when successful - `error.message` when failed - If still running, return the live `task_id` and `status` - Never replace the result with a generated script or file