@ai-sdk/quiverai 0.0.0 → 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# @ai-sdk/quiverai
+
+## 1.0.1
+
+### Patch Changes
+
+- Updated dependencies [942f2f8]
+  - @ai-sdk/provider-utils@4.0.28
+
+## 1.0.0
+
+### Major Changes
+
+- fb477bd: Add `@ai-sdk/quiverai` provider for QuiverAI SVG image generation and vectorization.

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2023 Vercel, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,50 @@
+# AI SDK - QuiverAI Provider
+
+The **QuiverAI provider** for the [AI SDK](https://ai-sdk.dev/docs) adds image generation support for the [QuiverAI](https://quiver.ai/) API. QuiverAI generates SVG documents from text prompts and can also vectorize raster images.
+
+> **Deploying to Vercel?** With Vercel's AI Gateway you can access many models from other providers — no additional packages, API keys, or extra cost. [Get started with AI Gateway](https://vercel.com/ai-gateway).
+
+## Setup
+
+The QuiverAI provider is available in the `@ai-sdk/quiverai` module. You can install it with:
+
+```bash
+npm i @ai-sdk/quiverai
+```
+
+## Skill for Coding Agents
+
+If you use coding agents such as Claude Code or Cursor, we highly recommend adding the AI SDK skill to your repository:
+
+```shell
+npx skills add vercel/ai
+```
+
+## Provider Instance
+
+You can import the default provider instance `quiverai` from `@ai-sdk/quiverai`:
+
+```ts
+import { quiverai } from '@ai-sdk/quiverai';
+```
+
+## Image Generation Example
+
+```ts
+import { quiverai } from '@ai-sdk/quiverai';
+import { generateImage } from 'ai';
+import fs from 'fs';
+
+const { image } = await generateImage({
+  model: quiverai.image('arrow-1.1'),
+  prompt: 'A logo for the next AI Design startup',
+});
+
+const filename = `image-${Date.now()}.svg`;
+fs.writeFileSync(filename, image.uint8Array);
+console.log(`Image saved to ${filename}`);
+```
+
+## Documentation
+
+Please check out the **[QuiverAI provider](https://ai-sdk.dev/providers/ai-sdk-providers/quiverai)** for more information.

package/dist/index.d.ts

@@ -0,0 +1,69 @@
+import { ProviderV3, ImageModelV3 } from '@ai-sdk/provider';
+import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
+import { FetchFunction, InferSchema } from '@ai-sdk/provider-utils';
+
+/**
+ * QuiverAI image model identifier.
+ *
+ * @see https://quiver.ai/
+ */
+type QuiverAIImageModelId = 'arrow-1' | 'arrow-1.1' | 'arrow-1.1-max' | (string & {});
+
+interface QuiverAIProviderSettings {
+    /**
+     * QuiverAI API key. Default value is taken from the `QUIVERAI_API_KEY`
+     * environment variable.
+     */
+    apiKey?: string;
+    /**
+     * Base URL for the API calls. Defaults to `https://api.quiver.ai/v1` and
+     * falls back to the `QUIVERAI_BASE_URL` environment variable.
+     */
+    baseURL?: string;
+    /**
+     * Custom headers to include in the requests.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Custom fetch implementation. You can use it as a middleware to intercept
+     * requests, or to provide a custom fetch implementation for e.g. testing.
+     */
+    fetch?: FetchFunction;
+}
+interface QuiverAIProvider extends ProviderV3 {
+    /**
+     * Creates a model for image generation.
+     */
+    image(modelId: QuiverAIImageModelId): ImageModelV3;
+    /**
+     * Creates a model for image generation.
+     */
+    imageModel(modelId: QuiverAIImageModelId): ImageModelV3;
+    /**
+     * @deprecated Use `embeddingModel` instead.
+     */
+    textEmbeddingModel(modelId: string): never;
+}
+declare function createQuiverAI(options?: QuiverAIProviderSettings): QuiverAIProvider;
+declare const quiverai: QuiverAIProvider;
+
+/**
+ * Provider options schema for QuiverAI image generation.
+ *
+ * @see https://quiver.ai/
+ */
+declare const quiveraiImageModelOptionsSchema: _ai_sdk_provider_utils.LazySchema<{
+    operation?: "generate" | "vectorize" | undefined;
+    instructions?: string | undefined;
+    temperature?: number | undefined;
+    topP?: number | undefined;
+    presencePenalty?: number | null | undefined;
+    maxOutputTokens?: number | undefined;
+    autoCrop?: boolean | undefined;
+    targetSize?: number | undefined;
+}>;
+type QuiverAIImageModelOptions = InferSchema<typeof quiveraiImageModelOptionsSchema>;
+
+declare const VERSION: string;
+
+export { type QuiverAIImageModelId, type QuiverAIImageModelOptions, type QuiverAIProvider, type QuiverAIProviderSettings, VERSION, createQuiverAI, quiverai };

package/dist/index.js

@@ -0,0 +1,351 @@
+// src/quiverai-provider.ts
+import {
+  NoSuchModelError
+} from "@ai-sdk/provider";
+import {
+  loadApiKey,
+  loadOptionalSetting,
+  withoutTrailingSlash,
+  withUserAgentSuffix
+} from "@ai-sdk/provider-utils";
+
+// src/quiverai-image-model.ts
+import {
+  InvalidArgumentError
+} from "@ai-sdk/provider";
+import {
+  combineHeaders,
+  convertUint8ArrayToBase64,
+  createJsonErrorResponseHandler,
+  createJsonResponseHandler,
+  parseProviderOptions,
+  postJsonToApi
+} from "@ai-sdk/provider-utils";
+import { z as z2 } from "zod/v4";
+
+// src/quiverai-image-model-options.ts
+import {
+  lazySchema,
+  zodSchema
+} from "@ai-sdk/provider-utils";
+import { z } from "zod/v4";
+var quiveraiImageModelOptionsSchema = lazySchema(
+  () => zodSchema(
+    z.object({
+      /**
+       * The operation to perform. Defaults to `generate`.
+       *
+       * - `generate`: Text-to-SVG generation. Requires `prompt`.
+       * - `vectorize`: Convert an input raster image into an SVG. Requires a
+       *   single image in `prompt.images` / `files`.
+       */
+      operation: z.enum(["generate", "vectorize"]).optional(),
+      /**
+       * Extra style guidance for prompt-based generation.
+       */
+      instructions: z.string().min(1).optional(),
+      /**
+       * Sampling temperature (0-2).
+       */
+      temperature: z.number().min(0).max(2).optional(),
+      /**
+       * Nucleus sampling top-p (0-1).
+       */
+      topP: z.number().min(0).max(1).optional(),
+      /**
+       * Presence penalty (-2 to 2).
+       */
+      presencePenalty: z.number().min(-2).max(2).nullable().optional(),
+      /**
+       * Maximum number of output tokens (1 - 131072).
+       */
+      maxOutputTokens: z.number().int().min(1).max(131072).optional(),
+      /**
+       * Whether to auto-crop the input image before vectorization.
+       * Only used when `operation` is `vectorize`.
+       */
+      autoCrop: z.boolean().optional(),
+      /**
+       * Target canvas size in pixels for vectorization (128 - 4096).
+       * Only used when `operation` is `vectorize`.
+       */
+      targetSize: z.number().int().min(128).max(4096).optional()
+    })
+  )
+);
+
+// src/quiverai-image-model.ts
+var QuiverAIImageModel = class {
+  constructor(modelId, config) {
+    this.modelId = modelId;
+    this.config = config;
+    this.specificationVersion = "v3";
+    this.maxImagesPerCall = 16;
+  }
+  get provider() {
+    return this.config.provider;
+  }
+  async doGenerate({
+    prompt,
+    n,
+    files,
+    mask,
+    size,
+    aspectRatio,
+    seed,
+    providerOptions,
+    headers,
+    abortSignal
+  }) {
+    var _a, _b, _c, _d, _e, _f;
+    const quiveraiOptions = await parseProviderOptions({
+      provider: "quiverai",
+      providerOptions,
+      schema: quiveraiImageModelOptionsSchema
+    });
+    const operation = (_a = quiveraiOptions == null ? void 0 : quiveraiOptions.operation) != null ? _a : "generate";
+    const warnings = collectWarnings({ size, aspectRatio, seed, mask });
+    const body = buildRequestBody({
+      modelId: this.modelId,
+      n,
+      prompt,
+      files,
+      operation,
+      options: quiveraiOptions != null ? quiveraiOptions : {}
+    });
+    const currentDate = (_d = (_c = (_b = this.config._internal) == null ? void 0 : _b.currentDate) == null ? void 0 : _c.call(_b)) != null ? _d : /* @__PURE__ */ new Date();
+    const combinedHeaders = combineHeaders((_f = (_e = this.config).headers) == null ? void 0 : _f.call(_e), headers);
+    const { value: response, responseHeaders } = await postJsonToApi({
+      url: `${this.config.baseURL}${getOperationPath(operation)}`,
+      headers: combinedHeaders,
+      body,
+      failedResponseHandler: quiveraiFailedResponseHandler,
+      successfulResponseHandler: createJsonResponseHandler(
+        svgGenerationResponseSchema
+      ),
+      abortSignal,
+      fetch: this.config.fetch
+    });
+    const encoder = new TextEncoder();
+    const images = response.data.map((image) => encoder.encode(image.svg));
+    return {
+      images,
+      warnings,
+      providerMetadata: {
+        quiverai: {
+          images: response.data.map((image, index) => ({
+            index,
+            mimeType: image.mime_type
+          }))
+        }
+      },
+      response: {
+        timestamp: response.created ? new Date(response.created * 1e3) : currentDate,
+        modelId: this.modelId,
+        headers: responseHeaders
+      },
+      ...response.usage && {
+        usage: {
+          inputTokens: response.usage.input_tokens,
+          outputTokens: response.usage.output_tokens,
+          totalTokens: response.usage.total_tokens
+        }
+      }
+    };
+  }
+};
+function getOperationPath(operation) {
+  return operation === "generate" ? "/svgs/generations" : "/svgs/vectorizations";
+}
+function getGenerateReferenceLimit(modelId) {
+  return modelId === "arrow-1.1-max" ? 16 : 4;
+}
+function toQuiverAIImageReference(image) {
+  if (image.type === "url") {
+    return { url: image.url };
+  }
+  return {
+    base64: typeof image.data === "string" ? image.data : convertUint8ArrayToBase64(image.data)
+  };
+}
+function buildRequestBody({
+  modelId,
+  n,
+  prompt,
+  files,
+  operation,
+  options
+}) {
+  const sharedOptions = {
+    temperature: options.temperature,
+    top_p: options.topP,
+    presence_penalty: options.presencePenalty,
+    max_output_tokens: options.maxOutputTokens,
+    stream: false
+  };
+  if (operation === "generate") {
+    if (prompt == null || prompt.trim().length === 0) {
+      throw new InvalidArgumentError({
+        argument: "prompt",
+        message: "QuiverAI image generation requires a non-empty prompt for generateImage."
+      });
+    }
+    const references = files == null ? void 0 : files.map(toQuiverAIImageReference);
+    const maxReferences = getGenerateReferenceLimit(modelId);
+    if (references != null && references.length > maxReferences) {
+      throw new InvalidArgumentError({
+        argument: "files",
+        message: `QuiverAI generate supports up to ${maxReferences} reference images for model "${modelId}".`
+      });
+    }
+    return {
+      model: modelId,
+      n,
+      prompt,
+      ...sharedOptions,
+      instructions: options.instructions,
+      references
+    };
+  }
+  if (files == null || files.length === 0) {
+    throw new InvalidArgumentError({
+      argument: "files",
+      message: 'QuiverAI vectorize requires an input image. Pass an image in the generateImage prompt and set providerOptions.quiverai.operation to "vectorize".'
+    });
+  }
+  if (files.length > 1) {
+    throw new InvalidArgumentError({
+      argument: "files",
+      message: "QuiverAI vectorize accepts a single input image."
+    });
+  }
+  return {
+    model: modelId,
+    n,
+    image: toQuiverAIImageReference(files[0]),
+    ...sharedOptions,
+    auto_crop: options.autoCrop,
+    target_size: options.targetSize
+  };
+}
+function collectWarnings({
+  size,
+  aspectRatio,
+  seed,
+  mask
+}) {
+  const warnings = [];
+  if (size != null) {
+    warnings.push({
+      type: "unsupported",
+      feature: "size",
+      details: "QuiverAI SVG generation does not support the `size` option. The setting was ignored."
+    });
+  }
+  if (aspectRatio != null) {
+    warnings.push({
+      type: "unsupported",
+      feature: "aspectRatio",
+      details: "QuiverAI SVG generation does not support the `aspectRatio` option. The setting was ignored."
+    });
+  }
+  if (seed != null) {
+    warnings.push({
+      type: "unsupported",
+      feature: "seed",
+      details: "QuiverAI SVG generation does not support the `seed` option. The setting was ignored."
+    });
+  }
+  if (mask != null) {
+    warnings.push({
+      type: "unsupported",
+      feature: "mask",
+      details: "QuiverAI SVG generation does not support masks. The mask was ignored."
+    });
+  }
+  return warnings;
+}
+var svgUsageSchema = z2.object({
+  total_tokens: z2.number().int().nonnegative(),
+  input_tokens: z2.number().int().nonnegative(),
+  output_tokens: z2.number().int().nonnegative()
+});
+var svgDocumentSchema = z2.object({
+  svg: z2.string().min(1),
+  mime_type: z2.literal("image/svg+xml")
+});
+var svgGenerationResponseSchema = z2.object({
+  id: z2.string().min(1),
+  created: z2.number().int().nonnegative(),
+  data: z2.array(svgDocumentSchema).min(1),
+  usage: svgUsageSchema.nullish()
+});
+var quiveraiErrorSchema = z2.object({
+  status: z2.number().int(),
+  code: z2.string().min(1),
+  message: z2.string().min(1),
+  request_id: z2.string().min(1)
+});
+var quiveraiFailedResponseHandler = createJsonErrorResponseHandler({
+  errorSchema: quiveraiErrorSchema,
+  errorToMessage: (error) => error.message,
+  isRetryable: (response) => response.status === 429 || response.status >= 500
+});
+
+// src/version.ts
+var VERSION = true ? "1.0.1" : "0.0.0-test";
+
+// src/quiverai-provider.ts
+var defaultBaseURL = "https://api.quiver.ai/v1";
+function createQuiverAI(options = {}) {
+  var _a;
+  const baseURL = (_a = withoutTrailingSlash(
+    loadOptionalSetting({
+      settingValue: options.baseURL,
+      environmentVariableName: "QUIVERAI_BASE_URL"
+    })
+  )) != null ? _a : defaultBaseURL;
+  const getHeaders = () => withUserAgentSuffix(
+    {
+      Authorization: `Bearer ${loadApiKey({
+        apiKey: options.apiKey,
+        environmentVariableName: "QUIVERAI_API_KEY",
+        description: "QuiverAI"
+      })}`,
+      ...options.headers
+    },
+    `ai-sdk/quiverai/${VERSION}`
+  );
+  const createImageModel = (modelId) => new QuiverAIImageModel(modelId, {
+    provider: "quiverai.image",
+    baseURL,
+    headers: getHeaders,
+    fetch: options.fetch
+  });
+  const embeddingModel = (modelId) => {
+    throw new NoSuchModelError({
+      modelId,
+      modelType: "embeddingModel"
+    });
+  };
+  return {
+    specificationVersion: "v3",
+    image: createImageModel,
+    imageModel: createImageModel,
+    languageModel: (modelId) => {
+      throw new NoSuchModelError({
+        modelId,
+        modelType: "languageModel"
+      });
+    },
+    embeddingModel,
+    textEmbeddingModel: embeddingModel
+  };
+}
+var quiverai = createQuiverAI();
+export {
+  VERSION,
+  createQuiverAI,
+  quiverai
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/quiverai-provider.ts","../src/quiverai-image-model.ts","../src/quiverai-image-model-options.ts","../src/version.ts"],"sourcesContent":["import {\n  NoSuchModelError,\n  type ImageModelV3,\n  type ProviderV3,\n} from '@ai-sdk/provider';\nimport {\n  loadApiKey,\n  loadOptionalSetting,\n  withoutTrailingSlash,\n  withUserAgentSuffix,\n  type FetchFunction,\n} from '@ai-sdk/provider-utils';\nimport { QuiverAIImageModel } from './quiverai-image-model';\nimport type { QuiverAIImageModelId } from './quiverai-image-settings';\nimport { VERSION } from './version';\n\nexport interface QuiverAIProviderSettings {\n  /**\n   * QuiverAI API key. Default value is taken from the `QUIVERAI_API_KEY`\n   * environment variable.\n   */\n  apiKey?: string;\n\n  /**\n   * Base URL for the API calls. Defaults to `https://api.quiver.ai/v1` and\n   * falls back to the `QUIVERAI_BASE_URL` environment variable.\n   */\n  baseURL?: string;\n\n  /**\n   * Custom headers to include in the requests.\n   */\n  headers?: Record<string, string>;\n\n  /**\n   * Custom fetch implementation. You can use it as a middleware to intercept\n   * requests, or to provide a custom fetch implementation for e.g. testing.\n   */\n  fetch?: FetchFunction;\n}\n\nexport interface QuiverAIProvider extends ProviderV3 {\n  /**\n   * Creates a model for image generation.\n   */\n  image(modelId: QuiverAIImageModelId): ImageModelV3;\n\n  /**\n   * Creates a model for image generation.\n   */\n  imageModel(modelId: QuiverAIImageModelId): ImageModelV3;\n\n  /**\n   * @deprecated Use `embeddingModel` instead.\n   */\n  textEmbeddingModel(modelId: string): never;\n}\n\nconst defaultBaseURL = 'https://api.quiver.ai/v1';\n\nexport function createQuiverAI(\n  options: QuiverAIProviderSettings = {},\n): QuiverAIProvider {\n  const baseURL =\n    withoutTrailingSlash(\n      loadOptionalSetting({\n        settingValue: options.baseURL,\n        environmentVariableName: 'QUIVERAI_BASE_URL',\n      }),\n    ) ?? defaultBaseURL;\n\n  const getHeaders = () =>\n    withUserAgentSuffix(\n      {\n        Authorization: `Bearer ${loadApiKey({\n          apiKey: options.apiKey,\n          environmentVariableName: 'QUIVERAI_API_KEY',\n          description: 'QuiverAI',\n        })}`,\n        ...options.headers,\n      },\n      `ai-sdk/quiverai/${VERSION}`,\n    );\n\n  const createImageModel = (modelId: QuiverAIImageModelId) =>\n    new QuiverAIImageModel(modelId, {\n      provider: 'quiverai.image',\n      baseURL,\n      headers: getHeaders,\n      fetch: options.fetch,\n    });\n\n  const embeddingModel = (modelId: string) => {\n    throw new NoSuchModelError({\n      modelId,\n      modelType: 'embeddingModel',\n    });\n  };\n\n  return {\n    specificationVersion: 'v3',\n    image: createImageModel,\n    imageModel: createImageModel,\n    languageModel: (modelId: string) => {\n      throw new NoSuchModelError({\n        modelId,\n        modelType: 'languageModel',\n      });\n    },\n    embeddingModel,\n    textEmbeddingModel: embeddingModel,\n  };\n}\n\nexport const quiverai = createQuiverAI();\n","import {\n  InvalidArgumentError,\n  type ImageModelV3,\n  type ImageModelV3CallOptions,\n  type ImageModelV3File,\n  type SharedV3Warning,\n} from '@ai-sdk/provider';\nimport {\n  combineHeaders,\n  convertUint8ArrayToBase64,\n  createJsonErrorResponseHandler,\n  createJsonResponseHandler,\n  parseProviderOptions,\n  postJsonToApi,\n  type FetchFunction,\n} from '@ai-sdk/provider-utils';\nimport { z } from 'zod/v4';\nimport {\n  quiveraiImageModelOptionsSchema,\n  type QuiverAIImageModelOptions,\n} from './quiverai-image-model-options';\nimport type {\n  QuiverAIImageModelId,\n  QuiverAIOperation,\n} from './quiverai-image-settings';\n\ninterface QuiverAIImageModelConfig {\n  provider: string;\n  baseURL: string;\n  headers?: () => Record<string, string>;\n  fetch?: FetchFunction;\n  _internal?: {\n    currentDate?: () => Date;\n  };\n}\n\nexport class QuiverAIImageModel implements ImageModelV3 {\n  readonly specificationVersion = 'v3';\n  readonly maxImagesPerCall = 16;\n\n  get provider(): string {\n    return this.config.provider;\n  }\n\n  constructor(\n    readonly modelId: QuiverAIImageModelId,\n    private readonly config: QuiverAIImageModelConfig,\n  ) {}\n\n  async doGenerate({\n    prompt,\n    n,\n    files,\n    mask,\n    size,\n    aspectRatio,\n    seed,\n    providerOptions,\n    headers,\n    abortSignal,\n  }: ImageModelV3CallOptions): Promise<\n    Awaited<ReturnType<ImageModelV3['doGenerate']>>\n  > {\n    const quiveraiOptions = await parseProviderOptions({\n      provider: 'quiverai',\n      providerOptions,\n      schema: quiveraiImageModelOptionsSchema,\n    });\n\n    const operation: QuiverAIOperation =\n      quiveraiOptions?.operation ?? 'generate';\n\n    const warnings = collectWarnings({ size, aspectRatio, seed, mask });\n\n    const body = buildRequestBody({\n      modelId: this.modelId,\n      n,\n      prompt,\n      files,\n      operation,\n      options: quiveraiOptions ?? {},\n    });\n\n    const currentDate = this.config._internal?.currentDate?.() ?? new Date();\n    const combinedHeaders = combineHeaders(this.config.headers?.(), headers);\n\n    const { value: response, responseHeaders } = await postJsonToApi({\n      url: `${this.config.baseURL}${getOperationPath(operation)}`,\n      headers: combinedHeaders,\n      body,\n      failedResponseHandler: quiveraiFailedResponseHandler,\n      successfulResponseHandler: createJsonResponseHandler(\n        svgGenerationResponseSchema,\n      ),\n      abortSignal,\n      fetch: this.config.fetch,\n    });\n\n    const encoder = new TextEncoder();\n    const images = response.data.map(image => encoder.encode(image.svg));\n\n    return {\n      images,\n      warnings,\n      providerMetadata: {\n        quiverai: {\n          images: response.data.map((image, index) => ({\n            index,\n            mimeType: image.mime_type,\n          })),\n        },\n      },\n      response: {\n        timestamp: response.created\n          ? new Date(response.created * 1000)\n          : currentDate,\n        modelId: this.modelId,\n        headers: responseHeaders,\n      },\n      ...(response.usage && {\n        usage: {\n          inputTokens: response.usage.input_tokens,\n          outputTokens: response.usage.output_tokens,\n          totalTokens: response.usage.total_tokens,\n        },\n      }),\n    };\n  }\n}\n\nfunction getOperationPath(operation: QuiverAIOperation) {\n  return operation === 'generate'\n    ? '/svgs/generations'\n    : '/svgs/vectorizations';\n}\n\nfunction getGenerateReferenceLimit(modelId: string) {\n  return modelId === 'arrow-1.1-max' ? 16 : 4;\n}\n\nfunction toQuiverAIImageReference(image: ImageModelV3File) {\n  if (image.type === 'url') {\n    return { url: image.url };\n  }\n  return {\n    base64:\n      typeof image.data === 'string'\n        ? image.data\n        : convertUint8ArrayToBase64(image.data),\n  };\n}\n\nfunction buildRequestBody({\n  modelId,\n  n,\n  prompt,\n  files,\n  operation,\n  options,\n}: {\n  modelId: string;\n  n: number;\n  prompt: string | undefined;\n  files: ImageModelV3File[] | undefined;\n  operation: QuiverAIOperation;\n  options: QuiverAIImageModelOptions;\n}) {\n  const sharedOptions = {\n    temperature: options.temperature,\n    top_p: options.topP,\n    presence_penalty: options.presencePenalty,\n    max_output_tokens: options.maxOutputTokens,\n    stream: false as const,\n  };\n\n  if (operation === 'generate') {\n    if (prompt == null || prompt.trim().length === 0) {\n      throw new InvalidArgumentError({\n        argument: 'prompt',\n        message:\n          'QuiverAI image generation requires a non-empty prompt for generateImage.',\n      });\n    }\n\n    const references = files?.map(toQuiverAIImageReference);\n    const maxReferences = getGenerateReferenceLimit(modelId);\n\n    if (references != null && references.length > maxReferences) {\n      throw new InvalidArgumentError({\n        argument: 'files',\n        message: `QuiverAI generate supports up to ${maxReferences} reference images for model \"${modelId}\".`,\n      });\n    }\n\n    return {\n      model: modelId,\n      n,\n      prompt,\n      ...sharedOptions,\n      instructions: options.instructions,\n      references,\n    };\n  }\n\n  if (files == null || files.length === 0) {\n    throw new InvalidArgumentError({\n      argument: 'files',\n      message:\n        'QuiverAI vectorize requires an input image. Pass an image in the generateImage prompt and set providerOptions.quiverai.operation to \"vectorize\".',\n    });\n  }\n\n  if (files.length > 1) {\n    throw new InvalidArgumentError({\n      argument: 'files',\n      message: 'QuiverAI vectorize accepts a single input image.',\n    });\n  }\n\n  return {\n    model: modelId,\n    n,\n    image: toQuiverAIImageReference(files[0]),\n    ...sharedOptions,\n    auto_crop: options.autoCrop,\n    target_size: options.targetSize,\n  };\n}\n\nfunction collectWarnings({\n  size,\n  aspectRatio,\n  seed,\n  mask,\n}: {\n  size: `${number}x${number}` | undefined;\n  aspectRatio: `${number}:${number}` | undefined;\n  seed: number | undefined;\n  mask: ImageModelV3File | undefined;\n}): SharedV3Warning[] {\n  const warnings: SharedV3Warning[] = [];\n\n  if (size != null) {\n    warnings.push({\n      type: 'unsupported',\n      feature: 'size',\n      details:\n        'QuiverAI SVG generation does not support the `size` option. The setting was ignored.',\n    });\n  }\n\n  if (aspectRatio != null) {\n    warnings.push({\n      type: 'unsupported',\n      feature: 'aspectRatio',\n      details:\n        'QuiverAI SVG generation does not support the `aspectRatio` option. The setting was ignored.',\n    });\n  }\n\n  if (seed != null) {\n    warnings.push({\n      type: 'unsupported',\n      feature: 'seed',\n      details:\n        'QuiverAI SVG generation does not support the `seed` option. The setting was ignored.',\n    });\n  }\n\n  if (mask != null) {\n    warnings.push({\n      type: 'unsupported',\n      feature: 'mask',\n      details:\n        'QuiverAI SVG generation does not support masks. The mask was ignored.',\n    });\n  }\n\n  return warnings;\n}\n\n// Limited schemas focused on what is needed for the implementation.\n// This approach limits breakages when the API changes and keeps the\n// response handler efficient.\nconst svgUsageSchema = z.object({\n  total_tokens: z.number().int().nonnegative(),\n  input_tokens: z.number().int().nonnegative(),\n  output_tokens: z.number().int().nonnegative(),\n});\n\nconst svgDocumentSchema = z.object({\n  svg: z.string().min(1),\n  mime_type: z.literal('image/svg+xml'),\n});\n\nconst svgGenerationResponseSchema = z.object({\n  id: z.string().min(1),\n  created: z.number().int().nonnegative(),\n  data: z.array(svgDocumentSchema).min(1),\n  usage: svgUsageSchema.nullish(),\n});\n\nconst quiveraiErrorSchema = z.object({\n  status: z.number().int(),\n  code: z.string().min(1),\n  message: z.string().min(1),\n  request_id: z.string().min(1),\n});\n\nexport const quiveraiFailedResponseHandler = createJsonErrorResponseHandler({\n  errorSchema: quiveraiErrorSchema,\n  errorToMessage: error => error.message,\n  isRetryable: response => response.status === 429 || response.status >= 500,\n});\n","import {\n  lazySchema,\n  zodSchema,\n  type InferSchema,\n} from '@ai-sdk/provider-utils';\nimport { z } from 'zod/v4';\n\n/**\n * Provider options schema for QuiverAI image generation.\n *\n * @see https://quiver.ai/\n */\nexport const quiveraiImageModelOptionsSchema = lazySchema(() =>\n  zodSchema(\n    z.object({\n      /**\n       * The operation to perform. Defaults to `generate`.\n       *\n       * - `generate`: Text-to-SVG generation. Requires `prompt`.\n       * - `vectorize`: Convert an input raster image into an SVG. Requires a\n       *   single image in `prompt.images` / `files`.\n       */\n      operation: z.enum(['generate', 'vectorize']).optional(),\n\n      /**\n       * Extra style guidance for prompt-based generation.\n       */\n      instructions: z.string().min(1).optional(),\n\n      /**\n       * Sampling temperature (0-2).\n       */\n      temperature: z.number().min(0).max(2).optional(),\n\n      /**\n       * Nucleus sampling top-p (0-1).\n       */\n      topP: z.number().min(0).max(1).optional(),\n\n      /**\n       * Presence penalty (-2 to 2).\n       */\n      presencePenalty: z.number().min(-2).max(2).nullable().optional(),\n\n      /**\n       * Maximum number of output tokens (1 - 131072).\n       */\n      maxOutputTokens: z.number().int().min(1).max(131072).optional(),\n\n      /**\n       * Whether to auto-crop the input image before vectorization.\n       * Only used when `operation` is `vectorize`.\n       */\n      autoCrop: z.boolean().optional(),\n\n      /**\n       * Target canvas size in pixels for vectorization (128 - 4096).\n       * Only used when `operation` is `vectorize`.\n       */\n      targetSize: z.number().int().min(128).max(4096).optional(),\n    }),\n  ),\n);\n\nexport type QuiverAIImageModelOptions = InferSchema<\n  typeof quiveraiImageModelOptionsSchema\n>;\n","// Version string of this package injected at build time.\ndeclare const __PACKAGE_VERSION__: string | undefined;\nexport const VERSION: string =\n  typeof __PACKAGE_VERSION__ !== 'undefined'\n    ? __PACKAGE_VERSION__\n    : '0.0.0-test';\n"],"mappings":";AAAA;AAAA,EACE;AAAA,OAGK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;;;ACXP;AAAA,EACE;AAAA,OAKK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,KAAAA,UAAS;;;AChBlB;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AACP,SAAS,SAAS;AAOX,IAAM,kCAAkC;AAAA,EAAW,MACxD;AAAA,IACE,EAAE,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAQP,WAAW,EAAE,KAAK,CAAC,YAAY,WAAW,CAAC,EAAE,SAAS;AAAA;AAAA;AAAA;AAAA,MAKtD,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS;AAAA;AAAA;AAAA;AAAA,MAKzC,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,SAAS;AAAA;AAAA;AAAA;AAAA,MAK/C,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,SAAS;AAAA;AAAA;AAAA;AAAA,MAKxC,iBAAiB,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS;AAAA;AAAA;AAAA;AAAA,MAK/D,iBAAiB,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,MAAM,EAAE,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA,MAM9D,UAAU,EAAE,QAAQ,EAAE,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA,MAM/B,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,IAAI,IAAI,EAAE,SAAS;AAAA,IAC3D,CAAC;AAAA,EACH;AACF;;;AD1BO,IAAM,qBAAN,MAAiD;AAAA,EAQtD,YACW,SACQ,QACjB;AAFS;AACQ;AATnB,SAAS,uBAAuB;AAChC,SAAS,mBAAmB;AAAA,EASzB;AAAA,EAPH,IAAI,WAAmB;AACrB,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA,EAOA,MAAM,WAAW;AAAA,IACf;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAEE;AA9DJ;AA+DI,UAAM,kBAAkB,MAAM,qBAAqB;AAAA,MACjD,UAAU;AAAA,MACV;AAAA,MACA,QAAQ;AAAA,IACV,CAAC;AAED,UAAM,aACJ,wDAAiB,cAAjB,YAA8B;AAEhC,UAAM,WAAW,gBAAgB,EAAE,MAAM,aAAa,MAAM,KAAK,CAAC;AAElE,UAAM,OAAO,iBAAiB;AAAA,MAC5B,SAAS,KAAK;AAAA,MACd;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,SAAS,4CAAmB,CAAC;AAAA,IAC/B,CAAC;AAED,UAAM,eAAc,sBAAK,OAAO,cAAZ,mBAAuB,gBAAvB,4CAA0C,oBAAI,KAAK;AACvE,UAAM,kBAAkB,gBAAe,gBAAK,QAAO,YAAZ,6BAAyB,OAAO;AAEvE,UAAM,EAAE,OAAO,UAAU,gBAAgB,IAAI,MAAM,cAAc;AAAA,MAC/D,KAAK,GAAG,KAAK,OAAO,OAAO,GAAG,iBAAiB,SAAS,CAAC;AAAA,MACzD,SAAS;AAAA,MACT;AAAA,MACA,uBAAuB;AAAA,MACvB,2BAA2B;AAAA,QACzB;AAAA,MACF;AAAA,MACA;AAAA,MACA,OAAO,KAAK,OAAO;AAAA,IACrB,CAAC;AAED,UAAM,UAAU,IAAI,YAAY;AAChC,UAAM,SAAS,SAAS,KAAK,IAAI,WAAS,QAAQ,OAAO,MAAM,GAAG,CAAC;AAEnE,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA,kBAAkB;AAAA,QAChB,UAAU;AAAA,UACR,QAAQ,SAAS,KAAK,IAAI,CAAC,OAAO,WAAW;AAAA,YAC3C;AAAA,YACA,UAAU,MAAM;AAAA,UAClB,EAAE;AAAA,QACJ;AAAA,MACF;AAAA,MACA,UAAU;AAAA,QACR,WAAW,SAAS,UAChB,IAAI,KAAK,SAAS,UAAU,GAAI,IAChC;AAAA,QACJ,SAAS,KAAK;AAAA,QACd,SAAS;AAAA,MACX;AAAA,MACA,GAAI,SAAS,SAAS;AAAA,QACpB,OAAO;AAAA,UACL,aAAa,SAAS,MAAM;AAAA,UAC5B,cAAc,SAAS,MAAM;AAAA,UAC7B,aAAa,SAAS,MAAM;AAAA,QAC9B;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAEA,SAAS,iBAAiB,WAA8B;AACtD,SAAO,cAAc,aACjB,sBACA;AACN;AAEA,SAAS,0BAA0B,SAAiB;AAClD,SAAO,YAAY,kBAAkB,KAAK;AAC5C;AAEA,SAAS,yBAAyB,OAAyB;AACzD,MAAI,MAAM,SAAS,OAAO;AACxB,WAAO,EAAE,KAAK,MAAM,IAAI;AAAA,EAC1B;AACA,SAAO;AAAA,IACL,QACE,OAAO,MAAM,SAAS,WAClB,MAAM,OACN,0BAA0B,MAAM,IAAI;AAAA,EAC5C;AACF;AAEA,SAAS,iBAAiB;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAOG;AACD,QAAM,gBAAgB;AAAA,IACpB,aAAa,QAAQ;AAAA,IACrB,OAAO,QAAQ;AAAA,IACf,kBAAkB,QAAQ;AAAA,IAC1B,mBAAmB,QAAQ;AAAA,IAC3B,QAAQ;AAAA,EACV;AAEA,MAAI,cAAc,YAAY;AAC5B,QAAI,UAAU,QAAQ,OAAO,KAAK,EAAE,WAAW,GAAG;AAChD,YAAM,IAAI,qBAAqB;AAAA,QAC7B,UAAU;AAAA,QACV,SACE;AAAA,MACJ,CAAC;AAAA,IACH;AAEA,UAAM,aAAa,+BAAO,IAAI;AAC9B,UAAM,gBAAgB,0BAA0B,OAAO;AAEvD,QAAI,cAAc,QAAQ,WAAW,SAAS,eAAe;AAC3D,YAAM,IAAI,qBAAqB;AAAA,QAC7B,UAAU;AAAA,QACV,SAAS,oCAAoC,aAAa,gCAAgC,OAAO;AAAA,MACnG,CAAC;AAAA,IACH;AAEA,WAAO;AAAA,MACL,OAAO;AAAA,MACP;AAAA,MACA;AAAA,MACA,GAAG;AAAA,MACH,cAAc,QAAQ;AAAA,MACtB;AAAA,IACF;AAAA,EACF;AAEA,MAAI,SAAS,QAAQ,MAAM,WAAW,GAAG;AACvC,UAAM,IAAI,qBAAqB;AAAA,MAC7B,UAAU;AAAA,MACV,SACE;AAAA,IACJ,CAAC;AAAA,EACH;AAEA,MAAI,MAAM,SAAS,GAAG;AACpB,UAAM,IAAI,qBAAqB;AAAA,MAC7B,UAAU;AAAA,MACV,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAEA,SAAO;AAAA,IACL,OAAO;AAAA,IACP;AAAA,IACA,OAAO,yBAAyB,MAAM,CAAC,CAAC;AAAA,IACxC,GAAG;AAAA,IACH,WAAW,QAAQ;AAAA,IACnB,aAAa,QAAQ;AAAA,EACvB;AACF;AAEA,SAAS,gBAAgB;AAAA,EACvB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAKsB;AACpB,QAAM,WAA8B,CAAC;AAErC,MAAI,QAAQ,MAAM;AAChB,aAAS,KAAK;AAAA,MACZ,MAAM;AAAA,MACN,SAAS;AAAA,MACT,SACE;AAAA,IACJ,CAAC;AAAA,EACH;AAEA,MAAI,eAAe,MAAM;AACvB,aAAS,KAAK;AAAA,MACZ,MAAM;AAAA,MACN,SAAS;AAAA,MACT,SACE;AAAA,IACJ,CAAC;AAAA,EACH;AAEA,MAAI,QAAQ,MAAM;AAChB,aAAS,KAAK;AAAA,MACZ,MAAM;AAAA,MACN,SAAS;AAAA,MACT,SACE;AAAA,IACJ,CAAC;AAAA,EACH;AAEA,MAAI,QAAQ,MAAM;AAChB,aAAS,KAAK;AAAA,MACZ,MAAM;AAAA,MACN,SAAS;AAAA,MACT,SACE;AAAA,IACJ,CAAC;AAAA,EACH;AAEA,SAAO;AACT;AAKA,IAAM,iBAAiBC,GAAE,OAAO;AAAA,EAC9B,cAAcA,GAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,EAC3C,cAAcA,GAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,EAC3C,eAAeA,GAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAC9C,CAAC;AAED,IAAM,oBAAoBA,GAAE,OAAO;AAAA,EACjC,KAAKA,GAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACrB,WAAWA,GAAE,QAAQ,eAAe;AACtC,CAAC;AAED,IAAM,8BAA8BA,GAAE,OAAO;AAAA,EAC3C,IAAIA,GAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACpB,SAASA,GAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,EACtC,MAAMA,GAAE,MAAM,iBAAiB,EAAE,IAAI,CAAC;AAAA,EACtC,OAAO,eAAe,QAAQ;AAChC,CAAC;AAED,IAAM,sBAAsBA,GAAE,OAAO;AAAA,EACnC,QAAQA,GAAE,OAAO,EAAE,IAAI;AAAA,EACvB,MAAMA,GAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACtB,SAASA,GAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACzB,YAAYA,GAAE,OAAO,EAAE,IAAI,CAAC;AAC9B,CAAC;AAEM,IAAM,gCAAgC,+BAA+B;AAAA,EAC1E,aAAa;AAAA,EACb,gBAAgB,WAAS,MAAM;AAAA,EAC/B,aAAa,cAAY,SAAS,WAAW,OAAO,SAAS,UAAU;AACzE,CAAC;;;AEvTM,IAAM,UACX,OACI,UACA;;;AHqDN,IAAM,iBAAiB;AAEhB,SAAS,eACd,UAAoC,CAAC,GACnB;AA9DpB;AA+DE,QAAM,WACJ;AAAA,IACE,oBAAoB;AAAA,MAClB,cAAc,QAAQ;AAAA,MACtB,yBAAyB;AAAA,IAC3B,CAAC;AAAA,EACH,MALA,YAKK;AAEP,QAAM,aAAa,MACjB;AAAA,IACE;AAAA,MACE,eAAe,UAAU,WAAW;AAAA,QAClC,QAAQ,QAAQ;AAAA,QAChB,yBAAyB;AAAA,QACzB,aAAa;AAAA,MACf,CAAC,CAAC;AAAA,MACF,GAAG,QAAQ;AAAA,IACb;AAAA,IACA,mBAAmB,OAAO;AAAA,EAC5B;AAEF,QAAM,mBAAmB,CAAC,YACxB,IAAI,mBAAmB,SAAS;AAAA,IAC9B,UAAU;AAAA,IACV;AAAA,IACA,SAAS;AAAA,IACT,OAAO,QAAQ;AAAA,EACjB,CAAC;AAEH,QAAM,iBAAiB,CAAC,YAAoB;AAC1C,UAAM,IAAI,iBAAiB;AAAA,MACzB;AAAA,MACA,WAAW;AAAA,IACb,CAAC;AAAA,EACH;AAEA,SAAO;AAAA,IACL,sBAAsB;AAAA,IACtB,OAAO;AAAA,IACP,YAAY;AAAA,IACZ,eAAe,CAAC,YAAoB;AAClC,YAAM,IAAI,iBAAiB;AAAA,QACzB;AAAA,QACA,WAAW;AAAA,MACb,CAAC;AAAA,IACH;AAAA,IACA;AAAA,IACA,oBAAoB;AAAA,EACtB;AACF;AAEO,IAAM,WAAW,eAAe;","names":["z","z"]}

package/docs/180-quiverai.mdx

@@ -0,0 +1,204 @@
+---
+title: QuiverAI
+description: Learn how to use QuiverAI models with the AI SDK.
+---
+
+# QuiverAI Provider
+
+[QuiverAI](https://quiver.ai/) generates SVG documents directly from text prompts and can also vectorize raster images into clean SVGs. The QuiverAI provider for the AI SDK exposes both operations through `generateImage`.
+
+## Setup
+
+The QuiverAI provider is available via the `@ai-sdk/quiverai` module. You can install it with
+
+<Tabs items={['pnpm', 'npm', 'yarn', 'bun']}>
+  <Tab>
+    <Snippet text="pnpm add @ai-sdk/quiverai" dark />
+  </Tab>
+  <Tab>
+    <Snippet text="npm install @ai-sdk/quiverai" dark />
+  </Tab>
+  <Tab>
+    <Snippet text="yarn add @ai-sdk/quiverai" dark />
+  </Tab>
+
+  <Tab>
+    <Snippet text="bun add @ai-sdk/quiverai" dark />
+  </Tab>
+</Tabs>
+
+## Provider Instance
+
+You can import the default provider instance `quiverai` from `@ai-sdk/quiverai`:
+
+```ts
+import { quiverai } from '@ai-sdk/quiverai';
+```
+
+If you need a customized setup, you can import `createQuiverAI` and create a provider instance with your settings:
+
+```ts
+import { createQuiverAI } from '@ai-sdk/quiverai';
+
+const quiverai = createQuiverAI({
+  apiKey: 'your-api-key', // optional, defaults to QUIVERAI_API_KEY environment variable
+  baseURL: 'custom-url', // optional, defaults to QUIVERAI_BASE_URL or https://api.quiver.ai/v1
+  headers: {
+    /* custom headers */
+  }, // optional
+});
+```
+
+You can use the following optional settings to customize the QuiverAI provider instance:
+
+- **baseURL** _string_
+
+  Use a different URL prefix for API calls, e.g. to use proxy servers.
+  The default prefix is `https://api.quiver.ai/v1`. It also reads `QUIVERAI_BASE_URL` from the environment.
+
+- **apiKey** _string_
+
+  API key that is sent as a `Bearer` token in the `Authorization` header.
+  It defaults to the `QUIVERAI_API_KEY` environment variable.
+
+- **headers** _Record&lt;string,string&gt;_
+
+  Custom headers to include in the requests.
+
+- **fetch** _(input: RequestInfo, init?: RequestInit) => Promise&lt;Response&gt;_
+
+  Custom [fetch](https://developer.mozilla.org/en-US/docs/Web/API/fetch) implementation.
+  You can use it as a middleware to intercept requests,
+  or to provide a custom fetch implementation for e.g. testing.
+
+## Image Models
+
+You can create QuiverAI image models using the `.image()` factory method.
+For more on image generation with the AI SDK see [generateImage()](/docs/reference/ai-sdk-core/generate-image).
+
+### Basic Usage
+
+```ts
+import { quiverai } from '@ai-sdk/quiverai';
+import { generateImage } from 'ai';
+import fs from 'fs';
+
+const { image } = await generateImage({
+  model: quiverai.image('arrow-1.1'),
+  prompt: 'A logo for the next AI Design startup',
+});
+
+const filename = `image-${Date.now()}.svg`;
+fs.writeFileSync(filename, image.uint8Array);
+console.log(`Saved SVG to ${filename}`);
+```
+
+QuiverAI returns SVG documents. The generated SVG bytes are available through `result.image.uint8Array` (or `result.images` when generating multiple).
+
+### Model Capabilities
+
+QuiverAI exposes three Arrow models:
+
+| Model           | Description                                                                      |
+| --------------- | -------------------------------------------------------------------------------- |
+| `arrow-1`       | Base text-to-SVG model. Accepts up to 4 reference images.                        |
+| `arrow-1.1`     | Improved text-to-SVG model. Accepts up to 4 reference images.                    |
+| `arrow-1.1-max` | Higher quality variant with extended context. Accepts up to 16 reference images. |
+
+### Provider Options
+
+You can fine-tune the request using `providerOptions.quiverai`:
+
+```ts
+import { quiverai, type QuiverAIImageModelOptions } from '@ai-sdk/quiverai';
+import { generateImage } from 'ai';
+
+await generateImage({
+  model: quiverai.image('arrow-1.1'),
+  prompt: 'A geometric unicorn icon',
+  providerOptions: {
+    quiverai: {
+      instructions: 'Use a flat monochrome style with clean geometry.',
+      temperature: 0.4,
+      topP: 0.95,
+      maxOutputTokens: 4096,
+    } satisfies QuiverAIImageModelOptions,
+  },
+});
+```
+
+Supported options:
+
+- **operation** _'generate' | 'vectorize'_
+
+  Choose between text-to-SVG generation (`generate`, default) and image-to-SVG vectorization (`vectorize`).
+
+- **instructions** _string_
+
+  Extra style guidance for prompt-based generation.
+
+- **temperature** _number_ (0-2)
+
+  Sampling temperature.
+
+- **topP** _number_ (0-1)
+
+  Nucleus sampling top-p value.
+
+- **presencePenalty** _number_ (-2 to 2)
+
+  Presence penalty.
+
+- **maxOutputTokens** _number_ (1-131072)
+
+  Maximum number of output tokens.
+
+- **autoCrop** _boolean_
+
+  When vectorizing, automatically crop the input image. Only used with `operation: 'vectorize'`.
+
+- **targetSize** _number_ (128-4096)
+
+  When vectorizing, target canvas size in pixels. Only used with `operation: 'vectorize'`.
+
+### Reference Images
+
+Pass reference images through `prompt.images`:
+
+```ts
+await generateImage({
+  model: quiverai.image('arrow-1.1'),
+  prompt: {
+    text: 'A geometric unicorn icon',
+    images: ['https://example.com/reference-1.png'],
+  },
+});
+```
+
+`arrow-1` and `arrow-1.1` accept up to 4 reference images. `arrow-1.1-max` accepts up to 16.
+
+### Vectorizing a Raster Image
+
+Set `operation` to `vectorize` and pass a single image in `prompt.images`:
+
+```ts
+import { quiverai, type QuiverAIImageModelOptions } from '@ai-sdk/quiverai';
+import { generateImage } from 'ai';
+import fs from 'fs';
+
+const { image } = await generateImage({
+  model: quiverai.image('arrow-1.1'),
+  prompt: {
+    images: [fs.readFileSync('./logo.png')],
+  },
+  providerOptions: {
+    quiverai: {
+      operation: 'vectorize',
+      autoCrop: true,
+      targetSize: 1024,
+    } satisfies QuiverAIImageModelOptions,
+  },
+});
+
+fs.writeFileSync('logo.svg', image.uint8Array);
+```

package/package.json

@@ -1 +1,76 @@
-{"name":"@ai-sdk/quiverai","version":"0.0.0"}
+{
+  "name": "@ai-sdk/quiverai",
+  "version": "1.0.1",
+  "type": "module",
+  "license": "Apache-2.0",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/**/*",
+    "docs/**/*",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test-d.ts",
+    "!src/**/__snapshots__",
+    "!src/**/__fixtures__",
+    "CHANGELOG.md",
+    "README.md"
+  ],
+  "directories": {
+    "doc": "./docs"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@ai-sdk/provider": "3.0.10",
+    "@ai-sdk/provider-utils": "4.0.28"
+  },
+  "devDependencies": {
+    "@types/node": "20.17.24",
+    "tsup": "^8.5.1",
+    "typescript": "5.8.3",
+    "zod": "3.25.76",
+    "@ai-sdk/test-server": "1.0.5",
+    "@vercel/ai-tsconfig": "0.0.0"
+  },
+  "peerDependencies": {
+    "zod": "^3.25.76 || ^4.1.8"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "homepage": "https://ai-sdk.dev/docs",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vercel/ai",
+    "directory": "packages/quiverai"
+  },
+  "bugs": {
+    "url": "https://github.com/vercel/ai/issues"
+  },
+  "keywords": [
+    "ai"
+  ],
+  "scripts": {
+    "build": "pnpm clean && tsup --tsconfig tsconfig.build.json",
+    "build:watch": "pnpm clean && tsup --watch",
+    "clean": "del-cli dist docs *.tsbuildinfo",
+    "type-check": "tsc --build",
+    "test": "pnpm test:node && pnpm test:edge",
+    "test:update": "pnpm test:node -u",
+    "test:watch": "vitest --config vitest.node.config.js",
+    "test:edge": "vitest --config vitest.edge.config.js --run",
+    "test:node": "vitest --config vitest.node.config.js --run"
+  }
+}

package/src/index.ts

@@ -0,0 +1,8 @@
+export { createQuiverAI, quiverai } from './quiverai-provider';
+export type {
+  QuiverAIProvider,
+  QuiverAIProviderSettings,
+} from './quiverai-provider';
+export type { QuiverAIImageModelId } from './quiverai-image-settings';
+export type { QuiverAIImageModelOptions } from './quiverai-image-model-options';
+export { VERSION } from './version';

package/src/quiverai-image-model-options.ts

@@ -0,0 +1,67 @@
+import {
+  lazySchema,
+  zodSchema,
+  type InferSchema,
+} from '@ai-sdk/provider-utils';
+import { z } from 'zod/v4';
+
+/**
+ * Provider options schema for QuiverAI image generation.
+ *
+ * @see https://quiver.ai/
+ */
+export const quiveraiImageModelOptionsSchema = lazySchema(() =>
+  zodSchema(
+    z.object({
+      /**
+       * The operation to perform. Defaults to `generate`.
+       *
+       * - `generate`: Text-to-SVG generation. Requires `prompt`.
+       * - `vectorize`: Convert an input raster image into an SVG. Requires a
+       *   single image in `prompt.images` / `files`.
+       */
+      operation: z.enum(['generate', 'vectorize']).optional(),
+
+      /**
+       * Extra style guidance for prompt-based generation.
+       */
+      instructions: z.string().min(1).optional(),
+
+      /**
+       * Sampling temperature (0-2).
+       */
+      temperature: z.number().min(0).max(2).optional(),
+
+      /**
+       * Nucleus sampling top-p (0-1).
+       */
+      topP: z.number().min(0).max(1).optional(),
+
+      /**
+       * Presence penalty (-2 to 2).
+       */
+      presencePenalty: z.number().min(-2).max(2).nullable().optional(),
+
+      /**
+       * Maximum number of output tokens (1 - 131072).
+       */
+      maxOutputTokens: z.number().int().min(1).max(131072).optional(),
+
+      /**
+       * Whether to auto-crop the input image before vectorization.
+       * Only used when `operation` is `vectorize`.
+       */
+      autoCrop: z.boolean().optional(),
+
+      /**
+       * Target canvas size in pixels for vectorization (128 - 4096).
+       * Only used when `operation` is `vectorize`.
+       */
+      targetSize: z.number().int().min(128).max(4096).optional(),
+    }),
+  ),
+);
+
+export type QuiverAIImageModelOptions = InferSchema<
+  typeof quiveraiImageModelOptionsSchema
+>;

package/src/quiverai-image-model.ts

@@ -0,0 +1,314 @@
+import {
+  InvalidArgumentError,
+  type ImageModelV3,
+  type ImageModelV3CallOptions,
+  type ImageModelV3File,
+  type SharedV3Warning,
+} from '@ai-sdk/provider';
+import {
+  combineHeaders,
+  convertUint8ArrayToBase64,
+  createJsonErrorResponseHandler,
+  createJsonResponseHandler,
+  parseProviderOptions,
+  postJsonToApi,
+  type FetchFunction,
+} from '@ai-sdk/provider-utils';
+import { z } from 'zod/v4';
+import {
+  quiveraiImageModelOptionsSchema,
+  type QuiverAIImageModelOptions,
+} from './quiverai-image-model-options';
+import type {
+  QuiverAIImageModelId,
+  QuiverAIOperation,
+} from './quiverai-image-settings';
+
+interface QuiverAIImageModelConfig {
+  provider: string;
+  baseURL: string;
+  headers?: () => Record<string, string>;
+  fetch?: FetchFunction;
+  _internal?: {
+    currentDate?: () => Date;
+  };
+}
+
+export class QuiverAIImageModel implements ImageModelV3 {
+  readonly specificationVersion = 'v3';
+  readonly maxImagesPerCall = 16;
+
+  get provider(): string {
+    return this.config.provider;
+  }
+
+  constructor(
+    readonly modelId: QuiverAIImageModelId,
+    private readonly config: QuiverAIImageModelConfig,
+  ) {}
+
+  async doGenerate({
+    prompt,
+    n,
+    files,
+    mask,
+    size,
+    aspectRatio,
+    seed,
+    providerOptions,
+    headers,
+    abortSignal,
+  }: ImageModelV3CallOptions): Promise<
+    Awaited<ReturnType<ImageModelV3['doGenerate']>>
+  > {
+    const quiveraiOptions = await parseProviderOptions({
+      provider: 'quiverai',
+      providerOptions,
+      schema: quiveraiImageModelOptionsSchema,
+    });
+
+    const operation: QuiverAIOperation =
+      quiveraiOptions?.operation ?? 'generate';
+
+    const warnings = collectWarnings({ size, aspectRatio, seed, mask });
+
+    const body = buildRequestBody({
+      modelId: this.modelId,
+      n,
+      prompt,
+      files,
+      operation,
+      options: quiveraiOptions ?? {},
+    });
+
+    const currentDate = this.config._internal?.currentDate?.() ?? new Date();
+    const combinedHeaders = combineHeaders(this.config.headers?.(), headers);
+
+    const { value: response, responseHeaders } = await postJsonToApi({
+      url: `${this.config.baseURL}${getOperationPath(operation)}`,
+      headers: combinedHeaders,
+      body,
+      failedResponseHandler: quiveraiFailedResponseHandler,
+      successfulResponseHandler: createJsonResponseHandler(
+        svgGenerationResponseSchema,
+      ),
+      abortSignal,
+      fetch: this.config.fetch,
+    });
+
+    const encoder = new TextEncoder();
+    const images = response.data.map(image => encoder.encode(image.svg));
+
+    return {
+      images,
+      warnings,
+      providerMetadata: {
+        quiverai: {
+          images: response.data.map((image, index) => ({
+            index,
+            mimeType: image.mime_type,
+          })),
+        },
+      },
+      response: {
+        timestamp: response.created
+          ? new Date(response.created * 1000)
+          : currentDate,
+        modelId: this.modelId,
+        headers: responseHeaders,
+      },
+      ...(response.usage && {
+        usage: {
+          inputTokens: response.usage.input_tokens,
+          outputTokens: response.usage.output_tokens,
+          totalTokens: response.usage.total_tokens,
+        },
+      }),
+    };
+  }
+}
+
+function getOperationPath(operation: QuiverAIOperation) {
+  return operation === 'generate'
+    ? '/svgs/generations'
+    : '/svgs/vectorizations';
+}
+
+function getGenerateReferenceLimit(modelId: string) {
+  return modelId === 'arrow-1.1-max' ? 16 : 4;
+}
+
+function toQuiverAIImageReference(image: ImageModelV3File) {
+  if (image.type === 'url') {
+    return { url: image.url };
+  }
+  return {
+    base64:
+      typeof image.data === 'string'
+        ? image.data
+        : convertUint8ArrayToBase64(image.data),
+  };
+}
+
+function buildRequestBody({
+  modelId,
+  n,
+  prompt,
+  files,
+  operation,
+  options,
+}: {
+  modelId: string;
+  n: number;
+  prompt: string | undefined;
+  files: ImageModelV3File[] | undefined;
+  operation: QuiverAIOperation;
+  options: QuiverAIImageModelOptions;
+}) {
+  const sharedOptions = {
+    temperature: options.temperature,
+    top_p: options.topP,
+    presence_penalty: options.presencePenalty,
+    max_output_tokens: options.maxOutputTokens,
+    stream: false as const,
+  };
+
+  if (operation === 'generate') {
+    if (prompt == null || prompt.trim().length === 0) {
+      throw new InvalidArgumentError({
+        argument: 'prompt',
+        message:
+          'QuiverAI image generation requires a non-empty prompt for generateImage.',
+      });
+    }
+
+    const references = files?.map(toQuiverAIImageReference);
+    const maxReferences = getGenerateReferenceLimit(modelId);
+
+    if (references != null && references.length > maxReferences) {
+      throw new InvalidArgumentError({
+        argument: 'files',
+        message: `QuiverAI generate supports up to ${maxReferences} reference images for model "${modelId}".`,
+      });
+    }
+
+    return {
+      model: modelId,
+      n,
+      prompt,
+      ...sharedOptions,
+      instructions: options.instructions,
+      references,
+    };
+  }
+
+  if (files == null || files.length === 0) {
+    throw new InvalidArgumentError({
+      argument: 'files',
+      message:
+        'QuiverAI vectorize requires an input image. Pass an image in the generateImage prompt and set providerOptions.quiverai.operation to "vectorize".',
+    });
+  }
+
+  if (files.length > 1) {
+    throw new InvalidArgumentError({
+      argument: 'files',
+      message: 'QuiverAI vectorize accepts a single input image.',
+    });
+  }
+
+  return {
+    model: modelId,
+    n,
+    image: toQuiverAIImageReference(files[0]),
+    ...sharedOptions,
+    auto_crop: options.autoCrop,
+    target_size: options.targetSize,
+  };
+}
+
+function collectWarnings({
+  size,
+  aspectRatio,
+  seed,
+  mask,
+}: {
+  size: `${number}x${number}` | undefined;
+  aspectRatio: `${number}:${number}` | undefined;
+  seed: number | undefined;
+  mask: ImageModelV3File | undefined;
+}): SharedV3Warning[] {
+  const warnings: SharedV3Warning[] = [];
+
+  if (size != null) {
+    warnings.push({
+      type: 'unsupported',
+      feature: 'size',
+      details:
+        'QuiverAI SVG generation does not support the `size` option. The setting was ignored.',
+    });
+  }
+
+  if (aspectRatio != null) {
+    warnings.push({
+      type: 'unsupported',
+      feature: 'aspectRatio',
+      details:
+        'QuiverAI SVG generation does not support the `aspectRatio` option. The setting was ignored.',
+    });
+  }
+
+  if (seed != null) {
+    warnings.push({
+      type: 'unsupported',
+      feature: 'seed',
+      details:
+        'QuiverAI SVG generation does not support the `seed` option. The setting was ignored.',
+    });
+  }
+
+  if (mask != null) {
+    warnings.push({
+      type: 'unsupported',
+      feature: 'mask',
+      details:
+        'QuiverAI SVG generation does not support masks. The mask was ignored.',
+    });
+  }
+
+  return warnings;
+}
+
+// Limited schemas focused on what is needed for the implementation.
+// This approach limits breakages when the API changes and keeps the
+// response handler efficient.
+const svgUsageSchema = z.object({
+  total_tokens: z.number().int().nonnegative(),
+  input_tokens: z.number().int().nonnegative(),
+  output_tokens: z.number().int().nonnegative(),
+});
+
+const svgDocumentSchema = z.object({
+  svg: z.string().min(1),
+  mime_type: z.literal('image/svg+xml'),
+});
+
+const svgGenerationResponseSchema = z.object({
+  id: z.string().min(1),
+  created: z.number().int().nonnegative(),
+  data: z.array(svgDocumentSchema).min(1),
+  usage: svgUsageSchema.nullish(),
+});
+
+const quiveraiErrorSchema = z.object({
+  status: z.number().int(),
+  code: z.string().min(1),
+  message: z.string().min(1),
+  request_id: z.string().min(1),
+});
+
+export const quiveraiFailedResponseHandler = createJsonErrorResponseHandler({
+  errorSchema: quiveraiErrorSchema,
+  errorToMessage: error => error.message,
+  isRetryable: response => response.status === 429 || response.status >= 500,
+});

package/src/quiverai-image-settings.ts

@@ -0,0 +1,17 @@
+/**
+ * QuiverAI image model identifier.
+ *
+ * @see https://quiver.ai/
+ */
+export type QuiverAIImageModelId =
+  | 'arrow-1'
+  | 'arrow-1.1'
+  | 'arrow-1.1-max'
+  | (string & {});
+
+/**
+ * QuiverAI image operation:
+ * - `generate`: Text-to-SVG generation (default).
+ * - `vectorize`: Convert a raster image into an SVG.
+ */
+export type QuiverAIOperation = 'generate' | 'vectorize';

package/src/quiverai-provider.ts

@@ -0,0 +1,115 @@
+import {
+  NoSuchModelError,
+  type ImageModelV3,
+  type ProviderV3,
+} from '@ai-sdk/provider';
+import {
+  loadApiKey,
+  loadOptionalSetting,
+  withoutTrailingSlash,
+  withUserAgentSuffix,
+  type FetchFunction,
+} from '@ai-sdk/provider-utils';
+import { QuiverAIImageModel } from './quiverai-image-model';
+import type { QuiverAIImageModelId } from './quiverai-image-settings';
+import { VERSION } from './version';
+
+export interface QuiverAIProviderSettings {
+  /**
+   * QuiverAI API key. Default value is taken from the `QUIVERAI_API_KEY`
+   * environment variable.
+   */
+  apiKey?: string;
+
+  /**
+   * Base URL for the API calls. Defaults to `https://api.quiver.ai/v1` and
+   * falls back to the `QUIVERAI_BASE_URL` environment variable.
+   */
+  baseURL?: string;
+
+  /**
+   * Custom headers to include in the requests.
+   */
+  headers?: Record<string, string>;
+
+  /**
+   * Custom fetch implementation. You can use it as a middleware to intercept
+   * requests, or to provide a custom fetch implementation for e.g. testing.
+   */
+  fetch?: FetchFunction;
+}
+
+export interface QuiverAIProvider extends ProviderV3 {
+  /**
+   * Creates a model for image generation.
+   */
+  image(modelId: QuiverAIImageModelId): ImageModelV3;
+
+  /**
+   * Creates a model for image generation.
+   */
+  imageModel(modelId: QuiverAIImageModelId): ImageModelV3;
+
+  /**
+   * @deprecated Use `embeddingModel` instead.
+   */
+  textEmbeddingModel(modelId: string): never;
+}
+
+const defaultBaseURL = 'https://api.quiver.ai/v1';
+
+export function createQuiverAI(
+  options: QuiverAIProviderSettings = {},
+): QuiverAIProvider {
+  const baseURL =
+    withoutTrailingSlash(
+      loadOptionalSetting({
+        settingValue: options.baseURL,
+        environmentVariableName: 'QUIVERAI_BASE_URL',
+      }),
+    ) ?? defaultBaseURL;
+
+  const getHeaders = () =>
+    withUserAgentSuffix(
+      {
+        Authorization: `Bearer ${loadApiKey({
+          apiKey: options.apiKey,
+          environmentVariableName: 'QUIVERAI_API_KEY',
+          description: 'QuiverAI',
+        })}`,
+        ...options.headers,
+      },
+      `ai-sdk/quiverai/${VERSION}`,
+    );
+
+  const createImageModel = (modelId: QuiverAIImageModelId) =>
+    new QuiverAIImageModel(modelId, {
+      provider: 'quiverai.image',
+      baseURL,
+      headers: getHeaders,
+      fetch: options.fetch,
+    });
+
+  const embeddingModel = (modelId: string) => {
+    throw new NoSuchModelError({
+      modelId,
+      modelType: 'embeddingModel',
+    });
+  };
+
+  return {
+    specificationVersion: 'v3',
+    image: createImageModel,
+    imageModel: createImageModel,
+    languageModel: (modelId: string) => {
+      throw new NoSuchModelError({
+        modelId,
+        modelType: 'languageModel',
+      });
+    },
+    embeddingModel,
+    textEmbeddingModel: embeddingModel,
+  };
+}
+
+export const quiverai = createQuiverAI();

package/src/version.ts

@@ -0,0 +1,6 @@
+// Version string of this package injected at build time.
+declare const __PACKAGE_VERSION__: string | undefined;
+export const VERSION: string =
+  typeof __PACKAGE_VERSION__ !== 'undefined'
+    ? __PACKAGE_VERSION__
+    : '0.0.0-test';