@sandstormapp/sdk 1.0.0 → 1.1.0

package/dist/index.js

@@ -54,10 +54,10 @@ export class Sandstorm {
     #timeoutMs;
     #fetch;
     constructor({ apiKey = environment('SANDSTORM_API_KEY'), baseUrl = environment('SANDSTORM_API_URL') ?? BASE_URL, brand, maxRetries = 2, timeoutMs = 60_000, fetch: fetcher = (input, init) => fetch(input, init), } = {}) {
+        this.#baseUrl = baseUrl.replace(/\/+$/, '');
         if (apiKey === undefined || apiKey === '') {
-            throw new Error('Pass apiKey or set SANDSTORM_API_KEY. To make a key: curl -fsSL https://ads.dev/login.mjs -o sandstorm-login.mjs && node sandstorm-login.mjs');
+            throw new Error(`Pass apiKey or set SANDSTORM_API_KEY. To make a key: curl -fsSL ${this.#baseUrl}/login.mjs -o sandstorm-login.mjs && node sandstorm-login.mjs`);
         }
-        this.#baseUrl = baseUrl.replace(/\/+$/, '');
         this.#headers = { authorization: `Bearer ${apiKey}`, ...(brand === undefined ? {} : { 'sandstorm-brand': brand }) };
         this.#maxRetries = maxRetries;
         this.#timeoutMs = timeoutMs;
@@ -144,11 +144,13 @@ export class Sandstorm {
         for (let attempt = 0;; attempt++) {
             const timeout = AbortSignal.timeout(this.#timeoutMs + (request.wait ?? 0) * 1000);
             const answered = await send(url, { method: request.method, headers, body, signal: timeout }).catch((error) => error instanceof Error ? error : new Error(String(error)));
-            if (answered instanceof Response && answered.ok)
+            if (answered instanceof Response && answered.ok && isJson(answered))
                 return (await answered.json());
+            if (answered instanceof Response && answered.ok)
+                throw await notTheApi(answered, url.origin);
             const retryable = answered instanceof Error || RETRYABLE.has(answered.status);
             if (!retryable || attempt >= this.#maxRetries)
-                throw answered instanceof Error ? answered : await refusalOf(answered);
+                throw answered instanceof Error ? answered : await refusalOf(answered, url.origin);
             await new Promise((resolve) => setTimeout(resolve, delayOf(attempt, answered instanceof Response ? answered : undefined)));
         }
     }
@@ -159,20 +161,19 @@ function delayOf(attempt, response) {
         return after * 1000;
     return Math.min(8_000, 500 * 2 ** attempt) * (0.75 + Math.random() / 2);
 }
-async function refusalOf(response) {
-    const text = await response.text();
-    try {
-        return new SandstormError(response.status, JSON.parse(text).error);
-    }
-    catch {
-        const requestId = response.headers.get('sandstorm-request-id');
-        return new SandstormError(response.status, {
-            type: 'api_error',
-            code: 'unreadable',
-            message: text || response.statusText,
-            ...(requestId === null ? {} : { request_id: requestId }),
-        });
-    }
+const isJson = (response) => response.headers.get('content-type')?.includes('json') === true;
+async function notTheApi(response, origin) {
+    await response.body?.cancel();
+    return new SandstormError(response.status, {
+        type: 'api_error',
+        code: 'not_the_api',
+        message: `${origin} answered ${response.status} with ${response.headers.get('content-type') ?? 'no content type'} instead of the API's JSON. If ${origin} is not the Sandstorm API, pass baseUrl or set SANDSTORM_API_URL.`,
+    });
+}
+async function refusalOf(response, origin) {
+    if (!isJson(response))
+        return notTheApi(response, origin);
+    return new SandstormError(response.status, (await response.json()).error);
 }
 const HEX = /^[0-9a-f]{64}$/;
 export async function verifyWebhook({ secret, body, signature, toleranceSeconds = 300, now = Date.now() }) {

package/dist/openapi.d.ts

@@ -459,7 +459,7 @@ export interface components {
              */
             model: "nano-banana-pro/edit";
             input: {
-                /** @description The change to make, or how the images come together, naming each image by its place in images. */
+                /** @description The change to make, or how the images come together, citing each image by its place in images as @image1, @image2. */
                 prompt: string;
                 /**
                  * @description Shape of the image as width:height, or auto to follow the images given; auto when left out.
@@ -479,7 +479,7 @@ export interface components {
                  * @enum {string}
                  */
                 output_format?: "png" | "jpeg" | "webp";
-                /** @description The 1 to 14 images to edit or combine, in the order the prompt names them, each an asset id (asset_…) or an https URL. */
+                /** @description The 1 to 14 images to edit or combine, in the order the prompt cites them, each an asset id (asset_…) or an https URL. */
                 images: string[];
                 /** @description Integer seed for a more repeatable edit; random when left out. */
                 seed?: number;
@@ -543,7 +543,7 @@ export interface components {
              */
             model: "nano-banana-2/edit";
             input: {
-                /** @description The change to make, or how the images come together, naming each image by its place in images. */
+                /** @description The change to make, or how the images come together, citing each image by its place in images as @image1, @image2. */
                 prompt: string;
                 /**
                  * @description Shape of the image as width:height, or auto to follow the images given; auto when left out.
@@ -563,7 +563,7 @@ export interface components {
                  * @enum {string}
                  */
                 output_format?: "png" | "jpeg" | "webp";
-                /** @description The 1 to 14 images to edit or combine, in the order the prompt names them, each an asset id (asset_…) or an https URL. */
+                /** @description The 1 to 14 images to edit or combine, in the order the prompt cites them, each an asset id (asset_…) or an https URL. */
                 images: string[];
                 /** @description Integer seed for a more repeatable edit; random when left out. */
                 seed?: number;
@@ -621,7 +621,7 @@ export interface components {
              */
             model: "nano-banana-2-lite/edit";
             input: {
-                /** @description The change to make, or how the images come together, naming each image by its place in images. */
+                /** @description The change to make, or how the images come together, citing each image by its place in images as @image1, @image2. */
                 prompt: string;
                 /**
                  * @description Shape of the image as width:height, or auto to follow the images given; auto when left out.
@@ -635,7 +635,7 @@ export interface components {
                  * @enum {string}
                  */
                 output_format?: "png" | "jpeg" | "webp";
-                /** @description The 1 to 14 images to edit or combine, in the order the prompt names them, each an asset id (asset_…) or an https URL. */
+                /** @description The 1 to 14 images to edit or combine, in the order the prompt cites them, each an asset id (asset_…) or an https URL. */
                 images: string[];
                 /** @description Integer seed for a more repeatable edit; random when left out. */
                 seed?: number;
@@ -709,7 +709,7 @@ export interface components {
              */
             model: "gpt-image-2.5-flare/edit";
             input: {
-                /** @description The change to make, or how the images come together, naming each image by its place in images and writing out exactly any words the image must show. */
+                /** @description The change to make, or how the images come together, citing each image by its place in images as @image1, @image2 and writing out exactly any words the image must show. */
                 prompt: string;
                 /**
                  * @description Shape of the image as width:height, or auto to let the model pick the size; auto when left out.
@@ -739,7 +739,7 @@ export interface components {
                  * @enum {string}
                  */
                 output_format?: "png" | "jpeg" | "webp";
-                /** @description The 1 to 16 images to edit or combine, in the order the prompt names them, each an asset id (asset_…) or an https URL. */
+                /** @description The 1 to 16 images to edit or combine, in the order the prompt cites them, each an asset id (asset_…) or an https URL. */
                 images: string[];
                 /** @description An image the size of the first of images, as an asset id (asset_…) or an https URL, with an alpha channel that is fully transparent where that image should change; the model takes it as guidance, so the rest can shift slightly. None when left out, so the prompt alone scopes the change. */
                 mask?: string;
@@ -813,7 +813,7 @@ export interface components {
              */
             model: "gpt-image-2.5-sunburst/edit";
             input: {
-                /** @description The change to make, or how the images come together, naming each image by its place in images and writing out exactly any words the image must show. */
+                /** @description The change to make, or how the images come together, citing each image by its place in images as @image1, @image2 and writing out exactly any words the image must show. */
                 prompt: string;
                 /**
                  * @description Shape of the image as width:height, or auto to let the model pick the size; auto when left out.
@@ -843,7 +843,7 @@ export interface components {
                  * @enum {string}
                  */
                 output_format?: "png" | "jpeg" | "webp";
-                /** @description The 1 to 16 images to edit or combine, in the order the prompt names them, each an asset id (asset_…) or an https URL. */
+                /** @description The 1 to 16 images to edit or combine, in the order the prompt cites them, each an asset id (asset_…) or an https URL. */
                 images: string[];
                 /** @description An image the size of the first of images, as an asset id (asset_…) or an https URL, with an alpha channel that is fully transparent where that image should change; the model takes it as guidance, so the rest can shift slightly. None when left out, so the prompt alone scopes the change. */
                 mask?: string;
@@ -907,7 +907,7 @@ export interface components {
              */
             model: "seedream-5-pro/edit";
             input: {
-                /** @description The change to make as one paragraph, at most 600 words, naming each image by its place in images (image 1, image 2), with the exact words the result must show written out. */
+                /** @description The change to make as one paragraph, at most 600 words, citing each image by its place in images as @image1, @image2, with the exact words the result must show written out. */
                 prompt: string;
                 /**
                  * @description Shape of the result as width:height, or auto to keep the shape the images suggest; auto when left out.
@@ -927,7 +927,7 @@ export interface components {
                  * @enum {string}
                  */
                 output_format?: "png" | "jpeg";
-                /** @description The images to edit or combine, in the order the prompt names them, at most 10, each an asset id (asset_…) or an https URL. */
+                /** @description The images to edit or combine, in the order the prompt cites them, at most 10, each an asset id (asset_…) or an https URL. */
                 images: string[];
                 /** @description What the output is called in your library; made from the prompt when left out. */
                 name?: string;
@@ -983,7 +983,7 @@ export interface components {
              */
             model: "seedream-5-lite/edit";
             input: {
-                /** @description The change to make as one paragraph, at most 600 words, naming each image by its place in images (image 1, image 2), with the exact words the result must show written out. */
+                /** @description The change to make as one paragraph, at most 600 words, citing each image by its place in images as @image1, @image2, with the exact words the result must show written out. */
                 prompt: string;
                 /**
                  * @description Shape of the result as width:height, or auto to keep the shape the images suggest; auto when left out.
@@ -997,7 +997,7 @@ export interface components {
                  * @enum {string}
                  */
                 resolution?: "2K" | "3K" | "4K";
-                /** @description The images to edit or combine, in the order the prompt names them, at most 14, each an asset id (asset_…) or an https URL. */
+                /** @description The images to edit or combine, in the order the prompt cites them, at most 14, each an asset id (asset_…) or an https URL. */
                 images: string[];
                 /** @description What the output is called in your library; made from the prompt when left out. */
                 name?: string;
@@ -1238,7 +1238,7 @@ export interface components {
              */
             model: "seedance-2.5/reference-to-video";
             input: {
-                /** @description What happens in the clip, citing each image, video or audio by its place in its list as @Image1, @Video1 or @Audio1. */
+                /** @description What happens in the clip, citing each image, video or audio by its place in its list as @image1, @video1 or @audio1. */
                 prompt: string;
                 /**
                  * @description reference makes a new clip from the references, editing changes the first of videos, extension continues it; auto when left out, which lets the model decide.
@@ -1252,12 +1252,12 @@ export interface components {
                  */
                 images?: string[];
                 /**
-                 * @description Up to 10 videos, 30 seconds together at most, each an asset id (asset_…) or an https URL; none when left out.
+                 * @description Up to 10 videos, each an asset id (asset_…) or an https URL; none when left out. Past 30 seconds together the longer ones are cut to their opening seconds, and beside audio their own sound is left out; editing and extension take them whole, so those must run 30 seconds or less together.
                  * @default []
                  */
                 videos?: string[];
                 /**
-                 * @description Up to 10 wav or mp3 files, 30 seconds together at most, each an asset id (asset_…) or an https URL; none when left out.
+                 * @description Up to 10 audio files, each an asset id (asset_…) or an https URL; none when left out. Past 30 seconds together the longer ones are cut to their opening seconds.
                  * @default []
                  */
                 audio?: string[];
@@ -1428,12 +1428,12 @@ export interface components {
                 /** @description The image the clip ends on, as an asset id (asset_…) or an https URL; none when left out, so the model picks the ending. */
                 end_image?: string;
                 /**
-                 * @description Up to 4 images whose subject or look the clip keeps, each an asset id (asset_…) or an https URL, cited in the prompt as @Image1, @Image2 in this order; none when left out.
+                 * @description Up to 4 images whose subject or look the clip keeps, each an asset id (asset_…) or an https URL, cited in the prompt as @image1, @image2 in this order; none when left out.
                  * @default []
                  */
                 images?: string[];
                 /**
-                 * @description Characters or objects held to one look across the clip, cited in the prompt as @Element1, @Element2 in this order; images and elements take 4 together at most, and none when left out.
+                 * @description Characters or objects held to one look across the clip, cited in the prompt as @element1, @element2 in this order; images and elements take 4 together at most, and none when left out.
                  * @default []
                  */
                 elements?: ({
@@ -1442,7 +1442,7 @@ export interface components {
                     /** @description 1 to 3 more views of the same character or object, from other angles, each an asset id (asset_…) or an https URL. */
                     reference_images: string[];
                 } | {
-                    /** @description A clip of the character or object, 3 to 10 seconds at 720 to 2160 px a side, as an asset id (asset_…) or an https URL, in place of images. */
+                    /** @description A clip of the character or object of at least 3 seconds, as an asset id (asset_…) or an https URL, in place of images; past 10 seconds it is cut to its opening 10, and outside 720 to 2160 px a side it is resized to fit. */
                     video: string;
                 })[];
                 /**
@@ -1566,7 +1566,7 @@ export interface components {
              */
             model: "gemini-omni-flash/reference-to-video";
             input: {
-                /** @description What happens in the clip, citing each image or video inline by its place in its list from 0, as <IMAGE_REF_0> or <VIDEO_REF_0>, with any spoken line in double quotes. */
+                /** @description What happens in the clip, citing each image or video by its place in its list as @image1 or @video1, with any spoken line in double quotes. */
                 prompt: string;
                 /**
                  * @description Up to 10 images of the faces, products or places to keep, each an asset id (asset_…) or an https URL; none when left out.
@@ -1574,7 +1574,7 @@ export interface components {
                  */
                 images?: string[];
                 /**
-                 * @description Up to 3 videos, each shorter than 3 seconds, for a likeness or a motion to copy, whose sound is ignored, each an asset id (asset_…) or an https URL; none when left out.
+                 * @description Up to 3 videos for a likeness or a motion to copy, whose sound is ignored, each an asset id (asset_…) or an https URL and cut to its opening 3 seconds when longer; none when left out.
                  * @default []
                  */
                 videos?: string[];
@@ -1952,10 +1952,12 @@ export interface components {
                     /** @description What one rate is for: an image, a second, a minute, a character, a request or a token */
                     unit: string;
                     usd: number;
-                    /** @description The input settings the rate applies to; empty when it applies to all */
+                    /** @description The inputs, by their names in input, that this rate applies to; a media input is true when given and false when not; empty when it applies to all. A rate charged on the input itself carries `input`: the tokens of text or image, or true for an input file it charges for */
                     when: {
                         [key: string]: unknown;
                     };
+                    /** @description Whether a generation that leaves these inputs at their defaults pays this rate */
+                    default: boolean;
                 }[];
             };
             /** @description The JSON Schema of `input` */
@@ -2027,10 +2029,7 @@ export interface components {
         Brand: {
             /** @enum {string} */
             object: "brand";
-            /**
-             * Format: uuid
-             * @description Send it as `Sandstorm-Brand` to work on this brand with a key made on another
-             */
+            /** @description Send it as `Sandstorm-Brand` to work on this brand with a key made on another */
             id: string;
             name: string;
             summary: string | null;
@@ -2797,7 +2796,7 @@ export interface operations {
         requestBody: {
             content: {
                 "application/json": {
-                    /** @description A public https link to a png, jpeg, webp, mp4, mov, mp3 or m4a file */
+                    /** @description A public https link to a png, jpeg, webp, mp4, mov, mp3, m4a or wav file */
                     url: string;
                     /** @description What the file is called in your library */
                     name?: string;

package/openapi.json

@@ -294,7 +294,7 @@
                 "type": "string",
                 "minLength": 3,
                 "maxLength": 50000,
-                "description": "The change to make, or how the images come together, naming each image by its place in images."
+                "description": "The change to make, or how the images come together, citing each image by its place in images as @image1, @image2."
               },
               "aspect_ratio": {
                 "default": "auto",
@@ -341,7 +341,7 @@
                 "items": {
                   "type": "string"
                 },
-                "description": "The 1 to 14 images to edit or combine, in the order the prompt names them, each an asset id (asset_…) or an https URL."
+                "description": "The 1 to 14 images to edit or combine, in the order the prompt cites them, each an asset id (asset_…) or an https URL."
               },
               "seed": {
                 "description": "Integer seed for a more repeatable edit; random when left out.",
@@ -475,7 +475,7 @@
                 "type": "string",
                 "minLength": 3,
                 "maxLength": 50000,
-                "description": "The change to make, or how the images come together, naming each image by its place in images."
+                "description": "The change to make, or how the images come together, citing each image by its place in images as @image1, @image2."
               },
               "aspect_ratio": {
                 "default": "auto",
@@ -526,7 +526,7 @@
                 "items": {
                   "type": "string"
                 },
-                "description": "The 1 to 14 images to edit or combine, in the order the prompt names them, each an asset id (asset_…) or an https URL."
+                "description": "The 1 to 14 images to edit or combine, in the order the prompt cites them, each an asset id (asset_…) or an https URL."
               },
               "seed": {
                 "description": "Integer seed for a more repeatable edit; random when left out.",
@@ -650,7 +650,7 @@
                 "type": "string",
                 "minLength": 3,
                 "maxLength": 50000,
-                "description": "The change to make, or how the images come together, naming each image by its place in images."
+                "description": "The change to make, or how the images come together, citing each image by its place in images as @image1, @image2."
               },
               "aspect_ratio": {
                 "default": "auto",
@@ -691,7 +691,7 @@
                 "items": {
                   "type": "string"
                 },
-                "description": "The 1 to 14 images to edit or combine, in the order the prompt names them, each an asset id (asset_…) or an https URL."
+                "description": "The 1 to 14 images to edit or combine, in the order the prompt cites them, each an asset id (asset_…) or an https URL."
               },
               "seed": {
                 "description": "Integer seed for a more repeatable edit; random when left out.",
@@ -843,7 +843,7 @@
                 "type": "string",
                 "minLength": 1,
                 "maxLength": 32000,
-                "description": "The change to make, or how the images come together, naming each image by its place in images and writing out exactly any words the image must show."
+                "description": "The change to make, or how the images come together, citing each image by its place in images as @image1, @image2 and writing out exactly any words the image must show."
               },
               "aspect_ratio": {
                 "default": "auto",
@@ -912,7 +912,7 @@
                 "items": {
                   "type": "string"
                 },
-                "description": "The 1 to 16 images to edit or combine, in the order the prompt names them, each an asset id (asset_…) or an https URL."
+                "description": "The 1 to 16 images to edit or combine, in the order the prompt cites them, each an asset id (asset_…) or an https URL."
               },
               "mask": {
                 "type": "string",
@@ -1062,7 +1062,7 @@
                 "type": "string",
                 "minLength": 1,
                 "maxLength": 32000,
-                "description": "The change to make, or how the images come together, naming each image by its place in images and writing out exactly any words the image must show."
+                "description": "The change to make, or how the images come together, citing each image by its place in images as @image1, @image2 and writing out exactly any words the image must show."
               },
               "aspect_ratio": {
                 "default": "auto",
@@ -1131,7 +1131,7 @@
                 "items": {
                   "type": "string"
                 },
-                "description": "The 1 to 16 images to edit or combine, in the order the prompt names them, each an asset id (asset_…) or an https URL."
+                "description": "The 1 to 16 images to edit or combine, in the order the prompt cites them, each an asset id (asset_…) or an https URL."
               },
               "mask": {
                 "type": "string",
@@ -1255,7 +1255,7 @@
               "prompt": {
                 "type": "string",
                 "minLength": 3,
-                "description": "The change to make as one paragraph, at most 600 words, naming each image by its place in images (image 1, image 2), with the exact words the result must show written out."
+                "description": "The change to make as one paragraph, at most 600 words, citing each image by its place in images as @image1, @image2, with the exact words the result must show written out."
               },
               "aspect_ratio": {
                 "default": "auto",
@@ -1300,7 +1300,7 @@
                 "items": {
                   "type": "string"
                 },
-                "description": "The images to edit or combine, in the order the prompt names them, at most 10, each an asset id (asset_…) or an https URL."
+                "description": "The images to edit or combine, in the order the prompt cites them, at most 10, each an asset id (asset_…) or an https URL."
               },
               "name": {
                 "type": "string",
@@ -1412,7 +1412,7 @@
               "prompt": {
                 "type": "string",
                 "minLength": 3,
-                "description": "The change to make as one paragraph, at most 600 words, naming each image by its place in images (image 1, image 2), with the exact words the result must show written out."
+                "description": "The change to make as one paragraph, at most 600 words, citing each image by its place in images as @image1, @image2, with the exact words the result must show written out."
               },
               "aspect_ratio": {
                 "default": "auto",
@@ -1449,7 +1449,7 @@
                 "items": {
                   "type": "string"
                 },
-                "description": "The images to edit or combine, in the order the prompt names them, at most 14, each an asset id (asset_…) or an https URL."
+                "description": "The images to edit or combine, in the order the prompt cites them, at most 14, each an asset id (asset_…) or an https URL."
               },
               "name": {
                 "type": "string",
@@ -1868,7 +1868,7 @@
                 "type": "string",
                 "minLength": 3,
                 "maxLength": 50000,
-                "description": "What happens in the clip, citing each image, video or audio by its place in its list as @Image1, @Video1 or @Audio1."
+                "description": "What happens in the clip, citing each image, video or audio by its place in its list as @image1, @video1 or @audio1."
               },
               "task": {
                 "default": "auto",
@@ -1892,7 +1892,7 @@
               },
               "videos": {
                 "default": [],
-                "description": "Up to 10 videos, 30 seconds together at most, each an asset id (asset_…) or an https URL; none when left out.",
+                "description": "Up to 10 videos, each an asset id (asset_…) or an https URL; none when left out. Past 30 seconds together the longer ones are cut to their opening seconds, and beside audio their own sound is left out; editing and extension take them whole, so those must run 30 seconds or less together.",
                 "maxItems": 10,
                 "type": "array",
                 "items": {
@@ -1901,7 +1901,7 @@
               },
               "audio": {
                 "default": [],
-                "description": "Up to 10 wav or mp3 files, 30 seconds together at most, each an asset id (asset_…) or an https URL; none when left out.",
+                "description": "Up to 10 audio files, each an asset id (asset_…) or an https URL; none when left out. Past 30 seconds together the longer ones are cut to their opening seconds.",
                 "maxItems": 10,
                 "type": "array",
                 "items": {
@@ -2227,7 +2227,7 @@
               },
               "images": {
                 "default": [],
-                "description": "Up to 4 images whose subject or look the clip keeps, each an asset id (asset_…) or an https URL, cited in the prompt as @Image1, @Image2 in this order; none when left out.",
+                "description": "Up to 4 images whose subject or look the clip keeps, each an asset id (asset_…) or an https URL, cited in the prompt as @image1, @image2 in this order; none when left out.",
                 "maxItems": 4,
                 "type": "array",
                 "items": {
@@ -2236,7 +2236,7 @@
               },
               "elements": {
                 "default": [],
-                "description": "Characters or objects held to one look across the clip, cited in the prompt as @Element1, @Element2 in this order; images and elements take 4 together at most, and none when left out.",
+                "description": "Characters or objects held to one look across the clip, cited in the prompt as @element1, @element2 in this order; images and elements take 4 together at most, and none when left out.",
                 "maxItems": 4,
                 "type": "array",
                 "items": {
@@ -2269,7 +2269,7 @@
                       "properties": {
                         "video": {
                           "type": "string",
-                          "description": "A clip of the character or object, 3 to 10 seconds at 720 to 2160 px a side, as an asset id (asset_…) or an https URL, in place of images."
+                          "description": "A clip of the character or object of at least 3 seconds, as an asset id (asset_…) or an https URL, in place of images; past 10 seconds it is cut to its opening 10, and outside 720 to 2160 px a side it is resized to fit."
                         }
                       },
                       "required": [
@@ -2497,7 +2497,7 @@
                 "type": "string",
                 "minLength": 3,
                 "maxLength": 20000,
-                "description": "What happens in the clip, citing each image or video inline by its place in its list from 0, as <IMAGE_REF_0> or <VIDEO_REF_0>, with any spoken line in double quotes."
+                "description": "What happens in the clip, citing each image or video by its place in its list as @image1 or @video1, with any spoken line in double quotes."
               },
               "images": {
                 "default": [],
@@ -2510,7 +2510,7 @@
               },
               "videos": {
                 "default": [],
-                "description": "Up to 3 videos, each shorter than 3 seconds, for a likeness or a motion to copy, whose sound is ignored, each an asset id (asset_…) or an https URL; none when left out.",
+                "description": "Up to 3 videos for a likeness or a motion to copy, whose sound is ignored, each an asset id (asset_…) or an https URL and cut to its opening 3 seconds when longer; none when left out.",
                 "maxItems": 3,
                 "type": "array",
                 "items": {
@@ -3180,10 +3180,10 @@
                   "type": "string"
                 },
                 "width": {
-                  "type": "number"
+                  "type": "integer"
                 },
                 "height": {
-                  "type": "number"
+                  "type": "integer"
                 },
                 "duration": {
                   "type": "number"
@@ -3390,13 +3390,18 @@
                     "when": {
                       "type": "object",
                       "additionalProperties": {},
-                      "description": "The input settings the rate applies to; empty when it applies to all"
+                      "description": "The inputs, by their names in input, that this rate applies to; a media input is true when given and false when not; empty when it applies to all. A rate charged on the input itself carries `input`: the tokens of text or image, or true for an input file it charges for"
+                    },
+                    "default": {
+                      "type": "boolean",
+                      "description": "Whether a generation that leaves these inputs at their defaults pays this rate"
                     }
                   },
                   "required": [
                     "unit",
                     "usd",
-                    "when"
+                    "when",
+                    "default"
                   ]
                 }
               }
@@ -3575,10 +3580,10 @@
             ]
           },
           "width": {
-            "type": "number"
+            "type": "integer"
           },
           "height": {
-            "type": "number"
+            "type": "integer"
           },
           "duration": {
             "type": "number"
@@ -3657,10 +3662,10 @@
             ]
           },
           "width": {
-            "type": "number"
+            "type": "integer"
           },
           "height": {
-            "type": "number"
+            "type": "integer"
           },
           "duration": {
             "type": "number"
@@ -3686,7 +3691,6 @@
           },
           "id": {
             "type": "string",
-            "format": "uuid",
             "description": "Send it as `Sandstorm-Brand` to work on this brand with a key made on another"
           },
           "name": {
@@ -3953,13 +3957,13 @@
                 },
                 "width": {
                   "type": [
-                    "number",
+                    "integer",
                     "null"
                   ]
                 },
                 "height": {
                   "type": [
-                    "number",
+                    "integer",
                     "null"
                   ]
                 },
@@ -4169,13 +4173,13 @@
                       },
                       "width": {
                         "type": [
-                          "number",
+                          "integer",
                           "null"
                         ]
                       },
                       "height": {
                         "type": [
-                          "number",
+                          "integer",
                           "null"
                         ]
                       },
@@ -4243,13 +4247,13 @@
                 },
                 "width": {
                   "type": [
-                    "number",
+                    "integer",
                     "null"
                   ]
                 },
                 "height": {
                   "type": [
-                    "number",
+                    "integer",
                     "null"
                   ]
                 },
@@ -5792,7 +5796,7 @@
                 "properties": {
                   "url": {
                     "type": "string",
-                    "description": "A public https link to a png, jpeg, webp, mp4, mov, mp3 or m4a file"
+                    "description": "A public https link to a png, jpeg, webp, mp4, mov, mp3, m4a or wav file"
                   },
                   "name": {
                     "type": "string",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sandstormapp/sdk",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "The ads.dev API for Node, Deno, Bun and edge runtimes: image, video and audio generation on your brand, the brand kit and library, and competitor ads",
   "keywords": [
     "ads.dev",