@ai-sdk/bytedance 0.0.0-b66d09a8-20260328011513

package/CHANGELOG.md

@@ -0,0 +1,120 @@
+# @ai-sdk/bytedance
+
+## 0.0.0-b66d09a8-20260328011513
+
+### Major Changes
+
+- 8359612: Start v7 pre-release
+
+### Patch Changes
+
+- Updated dependencies [531251e]
+- Updated dependencies [1f509d4]
+- Updated dependencies [5c2a5a2]
+- Updated dependencies [f7d4f01]
+- Updated dependencies [776b617]
+- Updated dependencies [3887c70]
+- Updated dependencies [61753c3]
+- Updated dependencies [8359612]
+  - @ai-sdk/provider-utils@0.0.0-b66d09a8-20260328011513
+  - @ai-sdk/provider@0.0.0-b66d09a8-20260328011513
+
+## 2.0.0-beta.7
+
+### Patch Changes
+
+- Updated dependencies [1f509d4]
+  - @ai-sdk/provider-utils@5.0.0-beta.7
+  - @ai-sdk/provider@4.0.0-beta.5
+
+## 2.0.0-beta.6
+
+### Patch Changes
+
+- Updated dependencies [3887c70]
+  - @ai-sdk/provider-utils@5.0.0-beta.6
+  - @ai-sdk/provider@4.0.0-beta.4
+
+## 2.0.0-beta.5
+
+### Patch Changes
+
+- Updated dependencies [776b617]
+  - @ai-sdk/provider-utils@5.0.0-beta.5
+  - @ai-sdk/provider@4.0.0-beta.3
+
+## 2.0.0-beta.4
+
+### Patch Changes
+
+- Updated dependencies [61753c3]
+  - @ai-sdk/provider-utils@5.0.0-beta.4
+
+## 2.0.0-beta.3
+
+### Patch Changes
+
+- Updated dependencies [f7d4f01]
+  - @ai-sdk/provider-utils@5.0.0-beta.3
+  - @ai-sdk/provider@4.0.0-beta.2
+
+## 2.0.0-beta.2
+
+### Patch Changes
+
+- Updated dependencies [5c2a5a2]
+  - @ai-sdk/provider@4.0.0-beta.1
+  - @ai-sdk/provider-utils@5.0.0-beta.2
+
+## 2.0.0-beta.1
+
+### Patch Changes
+
+- Updated dependencies [531251e]
+  - @ai-sdk/provider-utils@5.0.0-beta.1
+
+## 2.0.0-beta.0
+
+### Major Changes
+
+- 8359612: Start v7 pre-release
+
+### Patch Changes
+
+- Updated dependencies [8359612]
+  - @ai-sdk/provider@4.0.0-beta.0
+  - @ai-sdk/provider-utils@5.0.0-beta.0
+
+## 1.0.4
+
+### Patch Changes
+
+- Updated dependencies [ad4cfc2]
+  - @ai-sdk/provider-utils@4.0.19
+
+## 1.0.3
+
+### Patch Changes
+
+- Updated dependencies [824b295]
+  - @ai-sdk/provider-utils@4.0.18
+
+## 1.0.2
+
+### Patch Changes
+
+- Updated dependencies [08336f1]
+  - @ai-sdk/provider-utils@4.0.17
+
+## 1.0.1
+
+### Patch Changes
+
+- Updated dependencies [58bc42d]
+  - @ai-sdk/provider-utils@4.0.16
+
+## 1.0.0
+
+### Major Changes
+
+- 15a9e21: feat (provider/bytedance): initial bytedance provider

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,202 @@
+# AI SDK - ByteDance Provider
+
+The **ByteDance provider** for the [AI SDK](https://ai-sdk.dev/docs) contains video model support for ByteDance's Seedance family of video generation models through the [BytePlus ModelArk](https://docs.byteplus.com/en/docs/ModelArk/Video_Generation_API) platform.
+
+## Setup
+
+The ByteDance provider is available in the `@ai-sdk/bytedance` module. You can install it with:
+
+```bash
+npm i @ai-sdk/bytedance
+```
+
+## 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 `byteDance` from `@ai-sdk/bytedance`:
+
+```ts
+import { byteDance } from '@ai-sdk/bytedance';
+```
+
+## Video Models
+
+This provider supports text-to-video, image-to-video, audio-video sync, first-and-last frame control, and multi-reference image generation.
+
+### Text-to-Video
+
+Generate video from a text prompt.
+
+Available models: `seedance-1-5-pro-251215`, `seedance-1-0-pro-250528`, `seedance-1-0-pro-fast-251015`, `seedance-1-0-lite-t2v-250428`
+
+```ts
+import { byteDance } from '@ai-sdk/bytedance';
+import { experimental_generateVideo as generateVideo } from 'ai';
+
+const { video } = await generateVideo({
+  model: byteDance.video('seedance-1-0-pro-250528'),
+  prompt: 'A cat playing with a ball of yarn in a sunlit room',
+  aspectRatio: '16:9',
+  duration: 5,
+  providerOptions: {
+    bytedance: {
+      watermark: false,
+    },
+  },
+});
+
+console.log(video.url);
+```
+
+### Image-to-Video
+
+Generate video from a first-frame image with an optional text prompt.
+
+Available models: `seedance-1-5-pro-251215`, `seedance-1-0-pro-250528`, `seedance-1-0-pro-fast-251015`, `seedance-1-0-lite-i2v-250428`
+
+```ts
+import { byteDance } from '@ai-sdk/bytedance';
+import { experimental_generateVideo as generateVideo } from 'ai';
+
+const { video } = await generateVideo({
+  model: byteDance.video('seedance-1-5-pro-251215'),
+  prompt: {
+    image: 'https://example.com/first-frame.png',
+    text: 'The cat slowly turns its head and blinks',
+  },
+  duration: 5,
+  providerOptions: {
+    bytedance: {
+      watermark: false,
+    },
+  },
+});
+```
+
+### Image-to-Video with Audio
+
+Seedance 1.5 Pro supports generating synchronized audio alongside the video.
+
+```ts
+import { byteDance } from '@ai-sdk/bytedance';
+import { experimental_generateVideo as generateVideo } from 'ai';
+
+const { video } = await generateVideo({
+  model: byteDance.video('seedance-1-5-pro-251215'),
+  prompt: {
+    image: 'https://example.com/pianist.png',
+    text: 'A young man sits at a piano, playing calmly. Gentle piano music plays in sync.',
+  },
+  duration: 5,
+  providerOptions: {
+    bytedance: {
+      generateAudio: true,
+      watermark: false,
+    },
+  },
+});
+```
+
+### First-and-Last Frame Video
+
+Generate smooth transitions between a starting and ending keyframe image.
+
+```ts
+import { byteDance } from '@ai-sdk/bytedance';
+import { experimental_generateVideo as generateVideo } from 'ai';
+
+const { video } = await generateVideo({
+  model: byteDance.video('seedance-1-5-pro-251215'),
+  prompt: {
+    image: 'https://example.com/first-frame.jpg',
+    text: 'Create a 360-degree orbiting camera shot based on this photo',
+  },
+  duration: 5,
+  providerOptions: {
+    bytedance: {
+      lastFrameImage: 'https://example.com/last-frame.jpg',
+      generateAudio: true,
+      watermark: false,
+    },
+  },
+});
+```
+
+### Multi-Reference Image-to-Video
+
+Provide multiple reference images (1-4) that the model uses to faithfully reproduce object shapes, colors, and textures. Use `[Image 1]`, `[Image 2]`, etc. in your prompt to reference specific images.
+
+Available models: `seedance-1-0-lite-i2v-250428`
+
+```ts
+import { byteDance } from '@ai-sdk/bytedance';
+import { experimental_generateVideo as generateVideo } from 'ai';
+
+const { video } = await generateVideo({
+  model: byteDance.video('seedance-1-0-lite-i2v-250428'),
+  prompt:
+    'A boy from [Image 1] and a corgi from [Image 2], sitting on the lawn from [Image 3]',
+  aspectRatio: '16:9',
+  duration: 5,
+  providerOptions: {
+    bytedance: {
+      referenceImages: [
+        'https://example.com/boy.png',
+        'https://example.com/corgi.png',
+        'https://example.com/lawn.png',
+      ],
+      watermark: false,
+    },
+  },
+});
+```
+
+## Provider Options
+
+Use `providerOptions.bytedance` to configure video generation:
+
+| Option            | Description                                                                            |
+| ----------------- | -------------------------------------------------------------------------------------- |
+| `watermark`       | Whether to add a watermark to the generated video                                      |
+| `generateAudio`   | Generate synchronized audio (Seedance 1.5 Pro only)                                    |
+| `cameraFixed`     | Whether to fix the camera during generation                                            |
+| `returnLastFrame` | Return the last frame of the generated video (useful for chaining)                     |
+| `serviceTier`     | `'default'` for online inference, `'flex'` for offline at 50% price                    |
+| `draft`           | Enable draft mode for low-cost 480p preview generation (Seedance 1.5 Pro only)         |
+| `lastFrameImage`  | URL of last frame image for first-and-last frame generation                            |
+| `referenceImages` | Array of reference image URLs (1-4) for multi-reference generation (1.0 Lite I2V only) |
+| `pollIntervalMs`  | Poll interval for async generation (default: 3000ms)                                   |
+| `pollTimeoutMs`   | Max wait time for generation (default: 300000ms)                                       |
+
+Supported aspect ratios: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `adaptive` (image-to-video only).
+
+## Authentication
+
+Set the `ARK_API_KEY` environment variable:
+
+```
+ARK_API_KEY=your-api-key
+```
+
+Or pass it directly:
+
+```ts
+import { createByteDance } from '@ai-sdk/bytedance';
+
+const byteDance = createByteDance({
+  apiKey: 'your-api-key',
+});
+```
+
+You can [obtain an API key](https://console.byteplus.com/ark/apiKey) from the BytePlus console.
+
+## Documentation
+
+Please check out the **[ByteDance provider](https://ai-sdk.dev/providers/ai-sdk-providers/bytedance)** for more information.

package/dist/index.d.mts

@@ -0,0 +1,62 @@
+import { ProviderV4, Experimental_VideoModelV4 } from '@ai-sdk/provider';
+import { FetchFunction } from '@ai-sdk/provider-utils';
+
+type ByteDanceVideoModelId = 'seedance-1-5-pro-251215' | 'seedance-1-0-pro-250528' | 'seedance-1-0-pro-fast-251015' | 'seedance-1-0-lite-t2v-250428' | 'seedance-1-0-lite-i2v-250428' | (string & {});
+
+interface ByteDanceProviderSettings {
+    /**
+     * ByteDance Ark API key. Default value is taken from the `ARK_API_KEY`
+     * environment variable.
+     */
+    apiKey?: string;
+    /**
+     * Base URL for the API calls.
+     * Default: https://ark.ap-southeast.bytepluses.com/api/v3
+     */
+    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 ByteDanceProvider extends ProviderV4 {
+    /**
+     * Creates a model for video generation.
+     */
+    video(modelId: ByteDanceVideoModelId): Experimental_VideoModelV4;
+    /**
+     * Creates a model for video generation.
+     */
+    videoModel(modelId: ByteDanceVideoModelId): Experimental_VideoModelV4;
+}
+/**
+ * Create a ByteDance provider instance.
+ */
+declare function createByteDance(options?: ByteDanceProviderSettings): ByteDanceProvider;
+/**
+ * Default ByteDance provider instance.
+ */
+declare const byteDance: ByteDanceProvider;
+
+type ByteDanceVideoProviderOptions = {
+    watermark?: boolean | null;
+    generateAudio?: boolean | null;
+    cameraFixed?: boolean | null;
+    returnLastFrame?: boolean | null;
+    serviceTier?: 'default' | 'flex' | null;
+    draft?: boolean | null;
+    lastFrameImage?: string | null;
+    referenceImages?: string[] | null;
+    pollIntervalMs?: number | null;
+    pollTimeoutMs?: number | null;
+    [key: string]: unknown;
+};
+
+declare const VERSION: string;
+
+export { type ByteDanceProvider, type ByteDanceProviderSettings, type ByteDanceVideoModelId, type ByteDanceVideoProviderOptions, VERSION, byteDance, createByteDance };

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+import { ProviderV4, Experimental_VideoModelV4 } from '@ai-sdk/provider';
+import { FetchFunction } from '@ai-sdk/provider-utils';
+
+type ByteDanceVideoModelId = 'seedance-1-5-pro-251215' | 'seedance-1-0-pro-250528' | 'seedance-1-0-pro-fast-251015' | 'seedance-1-0-lite-t2v-250428' | 'seedance-1-0-lite-i2v-250428' | (string & {});
+
+interface ByteDanceProviderSettings {
+    /**
+     * ByteDance Ark API key. Default value is taken from the `ARK_API_KEY`
+     * environment variable.
+     */
+    apiKey?: string;
+    /**
+     * Base URL for the API calls.
+     * Default: https://ark.ap-southeast.bytepluses.com/api/v3
+     */
+    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 ByteDanceProvider extends ProviderV4 {
+    /**
+     * Creates a model for video generation.
+     */
+    video(modelId: ByteDanceVideoModelId): Experimental_VideoModelV4;
+    /**
+     * Creates a model for video generation.
+     */
+    videoModel(modelId: ByteDanceVideoModelId): Experimental_VideoModelV4;
+}
+/**
+ * Create a ByteDance provider instance.
+ */
+declare function createByteDance(options?: ByteDanceProviderSettings): ByteDanceProvider;
+/**
+ * Default ByteDance provider instance.
+ */
+declare const byteDance: ByteDanceProvider;
+
+type ByteDanceVideoProviderOptions = {
+    watermark?: boolean | null;
+    generateAudio?: boolean | null;
+    cameraFixed?: boolean | null;
+    returnLastFrame?: boolean | null;
+    serviceTier?: 'default' | 'flex' | null;
+    draft?: boolean | null;
+    lastFrameImage?: string | null;
+    referenceImages?: string[] | null;
+    pollIntervalMs?: number | null;
+    pollTimeoutMs?: number | null;
+    [key: string]: unknown;
+};
+
+declare const VERSION: string;
+
+export { type ByteDanceProvider, type ByteDanceProviderSettings, type ByteDanceVideoModelId, type ByteDanceVideoProviderOptions, VERSION, byteDance, createByteDance };