mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

T

SnapOtter 8532f3227b docs: audit all 157 tool pages against live schemas

Reconcile every tool page's parameters, defaults, and response shape against the tool's Zod settings schema and executionHint in code. Notable fixes: color-palette (add count + format params, hex output, median-cut algorithm), favicon (add 5 params, was documented as having none), qr-generate (add logoDataUri), convert (add ppm/eps/tga formats), video-loudnorm (-16 LUFS not -14), smart-crop (async 202 not sync 200), images-to-video (1080x1080 square), and several output-filename and behavior-note corrections.

Also normalize API endpoint paths to /api/v1/tools/<id> (no modality segment) and standardize curl examples on the Docker API port 1349. Verified with a clean docs build.

2026-06-18 14:12:28 +08:00

1.2 KiB

Raw Blame History

description

description
Swap the audio track of a video with another file.

Replace Audio

Swap the audio track of a video with an audio file. Upload both a video and an audio file.

API Endpoint

POST /api/v1/tools/replace-audio

Accepts multipart form data with exactly two files: a video file followed by an audio file.

Parameters

This tool has no settings parameters. Upload a video file and an audio file as two file parts.

Example Request

curl -X POST http://localhost:1349/api/v1/tools/replace-audio \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@clip.mp4" \
  -F "file=@voiceover.mp3"

Example Response

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/clip.mp4",
  "originalSize": 12500000,
  "processedSize": 13100000
}

Notes

Exactly two files must be uploaded: the first must be a video, the second must be an audio file.
If the audio file is longer than the video, it is trimmed to match the video duration. If shorter, the remaining video plays in silence.
The video stream is copied without re-encoding, so there is no video quality loss.

1.2 KiB Raw Blame History