V1.1 Video to Video Music

POST/v1/run

1.1 Video To Video Music by Sonilo - AI-powered video editing and transformation. Apply style transfer, motion control, lip-sync, and visual effects to existing videos with natural language instructions.

Request body

Submit an async generation request. The model field selects the model; other fields are model-specific input parameters.

stringmodelrequired

Model identifier. Set to sonilo/1.1/video-to-video-music.

Default: sonilo/1.1/video-to-video-music

stringpromptrequired

Optional text prompt steering the musical style. If omitted, a prompt is generated automatically from the video.

Optional<string>video

Public http(s) URL of the source video to score.

Optional<integer>duration

Optional. Length (seconds) of the video segment to score. When set, scores a segment of this length starting at Start Offset (or from the beginning if Start Offset is unset). Defaults (None) to the rest of the video.

Range: 1 to 600

Optional<integer>num_samples

How many distinct scored videos to generate.

Range: 1 to 3

Default: 1

Optional<number>start_offset

Optional. Start scoring from this offset (seconds) into the video. Requires Start Offset + Duration <= Video Duration.

Range: 0 to 600

Optional<boolean>keep_speech_vocal

Keep the original video's speech/vocals. When on, the source audio is separated (music source separation), and only the isolated vocals are blended over the generated music with automatic ducking (the music dips under speech). When off (default), the original soundtrack is dropped and the video carries only the generated music.

Default: false

Optional<number>prompt_influence

Turn it up to match the text prompt

Range: 0 to 1

Default: 0.5

Response Schema

The submit endpoint returns a run response. If its status is pending or running, poll GET /v1/run/{id} with the returned opaque ID until it reaches a terminal state.

stringidrequired

Opaque SandBase run identifier. Use it exactly as returned; no prefix is guaranteed.

stringstatusrequired

Current public run status.

Allowed values: pending, running, completed, failed, timeout

Optional<string>model

Public SandBase model name used for this run.

Optional<array<object>>outputs

Present only for completed runs. Each object is capability-specific; inspect the selected model schema for its fields.

Optional<object>error

Present only for failed or timeout runs. Contains a public error type and sanitized message.

Optional<string>error.type

Stable public error category.

Optional<string>error.message

Sanitized error message safe to show to clients.

Optional<object>usage

Usage details when available.

Model capabilities

array<string>capability_tagsrequired

Capabilities declared by the model registry.

Default: video-to-video

stringexecution_moderequired

Execution mode declared by the model registry.

Default: async

# 1. Submit a generation request
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "sonilo/1.1/video-to-video-music",
  "prompt": "A cinematic product photo of a matte black smart speaker on a marble table, soft studio lighting",
  "video": "https://v3b.fal.media/files/b/0a9ddd00/2QssaYyFxstvVlmIraSns_Sonilo_Demo_Original_1.mp4",
  "duration": 1
}'

# 2. If the response is still running, poll the returned id
curl https://api.sandbase.ai/v1/run/f3d2e8a1-7c4b-4a12-9d2e-123456789abc \
  -H "Authorization: Bearer $SANDBASE_API_KEY"

Response202 Accepted

{
  "id": "f3d2e8a1-7c4b-4a12-9d2e-123456789abc",
  "model": "sonilo/1.1/video-to-video-music",
  "status": "running"
}