@ai-sdk/alibaba 0.0.0-6b196531-20260710185421

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,151 @@
+# AI SDK - Alibaba Provider
+
+The **[Alibaba provider](https://ai-sdk.dev/providers/ai-sdk-providers/alibaba)** for the [AI SDK](https://ai-sdk.dev/docs) contains language model, embedding model, and video model support for [Alibaba Cloud Model Studio](https://modelstudio.console.alibabacloud.com/), including the Qwen model series with advanced reasoning capabilities.
+
+> **Deploying to Vercel?** With Vercel's AI Gateway you can access Alibaba (and hundreds of models from other providers) — no additional packages, API keys, or extra cost. [Get started with AI Gateway](https://vercel.com/ai-gateway).
+
+## Setup
+
+The Alibaba provider is available in the `@ai-sdk/alibaba` module. You can install it with
+
+```bash
+npm i @ai-sdk/alibaba
+```
+
+## 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 `alibaba` from `@ai-sdk/alibaba`:
+
+```ts
+import { alibaba } from '@ai-sdk/alibaba';
+```
+
+## Language Model Example
+
+```ts
+import { alibaba } from '@ai-sdk/alibaba';
+import { generateText } from 'ai';
+
+const { text } = await generateText({
+  model: alibaba('qwen-plus'),
+  prompt: 'Write a vegetarian lasagna recipe for 4 people.',
+});
+```
+
+## Thinking Mode Example (Qwen Reasoning Models)
+
+Alibaba's Qwen models support thinking/reasoning mode for complex problem-solving:
+
+```ts
+import { alibaba } from '@ai-sdk/alibaba';
+import { generateText } from 'ai';
+
+const { text, reasoningText } = await generateText({
+  model: alibaba('qwen3-max'),
+  providerOptions: {
+    alibaba: {
+      enableThinking: true,
+      thinkingBudget: 2048,
+    },
+  },
+  prompt: 'How many "r"s are in the word "strawberry"?',
+});
+
+console.log('Reasoning:', reasoningText);
+console.log('Answer:', text);
+```
+
+## Embedding Model Example
+
+```ts
+import { alibaba, type AlibabaEmbeddingModelOptions } from '@ai-sdk/alibaba';
+import { embed } from 'ai';
+
+const { embedding, usage } = await embed({
+  model: alibaba.embedding('text-embedding-v4'),
+  value: 'sunny day at the beach',
+  providerOptions: {
+    alibaba: {
+      textType: 'document',
+      dimension: 1024,
+      outputType: 'dense',
+    } satisfies AlibabaEmbeddingModelOptions,
+  },
+});
+```
+
+## Tool Calling Example
+
+```ts
+import { alibaba } from '@ai-sdk/alibaba';
+import { generateText, tool } from 'ai';
+import { z } from 'zod';
+
+const { text } = await generateText({
+  model: alibaba('qwen-plus'),
+  tools: {
+    weather: tool({
+      description: 'Get the weather in a location',
+      parameters: z.object({
+        location: z.string().describe('The location to get the weather for'),
+      }),
+      execute: async ({ location }) => ({
+        location,
+        temperature: 72 + Math.floor(Math.random() * 21) - 10,
+      }),
+    }),
+  },
+  prompt: 'What is the weather in San Francisco?',
+});
+```
+
+## Explicit Caching Example
+
+Alibaba supports both implicit and explicit prompt caching to reduce costs for repeated prompts.
+
+**Implicit caching** works automatically - the provider caches appropriate content without any configuration. For more control, you can use **explicit caching** by marking specific messages with `cacheControl`:
+
+```ts
+import { alibaba } from '@ai-sdk/alibaba';
+import { generateText } from 'ai';
+
+const longDocument = '... large document content ...';
+
+const { text, usage } = await generateText({
+  model: alibaba('qwen-plus'),
+  messages: [
+    {
+      role: 'user',
+      content: [
+        {
+          type: 'text',
+          text: 'Context: Please analyze this document.',
+        },
+        {
+          type: 'text',
+          text: longDocument,
+          providerOptions: {
+            alibaba: {
+              cacheControl: { type: 'ephemeral' },
+            },
+          },
+        },
+      ],
+    },
+  ],
+});
+```
+
+**Note:** The minimum content length for a cache block is 1,024 tokens.
+
+## Documentation
+
+Please check out the **[Alibaba provider documentation](https://ai-sdk.dev/providers/ai-sdk-providers/alibaba)** for more information.

package/dist/index.d.ts

@@ -0,0 +1,171 @@
+import { z } from 'zod/v4';
+import { ProviderV4, LanguageModelV4, EmbeddingModelV4, Experimental_VideoModelV4 } from '@ai-sdk/provider';
+import { FetchFunction } from '@ai-sdk/provider-utils';
+
+type AlibabaChatModelId = 'qwen3.7-max' | 'qwen3-max' | 'qwen3-max-preview' | 'qwen-plus' | 'qwen-plus-latest' | 'qwen-flash' | 'qwen-turbo' | 'qwen-turbo-latest' | 'qwen3-235b-a22b' | 'qwen3-32b' | 'qwen3-30b-a3b' | 'qwen3-14b' | 'qwen3-next-80b-a3b-thinking' | 'qwen3-235b-a22b-thinking-2507' | 'qwen3-30b-a3b-thinking-2507' | 'qwq-plus' | 'qwq-plus-latest' | 'qwq-32b' | 'qwen-coder' | 'qwen3-coder-plus' | 'qwen3-coder-flash' | (string & {});
+declare const alibabaLanguageModelChatOptions: z.ZodObject<{
+    enableThinking: z.ZodOptional<z.ZodBoolean>;
+    thinkingBudget: z.ZodOptional<z.ZodNumber>;
+    parallelToolCalls: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type AlibabaLanguageModelChatOptions = z.infer<typeof alibabaLanguageModelChatOptions>;
+
+type AlibabaCacheControl = {
+    type: string;
+};
+
+type AlibabaEmbeddingModelId = 'text-embedding-v4' | 'text-embedding-v3' | (string & {});
+declare const alibabaEmbeddingModelOptions: z.ZodObject<{
+    textType: z.ZodOptional<z.ZodEnum<{
+        query: "query";
+        document: "document";
+    }>>;
+    dimension: z.ZodOptional<z.ZodNumber>;
+    outputType: z.ZodOptional<z.ZodEnum<{
+        dense: "dense";
+        sparse: "sparse";
+        "dense&sparse": "dense&sparse";
+    }>>;
+}, z.core.$strip>;
+type AlibabaEmbeddingModelOptions = z.infer<typeof alibabaEmbeddingModelOptions>;
+
+type AlibabaVideoModelId = 'wan2.6-t2v' | 'wan2.5-t2v-preview' | 'wan2.7-t2v' | 'wan2.7-t2v-2026-06-12' | 'wan2.6-i2v' | 'wan2.6-i2v-flash' | 'wan2.6-r2v' | 'wan2.6-r2v-flash' | 'wan2.7-r2v' | 'wan2.7-r2v-2026-06-12' | (string & {});
+
+interface AlibabaProvider extends ProviderV4 {
+    (modelId: AlibabaChatModelId): LanguageModelV4;
+    /**
+     * Creates a model for text generation.
+     */
+    languageModel(modelId: AlibabaChatModelId): LanguageModelV4;
+    /**
+     * Creates a chat model for text generation.
+     */
+    chatModel(modelId: AlibabaChatModelId): LanguageModelV4;
+    /**
+     * Creates a model for text embeddings.
+     */
+    embedding(modelId: AlibabaEmbeddingModelId): EmbeddingModelV4;
+    /**
+     * Creates a model for text embeddings.
+     */
+    embeddingModel(modelId: AlibabaEmbeddingModelId): EmbeddingModelV4;
+    /**
+     * Creates a model for video generation.
+     */
+    video(modelId: AlibabaVideoModelId): Experimental_VideoModelV4;
+    /**
+     * Creates a model for video generation.
+     */
+    videoModel(modelId: AlibabaVideoModelId): Experimental_VideoModelV4;
+}
+interface AlibabaProviderSettings {
+    /**
+     * Use a different URL prefix for API calls, e.g. to use proxy servers or regional endpoints.
+     * The default prefix is `https://dashscope-intl.aliyuncs.com/compatible-mode/v1`.
+     */
+    baseURL?: string;
+    /**
+     * Use a different URL prefix for video generation API calls.
+     * The video API uses the DashScope native endpoint (not the OpenAI-compatible endpoint).
+     * The default prefix is `https://dashscope-intl.aliyuncs.com`.
+     */
+    videoBaseURL?: string;
+    /**
+     * Use a different URL prefix for embedding API calls.
+     * The embedding API uses the DashScope native endpoint (not the OpenAI-compatible endpoint).
+     * The default prefix is `https://dashscope-intl.aliyuncs.com/api/v1`.
+     */
+    embeddingBaseURL?: string;
+    /**
+     * API key that is being sent using the `Authorization` header.
+     * It defaults to the `ALIBABA_API_KEY` environment variable.
+     */
+    apiKey?: 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;
+    /**
+     * Include usage information in streaming responses.
+     * When enabled, token usage will be included in the final chunk.
+     *
+     * @default true
+     */
+    includeUsage?: boolean;
+}
+/**
+ * Create an Alibaba Cloud (Qwen) provider instance.
+ */
+declare function createAlibaba(options?: AlibabaProviderSettings): AlibabaProvider;
+declare const alibaba: AlibabaProvider;
+
+type AlibabaVideoModelOptions = {
+    /** Negative prompt to specify what to avoid (max 500 chars). */
+    negativePrompt?: string | null;
+    /** URL to audio file for audio-video sync (WAV/MP3, 3-30s, max 15MB). */
+    audioUrl?: string | null;
+    /** Enable prompt extension/rewriting for better generation. Defaults to true. */
+    promptExtend?: boolean | null;
+    /**
+     * Shot type: 'single' for single-shot or 'multi' for multi-shot narrative
+     * (wan2.6 and earlier; wan2.7 models describe shot structure in the prompt).
+     */
+    shotType?: 'single' | 'multi' | null;
+    /** Whether to add watermark to generated video. Defaults to false. */
+    watermark?: boolean | null;
+    /**
+     * Enable audio generation (for wan2.6 I2V/R2V models;
+     * wan2.7 models always generate audio).
+     */
+    audio?: boolean | null;
+    /**
+     * Reference URLs for reference-to-video mode (wan2.6 models).
+     * Array of URLs to images (0-5) and/or videos (0-3), max 5 total.
+     * Use character identifiers (character1, character2) in prompts to reference them.
+     */
+    referenceUrls?: string[] | null;
+    /**
+     * Explicit media array for reference-to-video mode (wan2.7 models).
+     * Overrides the automatic mapping from `inputReferences` and `frameImages`.
+     * Use `Image 1`, `Video 1`, etc. in prompts to reference media items
+     * (images and videos are counted separately, in array order).
+     */
+    media?: Array<{
+        type: 'reference_image' | 'reference_video' | 'first_frame';
+        /** Public URL, or a `data:{mime};base64,{data}` URI for images. */
+        url: string;
+        /** URL to an audio file used as voice reference for this media item. */
+        referenceVoice?: string | null;
+    }> | null;
+    /**
+     * Aspect ratio (wan2.7 text-to-video and reference-to-video models).
+     */
+    ratio?: '16:9' | '9:16' | '1:1' | '4:3' | '3:4' | null;
+    /** Polling interval in milliseconds. Defaults to 5000 (5 seconds). */
+    pollIntervalMs?: number | null;
+    /** Maximum wait time in milliseconds for video generation. Defaults to 600000 (10 minutes). */
+    pollTimeoutMs?: number | null;
+    [key: string]: unknown;
+};
+
+type AlibabaUsage = {
+    prompt_tokens?: number | null;
+    completion_tokens?: number | null;
+    total_tokens?: number | null;
+    prompt_tokens_details?: {
+        cached_tokens?: number | null;
+        cache_creation_input_tokens?: number | null;
+    } | null;
+    completion_tokens_details?: {
+        reasoning_tokens?: number | null;
+    } | null;
+};
+
+declare const VERSION: string;
+
+export { type AlibabaCacheControl, type AlibabaChatModelId, type AlibabaEmbeddingModelId, type AlibabaEmbeddingModelOptions, type AlibabaLanguageModelChatOptions, type AlibabaLanguageModelChatOptions as AlibabaLanguageModelOptions, type AlibabaProvider, type AlibabaLanguageModelChatOptions as AlibabaProviderOptions, type AlibabaProviderSettings, type AlibabaUsage, type AlibabaVideoModelId, type AlibabaVideoModelOptions, type AlibabaVideoModelOptions as AlibabaVideoProviderOptions, VERSION, alibaba, createAlibaba };