venice-video-harness 2.4.0

package/dist/venice/client.js

@@ -0,0 +1,375 @@
+// ---------------------------------------------------------------------------
+// VeniceClient -- low-level HTTP transport for the Venice AI REST API.
+//
+// Handles authentication, serialisation, retries with exponential back-off,
+// and a simple inter-request rate-limit delay.
+// ---------------------------------------------------------------------------
+// ---- Configuration constants ----------------------------------------------
+const DEFAULT_BASE_URL = "https://api.venice.ai";
+const MAX_RETRIES = 3;
+const INITIAL_BACKOFF_MS = 1_000; // 1 s
+const RATE_LIMIT_DELAY_MS = 250; // 250 ms between requests
+// ---- Custom error ---------------------------------------------------------
+export class VeniceRequestError extends Error {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.name = "VeniceRequestError";
+        this.status = status;
+        this.body = body;
+    }
+}
+// ---- Deprecation header surfacing -----------------------------------------
+//
+// Venice returns these headers on every call that uses a deprecated model:
+//
+//   x-venice-model-id                            (the model actually served)
+//   x-venice-model-name                          (display name)
+//   x-venice-model-deprecation-warning           (free-form notice)
+//   x-venice-model-deprecation-date              (ISO 8601 date)
+//
+// Source: https://docs.venice.ai/api-reference/api-spec (response headers).
+//
+// Before this change the client read JSON bodies and discarded headers,
+// which meant the harness was completely blind to upcoming Venice model
+// sunsets — a model would keep working with a "deprecation in N days"
+// banner that we never saw, and then start 404ing post-sunset with no
+// warning. (This is exactly what happened with `qwen-2.5-vl` for the QA
+// vision model: the model sunset 2025-09-22 and the harness only learned
+// about it via downstream 404s.)
+//
+// We surface each unique (model, date) deprecation warning ONCE per
+// process via stderr so the MCP can pattern-match `MODEL DEPRECATION` and
+// the agent operating the pipeline can plan a migration before the sunset
+// date. The dedupe key includes the date so a model whose sunset is
+// rescheduled re-warns.
+const seenDeprecations = new Set();
+/**
+ * Inspect a Response's headers for Venice deprecation notices and emit
+ * a structured stderr warning the first time each unique notice is seen
+ * in this process. Returns the parsed notice when present (mostly for
+ * testing), otherwise null.
+ *
+ * Exported for tests; callers in this file invoke it from each request
+ * path so every response shape (json, binary, json-or-binary) is covered.
+ */
+export function reportVeniceDeprecation(headers, requestPath) {
+    const warning = headers.get("x-venice-model-deprecation-warning");
+    if (!warning)
+        return null;
+    const date = headers.get("x-venice-model-deprecation-date");
+    const modelId = headers.get("x-venice-model-id");
+    const modelName = headers.get("x-venice-model-name");
+    const dedupeKey = `${modelId ?? "(unknown)"}::${date ?? "(no-date)"}`;
+    if (!seenDeprecations.has(dedupeKey)) {
+        seenDeprecations.add(dedupeKey);
+        const id = modelId ?? "(unknown id)";
+        const name = modelName ? ` "${modelName}"` : "";
+        const when = date ? ` sunset ${date}` : "";
+        console.warn(`  ⚠ MODEL DEPRECATION: ${id}${name}${when} (via ${requestPath}): ${warning}`);
+        console.warn(`    Migrate before the sunset date or this call will start returning 404 / 410.`);
+        console.warn(`    Check the current recommended replacement via inspect.models (MCP) ` +
+            `or GET https://api.venice.ai/api/v1/models for the model's traits.`);
+    }
+    return { modelId, modelName, warning, date };
+}
+/**
+ * Test-only: reset the per-process deduplication state so unit tests can
+ * exercise the warn-once behavior across multiple invocations.
+ */
+export function _resetDeprecationDedupeForTests() {
+    seenDeprecations.clear();
+}
+// ---- Client ---------------------------------------------------------------
+export class VeniceClient {
+    apiKey;
+    baseUrl;
+    /**
+     * Timestamp (epoch ms) of the last request that completed.  Used by the
+     * simple rate-limiter to ensure a minimum gap between consecutive calls.
+     */
+    lastRequestAt = 0;
+    /**
+     * @param apiKey  Bearer token for the Venice API.  Falls back to the
+     *                `VENICE_API_KEY` environment variable when omitted.
+     * @param baseUrl Root URL for the API (no trailing slash).
+     */
+    constructor(apiKey, baseUrl) {
+        const resolvedKey = apiKey ?? process.env.VENICE_API_KEY;
+        if (!resolvedKey) {
+            throw new Error("Venice API key is required. Pass it explicitly or set the VENICE_API_KEY environment variable.");
+        }
+        this.apiKey = resolvedKey;
+        this.baseUrl = (baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    }
+    // ---- Public API ---------------------------------------------------------
+    /** Send a GET request and return parsed JSON. Used by setup/doctor checks. */
+    async get(path) {
+        await this.applyRateLimit();
+        const response = await fetch(`${this.baseUrl}${path}`, {
+            headers: { Authorization: `Bearer ${this.apiKey}` },
+        });
+        this.lastRequestAt = Date.now();
+        reportVeniceDeprecation(response.headers, path);
+        if (response.ok)
+            return (await response.json());
+        let errorBody;
+        try {
+            errorBody = await response.json();
+        }
+        catch {
+            errorBody = { raw: await response.text().catch(() => '') };
+        }
+        const apiError = errorBody;
+        throw new VeniceRequestError(apiError?.error?.message ?? `Venice API returned HTTP ${response.status}`, response.status, errorBody);
+    }
+    /**
+     * Send a POST request to `path` with a JSON body and return the parsed
+     * response.
+     *
+     * Automatically retries on transient failures (HTTP 429 / 5xx) up to
+     * {@link MAX_RETRIES} times using exponential back-off.  A small delay is
+     * inserted between consecutive requests to stay within rate limits.
+     *
+     * @typeParam T  Expected shape of the parsed JSON response.
+     * @param path   API path **including** the leading slash (e.g. `/api/v1/image/generate`).
+     * @param body   Request payload -- will be JSON-stringified.
+     * @returns      Parsed JSON response body.
+     * @throws {VeniceRequestError} On non-retryable HTTP errors (4xx other than 429).
+     * @throws {Error}              When all retry attempts are exhausted.
+     */
+    async post(path, body) {
+        await this.applyRateLimit();
+        const url = `${this.baseUrl}${path}`;
+        let lastError;
+        for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+            if (attempt > 0) {
+                const backoff = INITIAL_BACKOFF_MS * Math.pow(2, attempt - 1);
+                await VeniceClient.sleep(backoff);
+            }
+            try {
+                const response = await fetch(url, {
+                    method: "POST",
+                    headers: {
+                        "Content-Type": "application/json",
+                        Authorization: `Bearer ${this.apiKey}`,
+                    },
+                    body: JSON.stringify(body),
+                });
+                this.lastRequestAt = Date.now();
+                reportVeniceDeprecation(response.headers, path);
+                if (response.ok) {
+                    return (await response.json());
+                }
+                // Parse the error body for diagnostics.
+                let errorBody;
+                try {
+                    errorBody = await response.json();
+                }
+                catch {
+                    errorBody = { raw: await response.text().catch(() => "") };
+                }
+                const apiError = errorBody;
+                const message = apiError?.error?.message ??
+                    `Venice API returned HTTP ${response.status}`;
+                // Retry on rate-limit (429) and server errors (5xx).
+                if (response.status === 429 || response.status >= 500) {
+                    if (response.status === 429) {
+                        console.warn(`  ⚠ Venice rate-limit (HTTP 429) on ${path}; retrying with exponential back-off (attempt ${attempt + 1}/${MAX_RETRIES}).`);
+                    }
+                    lastError = new VeniceRequestError(message, response.status, errorBody);
+                    continue;
+                }
+                // 410 Gone usually means the model has been removed post-sunset and
+                // routing wasn't possible — surface it explicitly so the agent
+                // doesn't just see a generic 4xx.
+                if (response.status === 410) {
+                    console.warn(`  ⚠ Venice returned 410 Gone on ${path}. The requested model is likely fully retired ` +
+                        `and Venice could not route to a replacement. Check the deprecation tracker or call ` +
+                        `GET /api/v1/models to find the current equivalent.`);
+                }
+                // Non-retryable client error -- throw immediately.
+                throw new VeniceRequestError(message, response.status, errorBody);
+            }
+            catch (err) {
+                // Network errors (DNS failure, connection reset, etc.) are retryable.
+                if (err instanceof VeniceRequestError) {
+                    // Already classified above; re-throw non-retryable errors.
+                    if (err.status > 0 && err.status < 500 && err.status !== 429) {
+                        throw err;
+                    }
+                    lastError = err;
+                }
+                else {
+                    lastError = err instanceof Error ? err : new Error(String(err));
+                }
+            }
+        }
+        throw lastError ?? new Error("Venice API request failed after all retries.");
+    }
+    /**
+     * POST with JSON body, receive raw binary (e.g. image/png from multi-edit).
+     * Same retry/rate-limit logic as {@link post}.
+     */
+    async postBinary(path, body) {
+        await this.applyRateLimit();
+        const url = `${this.baseUrl}${path}`;
+        let lastError;
+        for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+            if (attempt > 0) {
+                const backoff = INITIAL_BACKOFF_MS * Math.pow(2, attempt - 1);
+                await VeniceClient.sleep(backoff);
+            }
+            try {
+                const response = await fetch(url, {
+                    method: "POST",
+                    headers: {
+                        "Content-Type": "application/json",
+                        Authorization: `Bearer ${this.apiKey}`,
+                    },
+                    body: JSON.stringify(body),
+                });
+                this.lastRequestAt = Date.now();
+                reportVeniceDeprecation(response.headers, path);
+                if (response.ok) {
+                    const arrayBuffer = await response.arrayBuffer();
+                    return Buffer.from(arrayBuffer);
+                }
+                let errorBody;
+                try {
+                    errorBody = await response.json();
+                }
+                catch {
+                    errorBody = { raw: await response.text().catch(() => "") };
+                }
+                const apiError = errorBody;
+                const message = apiError?.error?.message ??
+                    `Venice API returned HTTP ${response.status}`;
+                if (response.status === 429 || response.status >= 500) {
+                    lastError = new VeniceRequestError(message, response.status, errorBody);
+                    continue;
+                }
+                throw new VeniceRequestError(message, response.status, errorBody);
+            }
+            catch (err) {
+                if (err instanceof VeniceRequestError) {
+                    if (err.status > 0 && err.status < 500 && err.status !== 429) {
+                        throw err;
+                    }
+                    lastError = err;
+                }
+                else {
+                    lastError = err instanceof Error ? err : new Error(String(err));
+                }
+            }
+        }
+        throw lastError ?? new Error("Venice API request failed after all retries.");
+    }
+    /**
+     * POST with JSON body, receive either JSON status data or raw binary media.
+     * Useful for async retrieval endpoints that return JSON while processing and
+     * switch to binary once the asset is ready for download.
+     */
+    async postBinaryOrJson(path, body) {
+        await this.applyRateLimit();
+        const url = `${this.baseUrl}${path}`;
+        let lastError;
+        for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+            if (attempt > 0) {
+                const backoff = INITIAL_BACKOFF_MS * Math.pow(2, attempt - 1);
+                await VeniceClient.sleep(backoff);
+            }
+            try {
+                const response = await fetch(url, {
+                    method: "POST",
+                    headers: {
+                        "Content-Type": "application/json",
+                        Authorization: `Bearer ${this.apiKey}`,
+                    },
+                    body: JSON.stringify(body),
+                });
+                this.lastRequestAt = Date.now();
+                reportVeniceDeprecation(response.headers, path);
+                if (response.ok) {
+                    const contentType = response.headers.get("content-type") ?? "";
+                    if (contentType.includes("application/json")) {
+                        return {
+                            contentType,
+                            value: (await response.json()),
+                        };
+                    }
+                    return {
+                        contentType,
+                        value: Buffer.from(await response.arrayBuffer()),
+                    };
+                }
+                let errorBody;
+                try {
+                    errorBody = await response.json();
+                }
+                catch {
+                    errorBody = { raw: await response.text().catch(() => "") };
+                }
+                const apiError = errorBody;
+                const message = apiError?.error?.message ??
+                    `Venice API returned HTTP ${response.status}`;
+                if (response.status === 429 || response.status >= 500) {
+                    lastError = new VeniceRequestError(message, response.status, errorBody);
+                    continue;
+                }
+                throw new VeniceRequestError(message, response.status, errorBody);
+            }
+            catch (err) {
+                if (err instanceof VeniceRequestError) {
+                    if (err.status > 0 && err.status < 500 && err.status !== 429) {
+                        throw err;
+                    }
+                    lastError = err;
+                }
+                else {
+                    lastError = err instanceof Error ? err : new Error(String(err));
+                }
+            }
+        }
+        throw lastError ?? new Error("Venice API request failed after all retries.");
+    }
+    /**
+     * Send a chat completion request with multimodal content (text + images).
+     * Uses the OpenAI-compatible chat completions endpoint.
+     */
+    async chatWithVision(model, systemPrompt, imageDataUris, userPrompt) {
+        const content = [];
+        for (const uri of imageDataUris) {
+            content.push({ type: 'image_url', image_url: { url: uri } });
+        }
+        content.push({ type: 'text', text: userPrompt });
+        const body = {
+            model,
+            messages: [
+                { role: 'system', content: systemPrompt },
+                { role: 'user', content },
+            ],
+            max_tokens: 2000,
+            temperature: 0.3,
+        };
+        const response = await this.post('/api/v1/chat/completions', body);
+        return response.choices?.[0]?.message?.content ?? '';
+    }
+    // ---- Internals ----------------------------------------------------------
+    /**
+     * Ensure at least {@link RATE_LIMIT_DELAY_MS} ms have elapsed since the
+     * previous request completed.
+     */
+    async applyRateLimit() {
+        const elapsed = Date.now() - this.lastRequestAt;
+        if (elapsed < RATE_LIMIT_DELAY_MS) {
+            await VeniceClient.sleep(RATE_LIMIT_DELAY_MS - elapsed);
+        }
+    }
+    /** Promise-based sleep helper. */
+    static sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/venice/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/venice/client.ts"],"names":[],"mappings":"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"}

package/dist/venice/edit.d.ts

@@ -0,0 +1,57 @@
+import type { VeniceClient } from "./client.js";
+export interface EditImageOptions {
+    image: string;
+    mask?: string;
+    prompt: string;
+    strength?: number;
+    model?: string;
+    steps?: number;
+    cfg_scale?: number;
+    seed?: number;
+    safe_mode?: boolean;
+}
+export interface EditImageResult {
+    base64: string;
+    seed: number | undefined;
+}
+/**
+ * @deprecated The /images/edit inpainting endpoint was disabled May 19, 2025.
+ * Use multiEditImage from multi-edit.ts instead.
+ */
+export declare function editImage(client: VeniceClient, options: EditImageOptions): Promise<EditImageResult>;
+export interface UpscaleImageOptions {
+    /** Base64-encoded image or data URL */
+    image: string;
+    /** Upscale factor (e.g. 2, 4). Model-dependent. */
+    scale?: number;
+    /** Model override. Default determined by Venice. */
+    model?: string;
+}
+export interface UpscaleImageResult {
+    /** Base64-encoded upscaled image */
+    base64: string;
+}
+/**
+ * Upscale an image using Venice's AI upscaling endpoint.
+ * Returns the upscaled image as base64.
+ */
+export declare function upscaleImage(client: VeniceClient, options: UpscaleImageOptions): Promise<UpscaleImageResult>;
+/**
+ * Upscale an image and save the result to disk.
+ */
+export declare function upscaleImageToFile(client: VeniceClient, options: UpscaleImageOptions, outputPath: string): Promise<string>;
+export interface RemoveBackgroundOptions {
+    /** Base64-encoded image or data URL */
+    image: string;
+    /** Model override. Default: bria-bg-remover */
+    model?: string;
+}
+export interface RemoveBackgroundResult {
+    base64: string;
+}
+/**
+ * Remove the background from an image.
+ * Returns the image with transparent background as base64 PNG.
+ */
+export declare function removeBackground(client: VeniceClient, options: RemoveBackgroundOptions): Promise<RemoveBackgroundResult>;
+//# sourceMappingURL=edit.d.ts.map

package/dist/venice/edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../src/venice/edit.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAkBhD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CA4C1B;AAID,MAAM,WAAW,mBAAmB;IAClC,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAU7B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,mBAAmB,EAC5B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAajB;AAID,MAAM,WAAW,uBAAuB;IACtC,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CASjC"}

package/dist/venice/edit.js

@@ -0,0 +1,100 @@
+// ---------------------------------------------------------------------------
+// Venice Image Editing, Upscaling, and Background Removal
+//
+// - editImage:           DEPRECATED -- /api/v1/images/edit was disabled May 2025
+// - upscaleImage:        POST /api/v1/image/upscale
+// - removeBackground:    POST /api/v1/image/background-remove
+//
+// For layered multi-image editing, use multi-edit.ts instead.
+// ---------------------------------------------------------------------------
+import { mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+// ---- Constants ------------------------------------------------------------
+const EDIT_PATH = "/api/v1/images/edit";
+const UPSCALE_PATH = "/api/v1/image/upscale";
+const BACKGROUND_REMOVE_PATH = "/api/v1/image/background-remove";
+// The /images/edit endpoint is deprecated; kept for backwards compat only.
+// Anything that goes downstream into Seedance should use the new
+// `seedream-v5-lite` family, so align the default here too.
+const DEFAULT_MODEL = "seedream-v5-lite";
+/**
+ * @deprecated The /images/edit inpainting endpoint was disabled May 19, 2025.
+ * Use multiEditImage from multi-edit.ts instead.
+ */
+export async function editImage(client, options) {
+    const { image, mask, prompt, strength = 0.65, model = DEFAULT_MODEL, steps, cfg_scale, seed, safe_mode, } = options;
+    const body = {
+        image,
+        prompt,
+        strength,
+        model,
+    };
+    if (mask !== undefined)
+        body.mask = mask;
+    if (steps !== undefined)
+        body.steps = steps;
+    if (cfg_scale !== undefined)
+        body.cfg_scale = cfg_scale;
+    if (seed !== undefined)
+        body.seed = seed;
+    if (safe_mode !== undefined)
+        body.safe_mode = safe_mode;
+    const raw = await client.post(EDIT_PATH, body);
+    const rawImages = raw.images ?? [];
+    if (rawImages.length === 0) {
+        throw new Error("Venice API returned an empty images array from the edit endpoint.");
+    }
+    const first = rawImages[0];
+    const b64 = typeof first === "string" ? first : first.b64_json;
+    const imgSeed = typeof first === "object" && first !== null ? first.seed : undefined;
+    return {
+        base64: b64,
+        seed: imgSeed,
+    };
+}
+/**
+ * Upscale an image using Venice's AI upscaling endpoint.
+ * Returns the upscaled image as base64.
+ */
+export async function upscaleImage(client, options) {
+    const body = {
+        image: options.image,
+    };
+    if (options.scale !== undefined)
+        body.scale = options.scale;
+    if (options.model)
+        body.model = options.model;
+    const buffer = await client.postBinary(UPSCALE_PATH, body);
+    return { base64: buffer.toString('base64') };
+}
+/**
+ * Upscale an image and save the result to disk.
+ */
+export async function upscaleImageToFile(client, options, outputPath) {
+    const body = {
+        image: options.image,
+    };
+    if (options.scale !== undefined)
+        body.scale = options.scale;
+    if (options.model)
+        body.model = options.model;
+    const buffer = await client.postBinary(UPSCALE_PATH, body);
+    await mkdir(dirname(outputPath), { recursive: true });
+    const { writeFile } = await import('node:fs/promises');
+    await writeFile(outputPath, buffer);
+    return outputPath;
+}
+/**
+ * Remove the background from an image.
+ * Returns the image with transparent background as base64 PNG.
+ */
+export async function removeBackground(client, options) {
+    const body = {
+        image: options.image,
+    };
+    if (options.model)
+        body.model = options.model;
+    const buffer = await client.postBinary(BACKGROUND_REMOVE_PATH, body);
+    return { base64: buffer.toString('base64') };
+}
+//# sourceMappingURL=edit.js.map

package/dist/venice/edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.js","sourceRoot":"","sources":["../../src/venice/edit.ts"],"names":[],"mappings":"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"}

package/dist/venice/generate.d.ts

@@ -0,0 +1,47 @@
+import type { VeniceClient } from "./client.js";
+import type { ImageGenerateRequest, ImageGenerateResponse, GenerateWithReferencesOptions, GenerateWithReferencesResult } from "./types.js";
+/**
+ * Generate a single image from a text prompt.
+ *
+ * This is a straightforward 1:1 mapping to the Venice `/api/v1/image/generate`
+ * endpoint.  All request fields are forwarded as-is; only `model`, `resolution`,
+ * and `aspect_ratio` receive defaults when omitted.
+ *
+ * @param client  An authenticated {@link VeniceClient} instance.
+ * @param options Request parameters.  At minimum `prompt` is required.
+ * @returns       The full API response including the `images` array.
+ */
+export declare function generateImage(client: VeniceClient, options: Partial<ImageGenerateRequest> & {
+    prompt: string;
+}): Promise<ImageGenerateResponse>;
+/**
+ * Generate a scene image while injecting character face references for
+ * identity consistency across storyboard frames.
+ *
+ * **How it works**
+ *
+ * 1. The caller supplies up to 14 {@link CharacterReference} entries via
+ *    `options.referenceImages`.
+ * 2. The first N entries (where N = `options.faceSlots`, default 5, max 5)
+ *    are treated as **face references**.  For each one a role-assignment line
+ *    is prepended to the prompt so the model knows which reference image
+ *    corresponds to which character:
+ *
+ *    ```
+ *    Image 1: face reference for MARCUS (the detective)
+ *    Image 2: face reference for LENA (the journalist)
+ *    ```
+ *
+ * 3. All reference images (face + non-face) are concatenated as a
+ *    comma-separated base-64 string in the `image` field, which Venice
+ *    interprets as a multi-reference input.
+ *
+ * 4. The fidelity is set to a moderate default (0.35) to allow creative
+ *    freedom while anchoring character likeness.
+ *
+ * @param client  An authenticated {@link VeniceClient} instance.
+ * @param options Generation parameters plus reference images.
+ * @returns       The generated image as base-64 and the seed used.
+ */
+export declare function generateWithReferences(client: VeniceClient, options: GenerateWithReferencesOptions): Promise<GenerateWithReferencesResult>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/venice/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/venice/generate.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,6BAA6B,EAC7B,4BAA4B,EAE7B,MAAM,YAAY,CAAC;AAuBpB;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1D,OAAO,CAAC,qBAAqB,CAAC,CAiChC;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,4BAA4B,CAAC,CAsFvC"}