ottoport 1.15.1 → 1.15.2

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 \u2014 as MCP tools, slash commands, or the bundled CLI.",
-  "version": "1.15.1",
+  "version": "1.15.2",
   "author": {
     "name": "LITBOX LLC",
     "email": "support@ottoport.ai"

package/README.md

@@ -29,7 +29,7 @@ ottoport video "<prompt>" [--model kling-3.0] [--duration 5] [--resolution 1080p
                           [--webhook-url https://…] [--no-wait]
 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 "<prompt>" [--model suno-v6] [--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
@@ -118,6 +118,12 @@ raster, from a prompt alone: `output_format: "gif"` is an animation (`frame_coun
 request. A GIF picks its own frame size, so `size`, `resolution` and
 `aspect_ratio` do not apply to it.
 
+```sh
+ottoport image "a paper boat bobbing on water, seamless loop" --format gif --wait --out boat.gif
+```
+
+Asking for either format with no model named uses `gpt-image-2.6`.
+
 Which modes and tiers a model accepts differs per model, so
 `ottoport_list_models` — and `ottoport models` in the CLI — prints each one's
 menu beside its price. For one model in full, including every parameter it

package/cli/ottoport.mjs

@@ -9,7 +9,7 @@
 //   ottoport image  "prompt" [--model gpt-image-2] [--resolution 2k] [--ref a.png,b.png] [--out img.png]
 //   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  "prompt" [--model suno-v6] [--duration 15] [--out song.mp3]
 //   ottoport music  --model mirelo-sfx-2.0 --video <url> [--duration 8]
 //   ottoport collections [list | create "name"]
 //   ottoport mcp
@@ -116,6 +116,7 @@ async function cmdModel(id, flags) {
       : caps.resolutions;
     console.log(`resolution: ${tiers.join(", ")}${caps.base_resolution ? ` (base ${caps.base_resolution})` : ""}`);
   }
+  if (caps?.outputFormats?.length) console.log(`outputs:    ${caps.outputFormats.join(", ")}, besides images (--format)`);
   console.log("parameters:");
   for (const p of m.parameters ?? []) {
     console.log(`  ${String(p.name).padEnd(21)}${p.type}${p.required ? ", required" : ""} — ${p.note}`);
@@ -150,7 +151,8 @@ function capabilityLine(caps) {
     return `accepts: ${caps.modes.join(", ")}${refs} · ${caps.resolutions.join("/")}`;
   }
   const inputs = caps.maxInputImages ? `up to ${caps.maxInputImages} input images` : "text only";
-  return `accepts: ${inputs} · ${caps.resolutions.join("/")}`;
+  const formats = caps.outputFormats?.length ? ` · also outputs ${caps.outputFormats.join("/")}` : "";
+  return `accepts: ${inputs} · ${caps.resolutions.join("/")}${formats}`;
 }
 
 async function cmdChat(prompt, flags) {
@@ -300,9 +302,17 @@ async function cmdImage(prompt, flags) {
   // A layer-decomposition model needs only --image; the prompt is a caption.
   if (!prompt && !last(flags.image)) die("image requires a prompt: ottoport image \"a red fox\" (or --image <url> on a layer model)");
   const { baseUrl, apiKey } = config(flags);
+  const format = last(flags.format);
+  const wantsFile = format === "gif" || format === "svg";
+  // Checked before anything is spent: the file would hold one format under another's name.
+  const outExtension = String(last(flags.out) ?? "").match(/\.(png|jpe?g|webp|gif|svg)$/i)?.[1].toLowerCase();
+  if (wantsFile && outExtension && outExtension !== format) {
+    die(`--format ${format} returns a .${format} file, but --out names a .${outExtension} one. Change one of them.`);
+  }
   const body = {
     async: true,
-    model: last(flags.model) || "gpt-image-2",
+    // The default model has no GIF or SVG output, so asking for one picks a model that does.
+    model: last(flags.model) || (wantsFile ? "gpt-image-2.6" : "gpt-image-2"),
     ...(prompt ? { prompt } : {}),
     ...(last(flags.layers) ? { num_layers: Number(last(flags.layers)) } : {}),
     ...(last(flags.size) ? { size: last(flags.size) } : {}),
@@ -437,7 +447,7 @@ async function cmdAudio(kind, prompt, flags) {
   const { baseUrl, apiKey } = config(flags);
   const body = {
     async: true,
-    model: last(flags.model) || (kind === "speech" ? "gpt-4o-mini-tts" : "suno-v5"),
+    model: last(flags.model) || (kind === "speech" ? "gpt-4o-mini-tts" : "suno-v6"),
     ...(prompt ? { prompt } : {}),
     ...(video ? { video_url: video } : {}),
     ...(last(flags.voice) ? { voice: last(flags.voice) } : {}),
@@ -528,7 +538,7 @@ Usage:
   ottoport image "<prompt>" [--model gpt-image-2] [--size 1024x1024 | --resolution 2k] [--quality high]
                             [--aspect-ratio 16:9] [--n 1] [--seed 7]
                             [--image <url>] [--ref <url>[,<url>…]] [--out file.png]
-  ottoport image "<prompt>" --model gpt-image-2.6 --format gif|svg [--frames 8] [--frame-ms 200]
+  ottoport image "<prompt>" --format gif|svg [--model gpt-image-2.6] [--frames 8] [--frame-ms 200] [--wait --out loop.gif]
   ottoport image --model qwen-image-layered --image <url> [--layers 4]
                             split one image into RGBA layers (prompt optional)
   ottoport video "<prompt>" [--model kling-3.0] [--duration 5] [--resolution 1080p]
@@ -545,7 +555,7 @@ Usage:
   ottoport webhook status <job-id> [--json]   delivery attempts and responses
   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 suno-v6] [--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)

package/commands/image.md

@@ -1,6 +1,6 @@
 ---
 description: Generate an image through the OttoPort gateway
-argument-hint: "<prompt> [--model <id>] [--resolution 2k] [--quality high] [--ref <url>…]"
+argument-hint: "<prompt> [--model <id>] [--resolution 2k] [--quality high] [--ref <url>…] [--format gif|svg]"
 allowed-tools: mcp__ottoport__ottoport_generate_image, mcp__ottoport__ottoport_list_models, Bash(curl:*)
 ---
 
@@ -9,6 +9,12 @@ Generate an image with the `ottoport_generate_image` MCP tool.
 Request: $ARGUMENTS
 
 - Pass `model` only if the user named one; the tool defaults to `gpt-image-2`.
+- An animated GIF or an SVG file comes from this tool, not from a video model:
+  set `output_format` to `gif` or `svg`, and the tool picks `gpt-image-2.6`. Only
+  that model and `gpt-image-2.6-flare` offer them, from a prompt alone, one file
+  per request. Put the motion and the loop in a GIF's prompt, and send no `size`,
+  `resolution` or `aspect_ratio` with it. `frame_count` is 2–16 (default 8; above
+  8 bills double) and `frame_duration_ms` is 20–2000.
 - An edit of an existing image goes through `image_url`, not the prompt. Several
   references at once — a character plus the scene, a product plus a style — go
   through `reference_image_urls`.
@@ -16,7 +22,7 @@ Request: $ARGUMENTS
   `size` instead when the user named exact pixels. A higher tier costs more, so
   send one only when the request asks for it.
 - On the GPT Image models, `quality` buys compute rather than pixels — `low`,
-  `medium` (the default), `high`, and `xhigh`/`max` on `gpt-image-2.5`. It is
+  `medium` (the default), `high`, and `xhigh`/`max` on `gpt-image-2.6` and `gpt-image-2.5`. It is
   billed steeply, so send it only when the user asked for a draft or a finish.
 - Models differ in how many references and which resolutions they take. If a
   request needs more than one reference, or 4k, check `ottoport_list_models`

package/commands/speech.md

@@ -11,7 +11,7 @@ backing track — or for sound effects, ambience or a soundtrack for a video, wi
 `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`.
+with the `alloy` voice, music to `suno-v6`.
 
 Print the returned audio URL, and save it to disk with `curl -sSL` only if the
 user asked for a file.

package/mcp/server.mjs

@@ -185,6 +185,9 @@ function accepts(capabilities) {
   if (Array.isArray(capabilities.resolutions) && capabilities.resolutions.length) {
     parts.push(capabilities.resolutions.join("/"));
   }
+  if (Array.isArray(capabilities.outputFormats) && capabilities.outputFormats.length) {
+    parts.push(`output_format ${capabilities.outputFormats.join("/")}`);
+  }
   return parts.length ? ` · accepts ${parts.join(", ")}` : "";
 }
 
@@ -217,6 +220,7 @@ async function describeModel(id) {
       : caps.resolutions;
     lines.push(`Resolutions: ${tiers.join(", ")}${caps.base_resolution ? ` (base ${caps.base_resolution})` : ""}`);
   }
+  if (caps?.outputFormats?.length) lines.push(`Output formats: ${caps.outputFormats.join(", ")}, besides images, via output_format`);
   lines.push("Parameters:");
   for (const p of m.parameters ?? []) {
     lines.push(`  ${p.name} (${p.type}${p.required ? ", required" : ""}) — ${p.note}`);
@@ -329,7 +333,8 @@ async function generateImage({ prompt, model, collection, wait = false, ...rest
     // Queued as a job and polled: a 4K or layered image can take longer than
     // a proxy in front of the gateway holds a request open, and the hold is
     // then settled on what actually came back.
-    body: JSON.stringify({ model: model || "gpt-image-2", ...(prompt ? { prompt } : {}), ...rest, ...withCollection(await collectionId(collection)), async: true }),
+    // The default model has no GIF or SVG output, so asking for one picks a model that does.
+    body: JSON.stringify({ model: model || (rest.output_format === "gif" || rest.output_format === "svg" ? "gpt-image-2.6" : "gpt-image-2"), ...(prompt ? { prompt } : {}), ...rest, ...withCollection(await collectionId(collection)), async: true }),
   });
   if (!res.ok) throw new Error(await gwError(res));
   let json = await res.json();
@@ -397,7 +402,7 @@ async function generateAudio(kind, { prompt, model, voice, duration, format, vid
     headers: { ...headers(), "idempotency-key": crypto.randomUUID() },
     body: JSON.stringify({
       async: true,
-      model: model || (kind === "tts" ? "gpt-4o-mini-tts" : "suno-v5"),
+      model: model || (kind === "tts" ? "gpt-4o-mini-tts" : "suno-v6"),
       ...(prompt ? { prompt } : {}),
       ...(voice ? { voice } : {}),
       ...(video_url ? { video_url } : {}),
@@ -459,13 +464,13 @@ const TOOLS = [
   },
   {
     name: "ottoport_generate_image",
-    description: "Generate an image through an OttoPort image model (GPT Image, Nano Banana, …). Text-to-image, editing from one reference, or several references at once. Also layer decomposition: qwen-image-layered and seedream-5.0-layers take `image_url` alone and return the image split into RGBA layers, one URL per layer, billed per layer. Vectors: ideogram-vector-1 returns editable SVG from a prompt (shape it with `aspect_ratio`, not `size`), and ideogram-vector-1-vectorize takes `image_url` alone and returns it traced as SVG. Which a model accepts is in its capabilities — call ottoport_list_models. Defaults to asynchronous submission: returns job_id and polling instructions. Use ottoport_get_job for results.",
+    description: "Generate an image through an OttoPort image model (GPT Image, Nano Banana, …). Text-to-image, editing from one reference, or several references at once. Also layer decomposition: qwen-image-layered and seedream-5.0-layers take `image_url` alone and return the image split into RGBA layers, one URL per layer, billed per layer. Animated GIFs and SVG files from a prompt: set output_format on gpt-image-2.6 or its Flare tier, rather than generating a video. Vectors: ideogram-vector-1 returns editable SVG from a prompt (shape it with `aspect_ratio`, not `size`), and ideogram-vector-1-vectorize takes `image_url` alone and returns it traced as SVG. Which a model accepts is in its capabilities — call ottoport_list_models. Defaults to asynchronous submission: returns job_id and polling instructions. Use ottoport_get_job for results.",
     inputSchema: {
       type: "object",
       properties: {
         wait: { type: "boolean", description: "Default false: return job immediately. True waits up to 45 seconds, then returns the same job for polling." },
         prompt: { type: "string", description: "What to generate. On a layer-decomposition model, an optional caption of the input image." },
-        model: { type: "string", description: "Model id, e.g. gpt-image-2, nano-banana-2.1, nano-banana-pro. Default gpt-image-2." },
+        model: { type: "string", description: "Model id, e.g. gpt-image-2, nano-banana-2.1, nano-banana-pro. Default gpt-image-2, or gpt-image-2.6 when output_format is gif or svg." },
         size: { type: "string", description: 'Exact pixels, e.g. "1024x1024". Wins over `resolution`.' },
         // No `enum`: the vocabulary is "1k"/"2k"/"4k", but which of them a given
         // model actually offers differs per model, and an enum here reads as a
@@ -565,7 +570,7 @@ const TOOLS = [
       properties: {
         wait: { type: "boolean", description: "Default false: return job immediately. True waits up to 45 seconds, then returns the same job for polling." },
         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." },
+        model: { type: "string", description: "Music model id. Default suno-v6; 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".' },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ottoport",
-  "version": "1.15.1",
+  "version": "1.15.2",
   "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

@@ -89,9 +89,10 @@ sensible default.
 | --- | --- | --- |
 | chat | `claude-sonnet-5` | `claude-haiku-4.5` (cheap), `gpt-5.5`, `gemini-3.5-flash` |
 | image | `gpt-image-2` | `nano-banana-2.1` (fast generation and edits), `nano-banana-pro` (high fidelity) |
+| GIF or SVG file | `gpt-image-2.6`, with `output_format` on the image tool | `gpt-image-2.6-flare` (faster) |
 | 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`, `mirelo-sfx-2.0` (sound effects, or a soundtrack for a video) |
+| music | `suno-v6` | `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