@tanstack/ai-byteplus 0.0.0

package/dist/esm/adapters/video.js

@@ -0,0 +1,442 @@
+import { bytePlusArkError, bytePlusArkHeaders, bytePlusTimeoutSignal, getBytePlusArkApiKeyFromEnv, readJsonBody, toHeaderRecord, withBytePlusArkDefaults } from "../utils/client.js";
+import { getBytePlusVideoDurationOptions, isKnownBytePlusVideoModel } from "../model-meta.js";
+import { resolveBytePlusVideoResolution, resolveBytePlusVideoSize, supportsLastFrame, supportsReferenceMedia } from "../video/video-provider-options.js";
+import { resolveMediaPrompt } from "@tanstack/ai";
+import { BaseVideoAdapter, snapToDurationOption } from "@tanstack/ai/adapters";
+import { toRunErrorPayload } from "@tanstack/ai/adapter-internals";
+//#region src/adapters/video.ts
+/** Path of the Seedance task API, relative to the Ark base URL. */
+var TASKS_PATH = "/contents/generations/tasks";
+/**
+* `content.video_url` and `content.last_frame_url` are deleted 24 hours after
+* the task produces them.
+*/
+var VIDEO_URL_TTL_MS = 1440 * 60 * 1e3;
+/**
+* Converts a media prompt part into the URL string Seedance's `content[]`
+* takes: public URLs pass through (BytePlus fetches them server-side), data
+* sources become base64 data URIs.
+*/
+function mediaPartToUrl(part) {
+	const { source } = part;
+	if (source.type === "url") return source.value;
+	if (source.value.startsWith("data:")) return source.value;
+	return `data:${source.mimeType.toLowerCase()};base64,${source.value}`;
+}
+/** Coerces a usage count that the API types as a string but sends as a number. */
+function toTokenCount(value) {
+	if (typeof value === "number") return value;
+	if (typeof value === "string") {
+		const parsed = Number(value);
+		return Number.isFinite(parsed) ? parsed : void 0;
+	}
+}
+/**
+* Maps a finished task's usage onto `TokenUsage`.
+*
+* Seedance bills output only — the API documents input tokens as always 0 and
+* `total_tokens` as equal to `completion_tokens` — so `promptTokens` is 0 and
+* the completion count doubles as `unitsBilled`.
+*/
+function buildBytePlusVideoUsage(usage) {
+	if (!usage) return void 0;
+	const completionTokens = toTokenCount(usage.completion_tokens);
+	const totalTokens = toTokenCount(usage.total_tokens);
+	if (completionTokens === void 0 && totalTokens === void 0) return;
+	const completion = completionTokens ?? totalTokens ?? 0;
+	return {
+		promptTokens: 0,
+		completionTokens: completion,
+		totalTokens: totalTokens ?? completion,
+		unitsBilled: completion
+	};
+}
+/**
+* Formats a terminal task's error detail for a status / failure message.
+*
+* Always returns a string. Core surfaces a failed job as
+* `throw new Error(statusResult.error || 'Video generation failed')`, so
+* returning `undefined` for a failure Ark reported without an `error` block
+* would hand the caller an unattributable error. The final fallback is a
+* snapshot of the identifying fields instead.
+*/
+function describeTaskFailure(task) {
+	const { code, message } = task.error ?? {};
+	if (code && message) return `${code}: ${message}`;
+	if (message) return message;
+	if (code) return code;
+	if (task.status === "expired") return "Task expired before it finished (execution_expires_after elapsed).";
+	if (task.status === "cancelled") return "Task was cancelled.";
+	return `Task reported status "${task.status ?? "unknown"}" with no error detail (id=${task.id ?? "unknown"}, model=${task.model ?? "unknown"}).`;
+}
+/**
+* BytePlus Seedance video generation adapter.
+*
+* Drives Ark's asynchronous task API — `POST /contents/generations/tasks` to
+* submit, `GET /contents/generations/tasks/{id}` to poll and to read the
+* finished video URL. Core owns the polling loop; this adapter implements the
+* three primitives plus the duration metadata.
+*
+* Prompt parts map onto Seedance's `content[]` roles, which the API sorts into
+* mutually exclusive task types:
+*
+* - `'start_frame'` (or a single un-roled image) → `first_frame` — the frame
+*   the video opens on (`i2v`).
+* - `'end_frame'` → `last_frame` — the frame it closes on (`flf2v`); Seedance
+*   requires a `first_frame` alongside it, and
+*   `seedance-1-0-pro-fast-251015` does not support it at all.
+* - `'reference'` / `'character'` → `reference_image`, video parts →
+*   `reference_video`, audio parts → `reference_audio` — subject and style
+*   references the model draws on (`r2v`, Seedance 2.0 family only).
+*
+* Frame roles and reference roles cannot be combined in one request, so the
+* adapter rejects a mix up front rather than surfacing a raw 400.
+*
+* @experimental Video generation is an experimental feature and may change.
+*
+* @example
+* ```typescript
+* const adapter = byteplusVideo('seedance-1-0-pro-fast-251015')
+*
+* const { jobId } = await generateVideo({
+*   adapter,
+*   prompt: 'a guitar being played in a store',
+*   size: '16:9_720p',
+*   duration: 4,
+*   modelOptions: { service_tier: 'flex' },
+* })
+* ```
+*/
+var BytePlusVideoAdapter = class extends BaseVideoAdapter {
+	name = "byteplus";
+	/** Config with the Ark base URL resolved and its trailing slashes trimmed. */
+	clientConfig;
+	constructor(config, model) {
+		super({}, model);
+		this.clientConfig = withBytePlusArkDefaults(config);
+	}
+	async request(path, init) {
+		const fetchImpl = this.clientConfig.fetch ?? fetch;
+		const signal = bytePlusTimeoutSignal(this.clientConfig.timeout);
+		const response = await fetchImpl(`${this.clientConfig.baseURL}${path}`, {
+			...init,
+			...signal && { signal },
+			headers: bytePlusArkHeaders(this.clientConfig.apiKey, toHeaderRecord(this.clientConfig.defaultHeaders))
+		});
+		return {
+			response,
+			body: await readJsonBody(response)
+		};
+	}
+	/**
+	* Builds the `content[]` array from the resolved prompt, enforcing
+	* Seedance's role vocabulary and mode exclusivity.
+	*/
+	buildContent(resolved) {
+		const model = this.model;
+		const content = [];
+		if (resolved.text) content.push({
+			type: "text",
+			text: resolved.text
+		});
+		const gated = isKnownBytePlusVideoModel(model);
+		let firstFrames = 0;
+		let lastFrames = 0;
+		let visualReferences = 0;
+		let audioReferences = 0;
+		for (const part of resolved.images) {
+			const role = part.metadata?.role;
+			switch (role) {
+				case "mask":
+				case "control": throw new Error(`byteplus: Seedance has no '${role}' image input on model ${model}. Use 'start_frame', 'end_frame' or 'reference'.`);
+				case "end_frame":
+					if (gated && !supportsLastFrame(model)) throw new Error(`byteplus: ${model} does not support a closing frame — it does text-to-video and first-frame image-to-video only. Drop the 'end_frame' image or switch to a model with first-and-last-frame support.`);
+					lastFrames++;
+					content.push({
+						type: "image_url",
+						image_url: { url: mediaPartToUrl(part) },
+						role: "last_frame"
+					});
+					break;
+				case "reference":
+				case "character":
+					if (gated && !supportsReferenceMedia(model)) throw new Error(`byteplus: ${model} does not support reference images. Reference media is available on the Seedance 2.0 family; on this model use 'start_frame' / 'end_frame' images instead.`);
+					visualReferences++;
+					content.push({
+						type: "image_url",
+						image_url: { url: mediaPartToUrl(part) },
+						role: "reference_image"
+					});
+					break;
+				case "start_frame":
+				case void 0:
+					firstFrames++;
+					content.push({
+						type: "image_url",
+						image_url: { url: mediaPartToUrl(part) },
+						role: "first_frame"
+					});
+					break;
+			}
+		}
+		for (const part of resolved.videos) {
+			if (gated && !supportsReferenceMedia(model)) throw new Error(`byteplus: ${model} does not accept video prompt parts. Reference video is available on the Seedance 2.0 family only.`);
+			visualReferences++;
+			content.push({
+				type: "video_url",
+				video_url: { url: mediaPartToUrl(part) },
+				role: "reference_video"
+			});
+		}
+		for (const part of resolved.audios) {
+			if (gated && !supportsReferenceMedia(model)) throw new Error(`byteplus: ${model} does not accept audio prompt parts. Reference audio is available on the Seedance 2.0 family only.`);
+			audioReferences++;
+			content.push({
+				type: "audio_url",
+				audio_url: { url: mediaPartToUrl(part) },
+				role: "reference_audio"
+			});
+		}
+		const frames = firstFrames + lastFrames;
+		if (gated && frames > 0 && visualReferences + audioReferences > 0) throw new Error(`byteplus: first/last frame inputs cannot be combined with reference media on model ${model}. Use either frame roles ('start_frame', 'end_frame') or reference roles ('reference', 'character', video, audio) — not both.`);
+		if (gated && firstFrames > 1) throw new Error(`byteplus: ${model} accepts at most one opening frame; received ${firstFrames} un-roled or 'start_frame' images. Use metadata.role ('end_frame', 'reference') to disambiguate the others.`);
+		if (gated && lastFrames > 1) throw new Error(`byteplus: ${model} accepts at most one closing frame; received ${lastFrames} 'end_frame' images.`);
+		if (gated && lastFrames > 0 && firstFrames === 0) throw new Error(`byteplus: a closing frame needs an opening frame alongside it on model ${model}. Add a 'start_frame' image, or drop the 'end_frame' role.`);
+		if (gated && audioReferences > 0 && visualReferences === 0) throw new Error(`byteplus: a reference audio input cannot be the only reference on model ${model}. Pair it with a reference image or video.`);
+		if (content.length === 0) throw new Error(`byteplus: a video prompt must carry text or at least one media input (model: ${model}).`);
+		return content;
+	}
+	async createVideoJob(options) {
+		const { size, modelOptions, logger } = options;
+		const model = this.model;
+		const content = this.buildContent(resolveMediaPrompt(options.prompt));
+		const parsedSize = size !== void 0 ? resolveBytePlusVideoSize(model, size) : void 0;
+		const duration = options.duration !== void 0 ? isKnownBytePlusVideoModel(model) ? this.snapDuration(options.duration) : options.duration : void 0;
+		const request = {
+			...parsedSize && {
+				ratio: parsedSize.ratio,
+				...parsedSize.resolution !== void 0 && { resolution: parsedSize.resolution }
+			},
+			...duration !== void 0 && { duration },
+			...modelOptions,
+			model,
+			content
+		};
+		if (request.resolution !== void 0) request.resolution = resolveBytePlusVideoResolution(model, request.resolution);
+		try {
+			logger.request(`activity=video.create provider=${this.name} model=${model} size=${size ?? "default"} duration=${request.duration ?? "default"}`, {
+				provider: this.name,
+				model
+			});
+			const { response, body } = await this.request(TASKS_PATH, {
+				method: "POST",
+				body: JSON.stringify(request)
+			});
+			if (!response.ok) throw bytePlusArkError(response.status, body, "video task creation");
+			const { id } = body ?? {};
+			if (!id) throw new Error("byteplus: video task creation returned no task id.");
+			return {
+				jobId: id,
+				model
+			};
+		} catch (error) {
+			logger.errors(`${this.name}.createVideoJob fatal`, {
+				error: toRunErrorPayload(error, `${this.name}.createVideoJob failed`),
+				source: `${this.name}.createVideoJob`
+			});
+			throw error;
+		}
+	}
+	/**
+	* Fetches a task, tagging the thrown error with the HTTP status.
+	*
+	* The 200 body is validated rather than cast. `readJsonBody` returns
+	* `undefined` for an empty body and the raw text for a non-JSON one — both
+	* documented failure modes of these hosts (an HTML error page from a proxy
+	* in front of the API). Casting either to `BytePlusVideoTask` yields a task
+	* whose `status` is `undefined`, which {@link mapStatus} would have to
+	* interpret; the honest answer is that the response was not a task at all,
+	* so say so while the body is still in hand.
+	*/
+	async retrieveTask(jobId) {
+		const { response, body } = await this.request(`${TASKS_PATH}/${encodeURIComponent(jobId)}`);
+		if (!response.ok) {
+			const error = bytePlusArkError(response.status, body, "video task lookup");
+			error.status = response.status;
+			throw error;
+		}
+		if (typeof body !== "object" || body === null) throw bytePlusArkError(response.status, body, `video task lookup (job ${jobId}) returned a non-object body`);
+		return body;
+	}
+	async getVideoStatus(jobId) {
+		let task;
+		try {
+			task = await this.retrieveTask(jobId);
+		} catch (error) {
+			if (error.status === 404) return {
+				jobId,
+				status: "failed",
+				error: `Job not found: ${jobId} (${error.message})`
+			};
+			throw error;
+		}
+		const status = this.mapStatus(task.status);
+		const failure = status === "failed" ? describeTaskFailure(task) : void 0;
+		return {
+			jobId,
+			status,
+			...failure !== void 0 && { error: failure }
+		};
+	}
+	async getVideoUrl(jobId) {
+		let task;
+		try {
+			task = await this.retrieveTask(jobId);
+		} catch (error) {
+			if (error.status === 404) throw new Error(`Video job not found: ${jobId} (${error.message})`);
+			throw error;
+		}
+		if (this.mapStatus(task.status) === "failed") throw new Error(`Video generation failed: ${describeTaskFailure(task)}. Job ID: ${jobId}`);
+		const url = task.content?.video_url;
+		if (!url) throw new Error(`Video is not ready for download. Check status first. Job ID: ${jobId}`);
+		const anchorSeconds = task.updated_at ?? task.created_at;
+		const expiresAt = anchorSeconds !== void 0 ? /* @__PURE__ */ new Date(anchorSeconds * 1e3 + VIDEO_URL_TTL_MS) : void 0;
+		const usage = buildBytePlusVideoUsage(task.usage);
+		return {
+			jobId,
+			url,
+			...expiresAt && { expiresAt },
+			...usage && { usage }
+		};
+	}
+	/**
+	* Maps Seedance task states onto the generic video status set. `expired`
+	* (the task outlived `execution_expires_after`) and `cancelled` are
+	* terminal non-successes, so both report as failed.
+	*
+	* An unrecognized state throws rather than defaulting to `processing`.
+	* Core's poll loop treats `processing` as "keep waiting", so mapping an
+	* unknown state — a missing `status`, or a terminal one Ark adds later such
+	* as `rejected` — onto it means polling until `maxDuration` and then
+	* reporting a generic timeout, with the state Ark actually sent never
+	* reaching the caller. Failing here names it.
+	*/
+	mapStatus(apiStatus) {
+		switch (apiStatus) {
+			case "queued": return "pending";
+			case "running": return "processing";
+			case "succeeded": return "completed";
+			case "failed":
+			case "expired":
+			case "cancelled": return "failed";
+			case void 0:
+			default: throw new Error(`byteplus: unrecognized Seedance task status ${apiStatus === void 0 ? "(missing)" : `"${apiStatus}"`}. Known states: queued, running, succeeded, failed, expired, cancelled.`);
+		}
+	}
+	/**
+	* Seedance accepts any whole second inside a per-model range: 4–15s on the
+	* 2.0 family, 4–12s on 1.5-pro, 2–12s on the 1.0 models. An unknown model
+	* reports the union of those ranges as a UI hint — see
+	* `BYTEPLUS_VIDEO_FALLBACK_DURATIONS`, which `createVideoJob` does not snap
+	* against.
+	*/
+	availableDurations() {
+		return getBytePlusVideoDurationOptions(this.model);
+	}
+	/**
+	* Coerce a raw seconds value to the closest duration this model accepts
+	* (clamped to its range and rounded to whole seconds).
+	*/
+	snapDuration(seconds) {
+		return snapToDurationOption(seconds, this.availableDurations());
+	}
+};
+/**
+* Creates a BytePlus Seedance video adapter with an explicit API key.
+* Type resolution happens here at the call site.
+*
+* @experimental Video generation is an experimental feature and may change.
+*
+* @param model - The model name (e.g., 'seedance-1-0-pro-fast-251015')
+* @param apiKey - Your BytePlus Ark API key
+* @param config - Optional additional configuration
+* @returns Configured BytePlus video adapter instance with resolved types
+*
+* @example
+* ```typescript
+* const adapter = createBytePlusVideo('seedance-1-5-pro-251215', 'ark-...')
+*
+* const { jobId } = await generateVideo({
+*   adapter,
+*   prompt: 'a guitar being played in a store',
+*   size: '16:9_1080p',
+*   duration: 5,
+* })
+* ```
+*/
+function createBytePlusVideo(model, apiKey, config) {
+	return new BytePlusVideoAdapter({
+		apiKey,
+		...config
+	}, model);
+}
+/**
+* Creates a BytePlus Seedance video adapter, reading `ARK_API_KEY` from the
+* environment. Type resolution happens here at the call site.
+*
+* Note that Ark keys are region-isolated and Seedance is only served from the
+* Asia-Pacific endpoint — an EU key will not work here.
+*
+* @experimental Video generation is an experimental feature and may change.
+*
+* @param model - The model name (e.g., 'dreamina-seedance-2-0-260128')
+* @param config - Optional configuration (excluding apiKey, auto-detected)
+* @returns Configured BytePlus video adapter instance with resolved types
+* @throws Error if ARK_API_KEY is not found in environment
+*
+* @example
+* ```typescript
+* const adapter = byteplusVideo('dreamina-seedance-2-0-260128')
+*
+* // Image-to-video: an un-roled image is the opening frame.
+* const { jobId } = await generateVideo({
+*   adapter,
+*   prompt: [
+*     { type: 'text', content: 'the guitarist starts playing' },
+*     { type: 'image', source: { type: 'url', value: 'https://example.com/shop.jpg' } },
+*   ],
+* })
+*
+* const status = await getVideoJobStatus({ adapter, jobId })
+* ```
+*
+* ## Models this package does not know yet
+*
+* `model` also accepts any string, so a Seedance id BytePlus publishes after
+* this release works without upgrading. **Seedance 2.5 is the case this exists
+* for**: `dreamina-seedance-2-5-260628` is real and reachable, but its
+* capability cells could not be probed from this repo's account (Ark answers
+* 404 `ModelNotOpen` until the model is activated in the Ark Console), so it
+* is deliberately absent from the narrowed model tables. Passing it here works
+* for an account that has activated it.
+*
+* An unknown id relaxes both halves of the adapter: the `size` type widens to
+* any string, provider options are ungated, and the runtime guards that encode
+* per-model capabilities — resolution tiers, closing-frame and reference-media
+* support, frame cardinality and mode exclusivity, duration snapping — stand
+* down so Ark decides. Known ids are unaffected. See
+* {@link BytePlusVideoModelOrString} for how to discover and probe an id.
+*
+* @example
+* ```typescript
+* // Seedance 2.5, before this package ships probe-verified metadata for it:
+* const adapter = byteplusVideo('dreamina-seedance-2-5-260628')
+* ```
+*/
+function byteplusVideo(model, config) {
+	return createBytePlusVideo(model, getBytePlusArkApiKeyFromEnv(), config);
+}
+//#endregion
+export { BytePlusVideoAdapter, byteplusVideo, createBytePlusVideo };
+
+//# sourceMappingURL=video.js.map

package/dist/esm/adapters/video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.js","names":[],"sources":["../../../src/adapters/video.ts"],"sourcesContent":["import { resolveMediaPrompt } from '@tanstack/ai'\nimport { BaseVideoAdapter, snapToDurationOption } from '@tanstack/ai/adapters'\nimport { toRunErrorPayload } from '@tanstack/ai/adapter-internals'\nimport {\n  bytePlusArkError,\n  bytePlusArkHeaders,\n  bytePlusTimeoutSignal,\n  getBytePlusArkApiKeyFromEnv,\n  readJsonBody,\n  toHeaderRecord,\n  withBytePlusArkDefaults,\n} from '../utils/client'\nimport {\n  getBytePlusVideoDurationOptions,\n  isKnownBytePlusVideoModel,\n} from '../model-meta'\nimport {\n  resolveBytePlusVideoResolution,\n  resolveBytePlusVideoSize,\n  supportsLastFrame,\n  supportsReferenceMedia,\n} from '../video/video-provider-options'\nimport type { DurationOptions } from '@tanstack/ai/adapters'\nimport type {\n  AudioPart,\n  ImagePart,\n  MediaInputMetadata,\n  TokenUsage,\n  VideoGenerationOptions,\n  VideoJobResult,\n  VideoPart,\n  VideoStatusResult,\n  VideoUrlResult,\n} from '@tanstack/ai'\nimport type {\n  BytePlusVideoContentPart,\n  BytePlusVideoCreateRequest,\n  BytePlusVideoCreateResponse,\n  BytePlusVideoTask,\n  BytePlusVideoTaskStatus,\n  BytePlusVideoTaskUsage,\n} from '../video/wire-types'\nimport type { BytePlusVideoProviderOptions } from '../video/video-provider-options'\nimport type {\n  BytePlusVideoModelOrString,\n  ResolveBytePlusVideoInputModalities,\n  ResolveBytePlusVideoSize,\n} from '../model-meta'\nimport type { BytePlusArkConfig } from '../utils/client'\n\n/**\n * Configuration for the BytePlus Seedance video adapter.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport interface BytePlusVideoConfig extends BytePlusArkConfig {}\n\n/** Path of the Seedance task API, relative to the Ark base URL. */\nconst TASKS_PATH = '/contents/generations/tasks'\n\n/**\n * `content.video_url` and `content.last_frame_url` are deleted 24 hours after\n * the task produces them.\n */\nconst VIDEO_URL_TTL_MS = 24 * 60 * 60 * 1000\n\n/**\n * Converts a media prompt part into the URL string Seedance's `content[]`\n * takes: public URLs pass through (BytePlus fetches them server-side), data\n * sources become base64 data URIs.\n */\nfunction mediaPartToUrl(\n  part:\n    | ImagePart<MediaInputMetadata>\n    | VideoPart<MediaInputMetadata>\n    | AudioPart<MediaInputMetadata>,\n): string {\n  const { source } = part\n  if (source.type === 'url') return source.value\n  if (source.value.startsWith('data:')) return source.value\n  return `data:${source.mimeType.toLowerCase()};base64,${source.value}`\n}\n\n/** Coerces a usage count that the API types as a string but sends as a number. */\nfunction toTokenCount(value: number | string | undefined): number | undefined {\n  if (typeof value === 'number') return value\n  if (typeof value === 'string') {\n    const parsed = Number(value)\n    return Number.isFinite(parsed) ? parsed : undefined\n  }\n  return undefined\n}\n\n/**\n * Maps a finished task's usage onto `TokenUsage`.\n *\n * Seedance bills output only — the API documents input tokens as always 0 and\n * `total_tokens` as equal to `completion_tokens` — so `promptTokens` is 0 and\n * the completion count doubles as `unitsBilled`.\n */\nfunction buildBytePlusVideoUsage(\n  usage: BytePlusVideoTaskUsage | undefined,\n): TokenUsage | undefined {\n  if (!usage) return undefined\n\n  const completionTokens = toTokenCount(usage.completion_tokens)\n  const totalTokens = toTokenCount(usage.total_tokens)\n  if (completionTokens === undefined && totalTokens === undefined) {\n    return undefined\n  }\n\n  const completion = completionTokens ?? totalTokens ?? 0\n  return {\n    promptTokens: 0,\n    completionTokens: completion,\n    totalTokens: totalTokens ?? completion,\n    unitsBilled: completion,\n  }\n}\n\n/**\n * Formats a terminal task's error detail for a status / failure message.\n *\n * Always returns a string. Core surfaces a failed job as\n * `throw new Error(statusResult.error || 'Video generation failed')`, so\n * returning `undefined` for a failure Ark reported without an `error` block\n * would hand the caller an unattributable error. The final fallback is a\n * snapshot of the identifying fields instead.\n */\nfunction describeTaskFailure(task: BytePlusVideoTask): string {\n  const { code, message } = task.error ?? {}\n  if (code && message) return `${code}: ${message}`\n  if (message) return message\n  if (code) return code\n  // `expired` and `cancelled` are terminal without an `error` block.\n  if (task.status === 'expired') {\n    return 'Task expired before it finished (execution_expires_after elapsed).'\n  }\n  if (task.status === 'cancelled') return 'Task was cancelled.'\n  return (\n    `Task reported status \"${task.status ?? 'unknown'}\" with no error detail ` +\n    `(id=${task.id ?? 'unknown'}, model=${task.model ?? 'unknown'}).`\n  )\n}\n\n/**\n * BytePlus Seedance video generation adapter.\n *\n * Drives Ark's asynchronous task API — `POST /contents/generations/tasks` to\n * submit, `GET /contents/generations/tasks/{id}` to poll and to read the\n * finished video URL. Core owns the polling loop; this adapter implements the\n * three primitives plus the duration metadata.\n *\n * Prompt parts map onto Seedance's `content[]` roles, which the API sorts into\n * mutually exclusive task types:\n *\n * - `'start_frame'` (or a single un-roled image) → `first_frame` — the frame\n *   the video opens on (`i2v`).\n * - `'end_frame'` → `last_frame` — the frame it closes on (`flf2v`); Seedance\n *   requires a `first_frame` alongside it, and\n *   `seedance-1-0-pro-fast-251015` does not support it at all.\n * - `'reference'` / `'character'` → `reference_image`, video parts →\n *   `reference_video`, audio parts → `reference_audio` — subject and style\n *   references the model draws on (`r2v`, Seedance 2.0 family only).\n *\n * Frame roles and reference roles cannot be combined in one request, so the\n * adapter rejects a mix up front rather than surfacing a raw 400.\n *\n * @experimental Video generation is an experimental feature and may change.\n *\n * @example\n * ```typescript\n * const adapter = byteplusVideo('seedance-1-0-pro-fast-251015')\n *\n * const { jobId } = await generateVideo({\n *   adapter,\n *   prompt: 'a guitar being played in a store',\n *   size: '16:9_720p',\n *   duration: 4,\n *   modelOptions: { service_tier: 'flex' },\n * })\n * ```\n */\nexport class BytePlusVideoAdapter<\n  TModel extends BytePlusVideoModelOrString,\n> extends BaseVideoAdapter<\n  TModel,\n  BytePlusVideoProviderOptions,\n  Record<TModel, BytePlusVideoProviderOptions>,\n  Record<TModel, ResolveBytePlusVideoSize<TModel>>,\n  Record<TModel, ResolveBytePlusVideoInputModalities<TModel>>,\n  Record<TModel, number>\n> {\n  readonly name = 'byteplus' as const\n\n  /** Config with the Ark base URL resolved and its trailing slashes trimmed. */\n  private readonly clientConfig: Omit<BytePlusVideoConfig, 'baseURL'> & {\n    baseURL: string\n  }\n\n  constructor(config: BytePlusVideoConfig, model: TModel) {\n    super({}, model)\n    this.clientConfig = withBytePlusArkDefaults(config)\n  }\n\n  private async request(\n    path: string,\n    init?: Omit<RequestInit, 'headers'>,\n  ): Promise<{ response: Response; body: unknown }> {\n    const fetchImpl = this.clientConfig.fetch ?? fetch\n    const signal = bytePlusTimeoutSignal(this.clientConfig.timeout)\n    const response = await fetchImpl(`${this.clientConfig.baseURL}${path}`, {\n      ...init,\n      ...(signal && { signal }),\n      headers: bytePlusArkHeaders(\n        this.clientConfig.apiKey,\n        toHeaderRecord(this.clientConfig.defaultHeaders),\n      ),\n    })\n    return { response, body: await readJsonBody(response) }\n  }\n\n  /**\n   * Builds the `content[]` array from the resolved prompt, enforcing\n   * Seedance's role vocabulary and mode exclusivity.\n   */\n  private buildContent(\n    resolved: ReturnType<typeof resolveMediaPrompt>,\n  ): Array<BytePlusVideoContentPart> {\n    const model = this.model\n    const content: Array<BytePlusVideoContentPart> = []\n    if (resolved.text) content.push({ type: 'text', text: resolved.text })\n\n    // Every rule below except the role vocabulary itself is a claim about a\n    // *specific* model's capabilities, drawn from probing the six models that\n    // exist today. None of it can be true of a model that does not exist yet,\n    // so for an unknown id the guards stand down and Ark rules — otherwise the\n    // escape hatch would block exactly the requests it exists to enable (see\n    // BytePlusVideoModelOrString). 'mask' / 'control' still throw: Seedance's\n    // wire format has no field to carry them on any model.\n    const gated = isKnownBytePlusVideoModel(model)\n\n    let firstFrames = 0\n    let lastFrames = 0\n    // Audio counts as a reference for the mode-exclusivity check but not for\n    // the \"audio can't be the only reference\" rule, which wants a visual.\n    let visualReferences = 0\n    let audioReferences = 0\n\n    for (const part of resolved.images) {\n      const role = part.metadata?.role\n      switch (role) {\n        case 'mask':\n        case 'control':\n          throw new Error(\n            `byteplus: Seedance has no '${role}' image input on model ${model}. ` +\n              `Use 'start_frame', 'end_frame' or 'reference'.`,\n          )\n        case 'end_frame': {\n          if (gated && !supportsLastFrame(model)) {\n            throw new Error(\n              `byteplus: ${model} does not support a closing frame — it does ` +\n                `text-to-video and first-frame image-to-video only. Drop the ` +\n                `'end_frame' image or switch to a model with first-and-last-frame support.`,\n            )\n          }\n          lastFrames++\n          content.push({\n            type: 'image_url',\n            image_url: { url: mediaPartToUrl(part) },\n            role: 'last_frame',\n          })\n          break\n        }\n        case 'reference':\n        case 'character': {\n          if (gated && !supportsReferenceMedia(model)) {\n            throw new Error(\n              `byteplus: ${model} does not support reference images. Reference ` +\n                `media is available on the Seedance 2.0 family; on this model use ` +\n                `'start_frame' / 'end_frame' images instead.`,\n            )\n          }\n          visualReferences++\n          content.push({\n            type: 'image_url',\n            image_url: { url: mediaPartToUrl(part) },\n            role: 'reference_image',\n          })\n          break\n        }\n        // An un-roled image is the opening frame, matching the API's own\n        // default and the fal / Veo adapters' positional convention.\n        case 'start_frame':\n        case undefined: {\n          firstFrames++\n          content.push({\n            type: 'image_url',\n            image_url: { url: mediaPartToUrl(part) },\n            role: 'first_frame',\n          })\n          break\n        }\n      }\n    }\n\n    // Video and audio parts only exist in reference mode: Seedance rejects an\n    // un-roled video with \"reference media mode requires video role to be\n    // reference_video\", and has no frame-style role for either modality.\n    for (const part of resolved.videos) {\n      if (gated && !supportsReferenceMedia(model)) {\n        throw new Error(\n          `byteplus: ${model} does not accept video prompt parts. Reference ` +\n            `video is available on the Seedance 2.0 family only.`,\n        )\n      }\n      visualReferences++\n      content.push({\n        type: 'video_url',\n        video_url: { url: mediaPartToUrl(part) },\n        role: 'reference_video',\n      })\n    }\n\n    for (const part of resolved.audios) {\n      if (gated && !supportsReferenceMedia(model)) {\n        throw new Error(\n          `byteplus: ${model} does not accept audio prompt parts. Reference ` +\n            `audio is available on the Seedance 2.0 family only.`,\n        )\n      }\n      audioReferences++\n      content.push({\n        type: 'audio_url',\n        audio_url: { url: mediaPartToUrl(part) },\n        role: 'reference_audio',\n      })\n    }\n\n    const frames = firstFrames + lastFrames\n    if (gated && frames > 0 && visualReferences + audioReferences > 0) {\n      throw new Error(\n        `byteplus: first/last frame inputs cannot be combined with reference ` +\n          `media on model ${model}. Use either frame roles ('start_frame', ` +\n          `'end_frame') or reference roles ('reference', 'character', video, ` +\n          `audio) — not both.`,\n      )\n    }\n\n    if (gated && firstFrames > 1) {\n      throw new Error(\n        `byteplus: ${model} accepts at most one opening frame; received ` +\n          `${firstFrames} un-roled or 'start_frame' images. Use metadata.role ` +\n          `('end_frame', 'reference') to disambiguate the others.`,\n      )\n    }\n\n    if (gated && lastFrames > 1) {\n      throw new Error(\n        `byteplus: ${model} accepts at most one closing frame; received ` +\n          `${lastFrames} 'end_frame' images.`,\n      )\n    }\n\n    // Seedance treats a closing frame as the second half of first-and-last-\n    // frame mode: on its own it fails with \"last frame image content cannot be\n    // mixed with first frame or reference image content\".\n    if (gated && lastFrames > 0 && firstFrames === 0) {\n      throw new Error(\n        `byteplus: a closing frame needs an opening frame alongside it on ` +\n          `model ${model}. Add a 'start_frame' image, or drop the 'end_frame' role.`,\n      )\n    }\n\n    if (gated && audioReferences > 0 && visualReferences === 0) {\n      throw new Error(\n        `byteplus: a reference audio input cannot be the only reference on ` +\n          `model ${model}. Pair it with a reference image or video.`,\n      )\n    }\n\n    if (content.length === 0) {\n      throw new Error(\n        `byteplus: a video prompt must carry text or at least one media input ` +\n          `(model: ${model}).`,\n      )\n    }\n\n    return content\n  }\n\n  async createVideoJob(\n    options: VideoGenerationOptions<\n      BytePlusVideoProviderOptions,\n      ResolveBytePlusVideoSize<TModel>,\n      number\n    >,\n  ): Promise<VideoJobResult> {\n    const { size, modelOptions, logger } = options\n    const model = this.model\n\n    const content = this.buildContent(resolveMediaPrompt(options.prompt))\n\n    // The generic `size` carries a \"ratio_resolution\" template and splits back\n    // into Seedance's separate fields. Explicit modelOptions win below.\n    const parsedSize =\n      size !== undefined ? resolveBytePlusVideoSize(model, size) : undefined\n\n    // Coerce the requested duration into the model's range rather than letting\n    // the API reject it. `modelOptions.duration` is deliberately not snapped:\n    // it is the escape hatch for `-1` (model picks the length).\n    //\n    // An unknown model's duration goes through verbatim. Snapping it would\n    // mean clamping against the ranges today's models happen to have, so a\n    // future model's legitimate 20-second request would silently become 15 —\n    // corrupting the request instead of protecting it.\n    const duration =\n      options.duration !== undefined\n        ? isKnownBytePlusVideoModel(model)\n          ? this.snapDuration(options.duration)\n          : options.duration\n        : undefined\n\n    const request: BytePlusVideoCreateRequest = {\n      ...(parsedSize && {\n        ratio: parsedSize.ratio,\n        ...(parsedSize.resolution !== undefined && {\n          resolution: parsedSize.resolution,\n        }),\n      }),\n      ...(duration !== undefined && { duration }),\n      // Explicit provider options win over everything derived above.\n      ...modelOptions,\n      model,\n      content,\n    }\n\n    // Validate what actually ships, not just what `size` contributed: a\n    // `modelOptions.resolution` overriding an already-checked size would\n    // otherwise reach Ark unchecked.\n    if (request.resolution !== undefined) {\n      request.resolution = resolveBytePlusVideoResolution(\n        model,\n        request.resolution,\n      )\n    }\n\n    try {\n      logger.request(\n        `activity=video.create provider=${this.name} model=${model} size=${size ?? 'default'} duration=${request.duration ?? 'default'}`,\n        { provider: this.name, model },\n      )\n\n      const { response, body } = await this.request(TASKS_PATH, {\n        method: 'POST',\n        body: JSON.stringify(request),\n      })\n      if (!response.ok) {\n        throw bytePlusArkError(response.status, body, 'video task creation')\n      }\n\n      const { id } = (body ?? {}) as BytePlusVideoCreateResponse\n      if (!id) {\n        throw new Error('byteplus: video task creation returned no task id.')\n      }\n\n      return { jobId: id, model }\n    } catch (error: unknown) {\n      logger.errors(`${this.name}.createVideoJob fatal`, {\n        error: toRunErrorPayload(error, `${this.name}.createVideoJob failed`),\n        source: `${this.name}.createVideoJob`,\n      })\n      throw error\n    }\n  }\n\n  /**\n   * Fetches a task, tagging the thrown error with the HTTP status.\n   *\n   * The 200 body is validated rather than cast. `readJsonBody` returns\n   * `undefined` for an empty body and the raw text for a non-JSON one — both\n   * documented failure modes of these hosts (an HTML error page from a proxy\n   * in front of the API). Casting either to `BytePlusVideoTask` yields a task\n   * whose `status` is `undefined`, which {@link mapStatus} would have to\n   * interpret; the honest answer is that the response was not a task at all,\n   * so say so while the body is still in hand.\n   */\n  private async retrieveTask(jobId: string): Promise<BytePlusVideoTask> {\n    const { response, body } = await this.request(\n      `${TASKS_PATH}/${encodeURIComponent(jobId)}`,\n    )\n    if (!response.ok) {\n      const error = bytePlusArkError(response.status, body, 'video task lookup')\n      ;(error as { status?: number }).status = response.status\n      throw error\n    }\n    if (typeof body !== 'object' || body === null) {\n      throw bytePlusArkError(\n        response.status,\n        body,\n        `video task lookup (job ${jobId}) returned a non-object body`,\n      )\n    }\n    return body as BytePlusVideoTask\n  }\n\n  async getVideoStatus(jobId: string): Promise<VideoStatusResult> {\n    let task: BytePlusVideoTask\n    try {\n      task = await this.retrieveTask(jobId)\n    } catch (error) {\n      // A task record lives 7 days from creation; past that the id 404s. Keep\n      // Ark's own code/message: a 404 from a wrong baseURL, a proxy, or a\n      // region mismatch is not an expired job id, and collapsing them all to\n      // \"Job not found\" sends the caller hunting the wrong thing.\n      if ((error as { status?: number }).status === 404) {\n        return {\n          jobId,\n          status: 'failed',\n          error: `Job not found: ${jobId} (${(error as Error).message})`,\n        }\n      }\n      throw error\n    }\n\n    const status = this.mapStatus(task.status)\n    const failure = status === 'failed' ? describeTaskFailure(task) : undefined\n    return {\n      jobId,\n      status,\n      ...(failure !== undefined && { error: failure }),\n    }\n  }\n\n  async getVideoUrl(jobId: string): Promise<VideoUrlResult> {\n    let task: BytePlusVideoTask\n    try {\n      task = await this.retrieveTask(jobId)\n    } catch (error) {\n      // See getVideoStatus: Ark's detail distinguishes an expired id from a\n      // misrouted request.\n      if ((error as { status?: number }).status === 404) {\n        throw new Error(\n          `Video job not found: ${jobId} (${(error as Error).message})`,\n        )\n      }\n      throw error\n    }\n\n    const status = this.mapStatus(task.status)\n    if (status === 'failed') {\n      throw new Error(\n        `Video generation failed: ${describeTaskFailure(task)}. Job ID: ${jobId}`,\n      )\n    }\n\n    const url = task.content?.video_url\n    if (!url) {\n      throw new Error(\n        `Video is not ready for download. Check status first. Job ID: ${jobId}`,\n      )\n    }\n\n    // The 24-hour window runs from when the output was produced, which is the\n    // last status change on a succeeded task — `created_at` anchors the\n    // separate 7-day retention of the task record itself, and can be far\n    // earlier (a live `flex` task sat queued ~15 minutes). Corroborated by the\n    // signed TOS link itself, which carries `X-Tos-Expires=86400` from an\n    // `X-Tos-Date` matching `updated_at`. Fall back to `created_at` only when\n    // `updated_at` is missing.\n    const anchorSeconds = task.updated_at ?? task.created_at\n    const expiresAt =\n      anchorSeconds !== undefined\n        ? new Date(anchorSeconds * 1000 + VIDEO_URL_TTL_MS)\n        : undefined\n\n    const usage = buildBytePlusVideoUsage(task.usage)\n    return {\n      jobId,\n      url,\n      ...(expiresAt && { expiresAt }),\n      ...(usage && { usage }),\n    }\n  }\n\n  /**\n   * Maps Seedance task states onto the generic video status set. `expired`\n   * (the task outlived `execution_expires_after`) and `cancelled` are\n   * terminal non-successes, so both report as failed.\n   *\n   * An unrecognized state throws rather than defaulting to `processing`.\n   * Core's poll loop treats `processing` as \"keep waiting\", so mapping an\n   * unknown state — a missing `status`, or a terminal one Ark adds later such\n   * as `rejected` — onto it means polling until `maxDuration` and then\n   * reporting a generic timeout, with the state Ark actually sent never\n   * reaching the caller. Failing here names it.\n   */\n  protected mapStatus(\n    apiStatus: BytePlusVideoTaskStatus | string | undefined,\n  ): VideoStatusResult['status'] {\n    switch (apiStatus) {\n      case 'queued':\n        return 'pending'\n      case 'running':\n        return 'processing'\n      case 'succeeded':\n        return 'completed'\n      case 'failed':\n      case 'expired':\n      case 'cancelled':\n        return 'failed'\n      case undefined:\n      default:\n        throw new Error(\n          `byteplus: unrecognized Seedance task status ` +\n            `${apiStatus === undefined ? '(missing)' : `\"${apiStatus}\"`}. ` +\n            `Known states: queued, running, succeeded, failed, expired, cancelled.`,\n        )\n    }\n  }\n\n  /**\n   * Seedance accepts any whole second inside a per-model range: 4–15s on the\n   * 2.0 family, 4–12s on 1.5-pro, 2–12s on the 1.0 models. An unknown model\n   * reports the union of those ranges as a UI hint — see\n   * `BYTEPLUS_VIDEO_FALLBACK_DURATIONS`, which `createVideoJob` does not snap\n   * against.\n   */\n  override availableDurations(): DurationOptions<number> {\n    return getBytePlusVideoDurationOptions(this.model)\n  }\n\n  /**\n   * Coerce a raw seconds value to the closest duration this model accepts\n   * (clamped to its range and rounded to whole seconds).\n   */\n  override snapDuration(seconds: number): number | undefined {\n    return snapToDurationOption(seconds, this.availableDurations())\n  }\n}\n\n/**\n * Creates a BytePlus Seedance video adapter with an explicit API key.\n * Type resolution happens here at the call site.\n *\n * @experimental Video generation is an experimental feature and may change.\n *\n * @param model - The model name (e.g., 'seedance-1-0-pro-fast-251015')\n * @param apiKey - Your BytePlus Ark API key\n * @param config - Optional additional configuration\n * @returns Configured BytePlus video adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = createBytePlusVideo('seedance-1-5-pro-251215', 'ark-...')\n *\n * const { jobId } = await generateVideo({\n *   adapter,\n *   prompt: 'a guitar being played in a store',\n *   size: '16:9_1080p',\n *   duration: 5,\n * })\n * ```\n */\nexport function createBytePlusVideo<TModel extends BytePlusVideoModelOrString>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<BytePlusVideoConfig, 'apiKey'>,\n): BytePlusVideoAdapter<TModel> {\n  return new BytePlusVideoAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a BytePlus Seedance video adapter, reading `ARK_API_KEY` from the\n * environment. Type resolution happens here at the call site.\n *\n * Note that Ark keys are region-isolated and Seedance is only served from the\n * Asia-Pacific endpoint — an EU key will not work here.\n *\n * @experimental Video generation is an experimental feature and may change.\n *\n * @param model - The model name (e.g., 'dreamina-seedance-2-0-260128')\n * @param config - Optional configuration (excluding apiKey, auto-detected)\n * @returns Configured BytePlus video adapter instance with resolved types\n * @throws Error if ARK_API_KEY is not found in environment\n *\n * @example\n * ```typescript\n * const adapter = byteplusVideo('dreamina-seedance-2-0-260128')\n *\n * // Image-to-video: an un-roled image is the opening frame.\n * const { jobId } = await generateVideo({\n *   adapter,\n *   prompt: [\n *     { type: 'text', content: 'the guitarist starts playing' },\n *     { type: 'image', source: { type: 'url', value: 'https://example.com/shop.jpg' } },\n *   ],\n * })\n *\n * const status = await getVideoJobStatus({ adapter, jobId })\n * ```\n *\n * ## Models this package does not know yet\n *\n * `model` also accepts any string, so a Seedance id BytePlus publishes after\n * this release works without upgrading. **Seedance 2.5 is the case this exists\n * for**: `dreamina-seedance-2-5-260628` is real and reachable, but its\n * capability cells could not be probed from this repo's account (Ark answers\n * 404 `ModelNotOpen` until the model is activated in the Ark Console), so it\n * is deliberately absent from the narrowed model tables. Passing it here works\n * for an account that has activated it.\n *\n * An unknown id relaxes both halves of the adapter: the `size` type widens to\n * any string, provider options are ungated, and the runtime guards that encode\n * per-model capabilities — resolution tiers, closing-frame and reference-media\n * support, frame cardinality and mode exclusivity, duration snapping — stand\n * down so Ark decides. Known ids are unaffected. See\n * {@link BytePlusVideoModelOrString} for how to discover and probe an id.\n *\n * @example\n * ```typescript\n * // Seedance 2.5, before this package ships probe-verified metadata for it:\n * const adapter = byteplusVideo('dreamina-seedance-2-5-260628')\n * ```\n */\nexport function byteplusVideo<TModel extends BytePlusVideoModelOrString>(\n  model: TModel,\n  config?: Omit<BytePlusVideoConfig, 'apiKey'>,\n): BytePlusVideoAdapter<TModel> {\n  const apiKey = getBytePlusArkApiKeyFromEnv()\n  return createBytePlusVideo(model, apiKey, config)\n}\n"],"mappings":"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"}

package/dist/esm/audio/transcription-provider-options.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Provider-specific options for BytePlus Seed Speech ASR
+ * (`POST /api/v3/auc/bigmodel/recognize/flash`).
+ *
+ * Field names mirror the wire format: everything except `uid` and
+ * `audio_format` is forwarded inside the request's `request` block.
+ */
+export interface BytePlusTranscriptionProviderOptions {
+    /**
+     * Recognition model family. Defaults to `bigmodel`; the specific model is
+     * selected by the `X-Api-Resource-Id` header rather than by this value.
+     */
+    model_name?: string;
+    /**
+     * Container hint for the submitted audio (`mp3`, `wav`, `ogg`, …). Only
+     * needed when the format can't be inferred from the input — a `File`'s name
+     * or MIME type, or a data URL's MIME type, is used automatically.
+     */
+    audio_format?: string;
+    /** Inverse text normalisation: render spoken numbers, dates etc. as digits. */
+    enable_itn?: boolean;
+    /** Insert punctuation into the transcript. */
+    enable_punc?: boolean;
+    /** Disfluency removal — drop fillers and stutters. */
+    enable_ddc?: boolean;
+    /**
+     * Attach speaker labels to each utterance. When present they are surfaced
+     * as `segment.speaker` on the result.
+     */
+    enable_speaker_info?: boolean;
+    /**
+     * Return the per-utterance breakdown as well as the flat transcript.
+     * Defaults to `true` so `segments` and `words` are populated.
+     */
+    show_utterances?: boolean;
+    /**
+     * Spoken-language hint (e.g. `en-US`). Overrides the cross-provider
+     * `TranscriptionOptions.language`.
+     */
+    language?: string;
+    /**
+     * Caller identifier echoed back in BytePlus' request logs. Useful for
+     * correlating usage; defaults to `tanstack-ai`.
+     */
+    uid?: string;
+}