# Wouldliker Sound Brief spec

Quick answer: the Wouldliker Sound Brief is a JSON shape for describing what a short-form clip needs from sound. It is built for AI-video agents, n8n workflows, Make/Zapier automations, ComfyUI graphs, and editors that need sound behavior guidance before publishing.

The spec does not require downloadable audio. In v1, the main output is a route, sound behavior profile, flow guidance, risk assessment, and optional payoff guidance.

## Minimal request

```json
{
  "mode": "clip_to_sound",
  "clip": {
    "topic": "steady fashion outfit recap",
    "duration_s": 30,
    "platform": "tiktok",
    "voiceover": false,
    "commercial_use": false,
    "aigc": true
  }
}
```

## Core response fields

- `route`: the Wouldliker route, such as Vlog, Product Reveal, Core, Presentation, Affirmation, Hala Madrid, or Barcelona.
- `recommended_sound`: TikTok-native route data where available, proof examples, and current momentum state.
- `sound_behavior`: the primary edit behavior profile.
- `template_pack`: reusable prompt template, shot pattern, caption template, and placeholders for the selected route/topic.
- `flow_guidance`: first-second clarity, visual pacing, caption readability, loopability, voiceover safety, and non-interference notes.
- `payoff_guidance`: only present when `sound_behavior.payoff_required` is true.
- `beat_map`: null in v1 unless Wouldliker owns or pre-clears the audio file.
- `risk_assessment`: publishing risk wording and platform-use boundaries.
- `post_pack`: hook options, caption template, and cover-frame guidance.

## Sound behavior example

```json
{
  "sound_behavior": {
    "energy_shape": "steady",
    "density": "low",
    "role": "background_bed",
    "voiceover_safe": true,
    "hook_starts_at_ms": 0,
    "payoff_required": false,
    "loop_friendly": true,
    "recommended_lengths_s": [15, 30, 60],
    "edit_guidance": "Use as background bed. Let visual cuts drive timing.",
    "first_second_priority": "subject_in_frame",
    "interference_risk": "low"
  }
}
```

## Template pack example

```json
{
  "template_pack": {
    "template_id": "vlog_outfit_recap_30s",
    "route": "Vlog",
    "inputs": ["brand_name", "product_name", "creator_style", "location"],
    "prompt_template": "Create a 30s TikTok lifestyle outfit recap for {brand_name}...",
    "payoff_required": false
  }
}
```

## Payoff rule

If `payoff_required` is false, do not force a fake reveal, fake drop, or tension curve. The agent should prioritize subject visibility, caption readability, visual rhythm, and loopability.

If `payoff_required` is true, return a separate `payoff_guidance` object with approximate payoff timing, hold-after-payoff guidance, and cover-frame timing.

## Machine-readable schema

- [sound-brief.schema.json](/data/schemas/sound-brief.schema.json)
- [sound-behavior-profiles.schema.json](/data/schemas/sound-behavior-profiles.schema.json)
- [sound-behavior-profiles.json](/data/sound-behavior-profiles.json)

## Boundary

The Sound Brief is a planning contract. It does not grant music rights, redistribute audio, auto-post to TikTok, or guarantee views.

Last reviewed on May 27, 2026.