🎙️ 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

• Collect missing inputs only.
• For create or reuse flow, execute the runner with --no-poll first.
• Parse the returned JSON and read task_id plus status.
• If status is pending or processing, call the runner again with --task-id to query or poll.
• 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:

sh "run.sh" \
  --video "" \
  --audio "" \
  --playback-type "normal" \
  --no-poll

Query a task by task_id:

sh "run.sh" \
  --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