ottoport 1.13.2 → 1.14.0

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "ottoport",
   "description": "One API for every model. Call chat, image, video, speech and music models through the OttoPort gateway — as MCP tools, slash commands, or the bundled CLI.",
-  "version": "1.13.2",
+  "version": "1.14.0",
   "author": {
     "name": "LITBOX LLC",
     "email": "support@ottoport.ai"

package/README.md

@@ -30,6 +30,7 @@ ottoport video "<prompt>" [--model kling-3.0] [--duration 5] [--resolution 1080p
 ottoport webhook status|retry <job-id>   # delivery attempts / redeliver now
 ottoport speech "<text>"  [--model gpt-4o-mini-tts] [--voice alloy] [--out speech.mp3]
 ottoport music "<prompt>" [--model suno-v5] [--duration 15] [--out song.mp3]
+ottoport music --model mirelo-sfx-2.0 --video <url> [--duration 8]   # soundtrack for a video
 
 ottoport install <host>   # wire the MCP server into an agent
 ottoport mcp              # run the MCP server on stdio

package/cli/ottoport.mjs

@@ -10,6 +10,7 @@
 //   ottoport video  "prompt" [--model kling-3.0] [--duration 5] [--out clip.mp4]
 //   ottoport speech "text" [--model gpt-4o-mini-tts] [--voice alloy] [--out speech.mp3]
 //   ottoport music  "prompt" [--model suno-v5] [--duration 15] [--out song.mp3]
+//   ottoport music  --model mirelo-sfx-2.0 --video <url> [--duration 8]
 //   ottoport collections [list | create "name"]
 //   ottoport mcp
 //   ottoport install <codex|claude|hermes|cursor|windsurf|claude-desktop>
@@ -394,11 +395,14 @@ async function cmdWebhook(action, jobId, flags) {
 }
 
 async function cmdAudio(kind, prompt, flags) {
-  if (!prompt) die(`${kind} requires a prompt: ottoport ${kind} "hello"`);
+  // A sound-effects model scores a video, so the prompt is optional with one.
+  const video = kind === "music" ? last(flags.video) : undefined;
+  if (!prompt && !video) die(`${kind} requires a prompt: ottoport ${kind} "hello"`);
   const { baseUrl, apiKey } = config(flags);
   const body = {
     model: last(flags.model) || (kind === "speech" ? "gpt-4o-mini-tts" : "suno-v5"),
-    prompt,
+    ...(prompt ? { prompt } : {}),
+    ...(video ? { video_url: video } : {}),
     ...(last(flags.voice) ? { voice: last(flags.voice) } : {}),
     ...(last(flags.duration) ? { duration: Number(last(flags.duration)) } : {}),
     ...(last(flags.format) ? { format: last(flags.format) } : {}),
@@ -499,6 +503,9 @@ Usage:
   ottoport webhook retry  <job-id> [--json]   redeliver a finished job's webhook now
   ottoport speech "<text>" [--model gpt-4o-mini-tts] [--voice alloy] [--format mp3] [--out speech.mp3]
   ottoport music  "<prompt>" [--model suno-v5] [--duration 15] [--format mp3] [--out song.mp3]
+  ottoport music  ["<prompt>"] --model mirelo-sfx-2.0 --video <url> [--duration 8] [--out sfx.wav]
+                            a soundtrack synced to the video, dialogue kept;
+                            set --duration to the clip's length (it bills)
   ottoport collections [list] [--json]          collections in the key's project
   ottoport collections create "<name>" [--description "..."] [--external-id <id>]
   ottoport mcp
@@ -528,6 +535,8 @@ Examples:
   ottoport image --model seedream-5.0-layers --image https://…/poster.png
   ottoport speech "Welcome to OttoPort" --voice alloy --out welcome.mp3
   ottoport music "lo-fi focus beat" --duration 20 --out focus.mp3
+  ottoport music "rain on a tin roof" --model mirelo-sfx-2.0 --duration 10 --format mp3 --out rain.mp3
+  ottoport music --model mirelo-sfx-2.0 --video https://example.com/chase.mp4 --duration 8 --out chase.wav
   ottoport collections create "Spring campaign"
   ottoport image "spring hero banner" --collection <collection-id>
   ottoport mcp

package/commands/speech.md

@@ -1,5 +1,5 @@
 ---
-description: Turn text into speech, or a prompt into music, through the OttoPort gateway
+description: Turn text into speech, or a prompt into music or sound effects, through the OttoPort gateway
 argument-hint: "<text> [--voice alloy] [--music]"
 allowed-tools: mcp__ottoport__ottoport_generate_speech, mcp__ottoport__ottoport_generate_music, Bash(curl:*)
 ---
@@ -7,7 +7,9 @@ allowed-tools: mcp__ottoport__ottoport_generate_speech, mcp__ottoport__ottoport_
 Request: $ARGUMENTS
 
 Use `ottoport_generate_music` when the request is for music, a song, or a
-backing track; otherwise use `ottoport_generate_speech` to read the text aloud.
+backing track — or for sound effects, ambience or a soundtrack for a video, with
+`model` `mirelo-sfx-2.0` (pass the video as `video_url`, and `duration` as its
+length); otherwise use `ottoport_generate_speech` to read the text aloud.
 Pass `voice` and `format` only when named — speech defaults to `gpt-4o-mini-tts`
 with the `alloy` voice, music to `suno-v5`.
 

package/mcp/server.mjs

@@ -375,15 +375,16 @@ async function videoWebhook({ job_id, action = "status" }) {
   return JSON.stringify({ id: body.id, status: body.status, webhook: body.webhook ?? null }, null, 2);
 }
 
-async function generateAudio(kind, { prompt, model, voice, duration, format, collection }) {
-  if (!prompt) throw new Error("`prompt` is required");
+async function generateAudio(kind, { prompt, model, voice, duration, format, video_url, collection }) {
+  if (!prompt && !video_url) throw new Error("`prompt` is required");
   const res = await fetch(`${BASE}/api/v1/audio/${kind === "tts" ? "speech" : "music"}`, {
     method: "POST",
     headers: headers(),
     body: JSON.stringify({
       model: model || (kind === "tts" ? "gpt-4o-mini-tts" : "suno-v5"),
-      prompt,
+      ...(prompt ? { prompt } : {}),
       ...(voice ? { voice } : {}),
+      ...(video_url ? { video_url } : {}),
       ...(duration ? { duration } : {}),
       ...(format ? { format } : {}),
       ...withCollection(await collectionId(collection)),
@@ -522,17 +523,17 @@ const TOOLS = [
   },
   {
     name: "ottoport_generate_music",
-    description: "Generate music from a prompt through an OttoPort music model. Returns an audio URL or data URL.",
+    description: "Generate music or sound effects from a prompt through an OttoPort music model — or, with mirelo-sfx-2.0 and a video_url, a soundtrack synced to that video. Returns an audio URL or data URL.",
     inputSchema: {
       type: "object",
       properties: {
-        prompt: { type: "string", description: "Music-generation prompt." },
-        model: { type: "string", description: "Music model id. Default suno-v5." },
+        prompt: { type: "string", description: "Music-generation prompt, or the sounds to make. Optional with video_url." },
+        model: { type: "string", description: "Music model id. Default suno-v5; mirelo-sfx-2.0 for sound effects." },
         duration: { type: "number", description: "Requested duration in seconds." },
+        video_url: { type: "string", description: "mirelo-sfx-2.0 only: an http(s) video to score. Set duration to its length — duration is what bills." },
         format: { type: "string", description: 'e.g. "mp3" or "wav".' },
         collection: { type: "string", description: "Save the result for good into this collection — its id or exact name (see ottoport_list_collections). Without it the file expires after a few days. Needs collections unlocked on the account. Defaults to OTTOPORT_COLLECTION when set." },
       },
-      required: ["prompt"],
     },
     handler: (args) => generateAudio("music", args),
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ottoport",
-  "version": "1.13.2",
+  "version": "1.14.0",
   "description": "Claude Code plugin, CLI and MCP server for OttoPort — one OpenAI-compatible API for every LLM, image, video, and speech model.",
   "homepage": "https://ottoport.ai",
   "repository": {

package/skills/ottoport/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ottoport
-description: Generate text, images, video, speech, and music through OttoPort — one gateway for every model (GPT, Claude, Gemini, GPT Image, Nano Banana, Veo, Kling, Seedance, Suno). Use when the user wants to call an LLM or generate an image, video, or audio and has OttoPort configured, or asks to "use OttoPort".
+description: Generate text, images, video, speech, and music through OttoPort — one gateway for every model (GPT, Claude, Gemini, GPT Image, Nano Banana, Veo, Kling, Seedance, Suno, Mirelo). Use when the user wants to call an LLM or generate an image, video, audio or sound effects and has OttoPort configured, or asks to "use OttoPort".
 ---
 
 # OttoPort
@@ -20,7 +20,7 @@ and do not call the HTTP API, when a tool covers the job:
 | `ottoport_generate_video` | `prompt`, plus optional `model`, `duration`, `resolution`, `aspect_ratio`, `seed`, `image_url` (first frame), `last_frame_url`, `reference_image_urls`, `reference_video_urls` / `reference_audio_urls` (models listing `referenceMedia`), `video_url` (edit / extend, or the movement for motion control), `character_orientation` / `keep_original_sound` (motion control), `draft` / `draft_id` (Seedance 2.5: a 480p preview, then the same shot at 1080p from the preview's job id; the model `seedance-2.5-draft` drafts on every request without `draft`), `webhook_url` (returns the job id at once and POSTs the result there; the secret comes from `webhook_secret` or the server's `OTTOPORT_WEBHOOK_SECRET`). |
 | `ottoport_video_webhook` | `job_id`, plus `action` `status` (every delivery attempt and the endpoint's response) or `retry` (redeliver a finished job's webhook now). |
 | `ottoport_generate_speech` | `prompt` (the text), plus optional `model`, `voice`, `format`. |
-| `ottoport_generate_music` | `prompt`, plus optional `model`, `duration`, `format`. |
+| `ottoport_generate_music` | `prompt`, plus optional `model`, `duration`, `format`. Sound effects too: `model` `mirelo-sfx-2.0` makes them from the prompt, or with `video_url` a soundtrack synced to that video, dialogue kept (prompt then optional). It bills per requested second, so set `duration` to the clip's length. |
 | `ottoport_list_collections` | The project's collections (ids, asset counts) and whether this account may save. Read it to find the collection the user means. |
 | `ottoport_create_collection` | `name`, plus optional `description`, `external_id`. |
 | `ottoport_list_assets` | Saved files, optionally by `collection` and `kind`. |
@@ -90,7 +90,7 @@ sensible default.
 | image | `gpt-image-2` | `nano-banana-2.1` (fast generation and edits), `nano-banana-pro` (high fidelity) |
 | video | `kling-3.0` | `seedance-2.0-fast` (cheap), `veo-3.1` (with audio) |
 | speech | `gpt-4o-mini-tts` | `eleven-v3` |
-| music | `suno-v5` | `lyria-2` |
+| music | `suno-v5` | `lyria-2`, `mirelo-sfx-2.0` (sound effects, or a soundtrack for a video) |
 
 Never invent a model id. Call `ottoport_list_models` when unsure — the catalog
 changes, and a wrong id is a failed billable call. Rates come back in credits (the unit the ledger