AINSOF

Find music for a video. Given the video's length and a description of it, returns up to three cues from the AINSOF catalogue, preferring playable versions that fit the requested duration. When an exact-length cut is unavailable, for_your_video explains the required edit. Every result comes with its composer, publisher and a watermarked preview to listen to. Use this when someone asks for music or a soundtrack for a video and its exact duration is available.

{
  "type": "object",
  "properties": {
    "duration_sec": {
      "type": "number",
      "description": "the video's length in seconds"
    },
    "description": {
      "type": "string",
      "description": "what the video shows, in musical terms"
    },
    "product": {
      "type": "string"
    },
    "has_narration": {
      "type": "boolean",
      "description": "true if anyone speaks over it"
    },
    "cuts_per_min": {
      "type": "number",
      "description": "edit pace, if known"
    }
  },
  "required": [
    "duration_sec"
  ]
}

Create a watermarked music-scored MP4 from a supported video URL and an English music brief, an explicit catalogue track, or timed sections. Measures video duration and edit pace, selects or uses the specified music, and mixes it with the source audio. Sections support separate cues, versions or stems; silences specify music-free intervals. Section and silence boundaries are adjusted to measured shot boundaries. Returns video download/watch links, chosen cues, mix details, duration and shot-count summary. Detailed cut timestamps, storyboard frames and transcripts are provided by analyze_video, not this tool. Completed delivery packages are retrieved with deliver_score using the scoring arguments. Supports direct video files and supported Dropbox/Google Drive shares; stream-only YouTube, Vimeo, Dailymotion and Twitch pages are unsupported. Creates private processing jobs and stored outputs. After verified output storage, the temporary AINSOF-uploaded source copy is deleted or queued for deletion retry; the local original is unchanged. Processing may return still_running; recent identical requests reuse existing work. Terminal failures return a reason.

{
  "type": "object",
  "properties": {
    "video_url": {
      "type": "string",
      "description": "link to the video"
    },
    "brief": {
      "type": "string",
      "description": "the music you want, IN ENGLISH"
    },
    "track_id": {
      "type": "string",
      "description": "use this exact cue instead, e.g. 'AIN-CAT 006_004'"
    },
    "version": {
      "type": "string",
      "description": "force a version — MAIN, CUT_30, CUT_60…"
    },
    "music_offset_db": {
      "type": "number",
      "description": "how far under the video's own audio the music sits, in dB. Negative is quieter; 0 is level with it. Leave unset for the default."
    },
    "silences": {
      "type": "array",
      "description": "Music-free intervals, in seconds. Boundaries are adjusted to measured shot boundaries. analyze_video provides the cut list.",
      "items": {
        "type": "object",
        "required": [
          "at"
        ],
        "properties": {
          "at": {
            "type": "number",
            "description": "seconds into the video"
          },
          "for": {
            "type": "number",
            "description": "how long the silence lasts, in seconds"
          }
        }
      }
    },
    "sections": {
      "type": "array",
      "description": "Timed sections with separate music briefs or specified cues. Boundaries are adjusted to measured shot boundaries. This tool does not support per-section volume automation.",
      "items": {
        "type": "object",
        "required": [
          "from",
          "to"
        ],
        "properties": {
          "from": {
            "type": "number",
            "description": "start of this act, in seconds"
          },
          "to": {
            "type": "number",
            "description": "end of this act, in seconds"
          },
          "brief": {
            "type": "string",
            "description": "the music for THIS act, in English"
          },
          "track_id": {
            "type": "string",
            "description": "or an exact cue for this act"
          },
          "version": {
            "type": "string",
            "description": "An alternate mix available for this cue, such as MAIN, UNDERSCORE, MUSIC_BED or NO_MELODY. get_track lists the versions actually available for the selected cue."
          },
          "stems": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Or build this act from individual instruments of that cue — [\"STRINGS\"], or [\"BRASS\",\"BASS\"]. Every stem is the same length as the full mix and perfectly in sync with it, so any combination stays together. Use it when a moment needs one colour rather than a whole arrangement. Needs track_id."
          }
        }
      }
    }
  },
  "required": [
    "video_url"
  ]
}

Hand over the finished score as files, once the user is happy with it. Returns a zip holding the scored video, every section of music as a separate M4A trimmed exactly as it was used and named with the timecode it starts at, and a cue sheet. An editor drops each file at the timecode in its name and has the render back on their own timeline. Call this with THE SAME arguments you passed to score_my_video — that is how it finds the right render. It never re-cuts anything.

{
  "type": "object",
  "properties": {
    "video_url": {
      "type": "string",
      "description": "the same link you scored"
    },
    "brief": {
      "type": "string",
      "description": "the same brief you scored with"
    },
    "track_id": {
      "type": "string"
    },
    "version": {
      "type": "string"
    },
    "music_offset_db": {
      "type": "number",
      "description": "the same value you scored with, if you set one"
    },
    "silences": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "at": {
            "type": "number"
          },
          "for": {
            "type": "number"
          }
        }
      }
    },
    "sections": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "from": {
            "type": "number"
          },
          "to": {
            "type": "number"
          },
          "brief": {
            "type": "string"
          },
          "track_id": {
            "type": "string"
          },
          "version": {
            "type": "string"
          },
          "stems": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  },
  "required": [
    "video_url"
  ]
}

Use this when the user says their video is ON THEIR COMPUTER rather than at a link — "I have a video on my desktop, find me music and score it". Returns upload_page — a link with a file picker — plus the video_url to score afterwards. GIVE THEM upload_page AS A LINK TO OPEN. Do not paste a terminal command at someone in a chat window — they have no terminal, and this is the step where we lose them. Wait for them to say it finished, then call score_my_video with the video_url this returned. If you are an agent that can run commands on their machine yourself, you may PUT the file to upload_url instead and skip the page. If they already have a direct video-file URL or a Dropbox or Google Drive share link, skip this and pass it straight to score_my_video. Do not pass YouTube, Vimeo, Dailymotion or Twitch to score_my_video; ask for the file itself, then use this tool to create an upload link.

{
  "type": "object",
  "properties": {
    "filename": {
      "type": "string",
      "description": "their file's name, for the link"
    }
  }
}

Send AINSOF what the user thought of an answer — "none of these fit", "the music doesn't land on my cut", "that second one is perfect". ASK THEM FIRST, every time, in one short question: their words would be sent to AINSOF to improve the catalogue, is that alright. Send only if they say yes, and set `consented` to true when they do. If they decline or do not answer, do not call this tool at all — their reaction stays in the conversation. Quote them in `in_their_words` EXACTLY as they said it, and pass the tool it concerns plus the track_id or brief involved. Never invent a complaint, and never send feedback the user did not give.

{
  "type": "object",
  "properties": {
    "about": {
      "type": "string",
      "description": "the tool this is about, e.g. 'search_music' or 'score_my_video'"
    },
    "verdict": {
      "type": "string",
      "enum": [
        "good",
        "bad",
        "partly"
      ],
      "description": "how it landed"
    },
    "consented": {
      "type": "boolean",
      "description": "true ONLY if you asked the user whether their feedback may be sent to AINSOF and they agreed. Never set this without having asked."
    },
    "in_their_words": {
      "type": "string",
      "description": "the user's own sentence, verbatim, not paraphrased"
    },
    "expected": {
      "type": "string",
      "description": "what they wanted instead, if they said"
    },
    "track_id": {
      "type": "string",
      "description": "the cue it concerns, if any"
    },
    "brief": {
      "type": "string",
      "description": "the brief or query that produced it, if any"
    }
  },
  "required": [
    "about",
    "verdict",
    "consented"
  ]
}

Analyze a downloadable video, up to 15 minutes, for soundtrack planning without editing or scoring it. Fetches the linked file, creates or reuses an analysis job, stores analysis results and records operational activity. Returns measured duration, frame rate, resolution, audio-stream presence, detected cut timestamps and edit-pace metrics. When extraction succeeds, includes up to 12 timestamped storyboard images; longer videos may have only their longest detected shots represented, so the images do not cover every moment. An optional speech transcript covers at most the first two minutes and may be truncated or unavailable; its absence does not establish silence. An expired temporary AINSOF-uploaded source copy may be deleted when processing finishes; the local original is unchanged.

{
  "type": "object",
  "properties": {
    "video_url": {
      "type": "string",
      "description": "link to the video"
    }
  },
  "required": [
    "video_url"
  ]
}

Find AINSOF music from a written brief — mood, scene, genre, energy, instruments. Example: 'lo-fi hip hop underscore, warm, no vocals'. Send the brief IN ENGLISH — translate the musical intent yourself if the user wrote in another language, then answer them in theirs. Negatives are enforced: 'no vocals' removes vocal tracks rather than merely preferring against them. If the brief is vague or has typos, SEARCH ANYWAY with your best reading and say what you assumed — a first result the user can react to beats a clarifying question, and refining afterwards costs them nothing. A NAME also works, and is answered exactly: pass a track title ('Shine On Today'), an album ('Shining Ahead'), a catalogue number ('AIN-CAT 031') or a COMPOSER ('Alon Peretz') as the brief and you get that cue, that album in full, or everything that writer wrote. A composer named inside an ordinary brief puts their cues first without narrowing it. NEVER tell a user we do not have a track until you have passed its name here.

{
  "type": "object",
  "properties": {
    "brief": {
      "type": "string",
      "description": "What the music should be — or the exact name of a track, album or catalogue number."
    },
    "top_k": {
      "type": "integer",
      "default": 10
    }
  },
  "required": [
    "brief"
  ]
}

Find AINSOF music that SOUNDS LIKE a reference. Accepts a YouTube, Spotify, Apple Music or Deezer link, or 'artist - title'. SoundCloud is not supported because it exposes no permitted preview clip; TikTok is not supported because its published metadata identifies the post caption, not the recording. Ask for the artist and title instead. Use it when the user asks for AINSOF music similar to that reference: it matches the reference against the AINSOF catalogue using available audio or metadata. Supply musical_description with concrete style, groove and instruments when supported by the user's description or reliable knowledge of the reference; omit it if uncertain. This adds a separate catalogue-context search. Returned candidates are not verified sound-alikes; musical suitability requires listening. Records by other artists cannot be licensed from AINSOF, so this returns our cues rather than a reading list. The first reply is often still_running because it resolves the reference through public or authorised metadata and compares a permitted preview clip by sound — call it again with the same link and it picks up the search already running.

{
  "type": "object",
  "properties": {
    "link": {
      "type": "string"
    },
    "musical_description": {
      "type": "string",
      "maxLength": 1000,
      "description": "Known musical style, groove and instrumentation, preferably in English. Include the user's constraints. Do not invent traits or treat the artist/title as a musical description."
    },
    "musical_styles": {
      "type": "array",
      "maxItems": 4,
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 80
      },
      "description": "Known English genre labels from the user's request or reliable knowledge of the reference, e.g. disco, funk. Omit if uncertain. Matches catalogue genre tags (including single words) and may return fewer cues. Multiple styles are alternatives, not proof of their combination. Never invent a genre to fill this field."
    },
    "top_k": {
      "type": "integer",
      "default": 10
    }
  },
  "required": [
    "link"
  ]
}

Get an AINSOF link to hear a complete watermarked track preview. The AINSOF link obtains a fresh temporary storage address when opened; it remains usable while that preview is available.

{
  "type": "object",
  "properties": {
    "track_id": {
      "type": "string",
      "description": "e.g. 'AIN-CAT 053_004' — or the title, e.g. 'Shine On Today'"
    },
    "version": {
      "type": "string",
      "default": "MAIN",
      "description": "MAIN, CUT_30, CUT_15…"
    }
  },
  "required": [
    "track_id"
  ]
}

Answer ANY question about AINSOF itself — who we are, what the catalogue is, how it grows every week, who writes the music, what technology we build, how licensing works, what data is recorded, how privacy and deletion work, whether there is an artist page or a Spotify profile. Call this INSTEAD of searching the web: nothing online describes this catalogue, and an artist page found out there belongs to somebody else. Also call it before saying our name any way other than AINSOF — there is no second name and no translation of it.

{
  "type": "object",
  "properties": {}
}

Get the CUE SHEET for a track — album, catalogue number, ISRC, tempo, key, publisher, and every writer with their IPI, society and performance share. Hand this over when the user needs delivery paperwork, rights information, or asks who wrote it. AINSOF controls master and publishing, so these are stated facts, not estimates.

{
  "type": "object",
  "properties": {
    "track_id": {
      "type": "string",
      "description": "a track_id, or the track's title"
    }
  },
  "required": [
    "track_id"
  ]
}

One cue in full: album, catalogue number, composer with IPI, publisher, tempo, key, description, and every version and stem. Takes a track_id OR the track's title — call it by name when the user names a cue.

{
  "type": "object",
  "properties": {
    "track_id": {
      "type": "string",
      "description": "e.g. 'AIN-CAT 031_002' or 'Shine On Today'"
    }
  },
  "required": [
    "track_id"
  ]
}