import { isProviderApiKeyConfigured } from "openclaw/plugin-sdk/provider-auth"; import { resolveApiKeyForProvider } from "openclaw/plugin-sdk/provider-auth-runtime"; import { assertOkOrThrowHttpError, createProviderOperationDeadline, fetchWithTimeout, postJsonRequest, resolveProviderOperationTimeoutMs, resolveProviderHttpRequestConfig, waitProviderOperationPollInterval, } from "openclaw/plugin-sdk/provider-http"; import { normalizeOptionalString } from "openclaw/plugin-sdk/text-runtime"; import type { GeneratedVideoAsset, VideoGenerationProvider, VideoGenerationRequest, } from "openclaw/plugin-sdk/video-generation"; import { BYTEPLUS_BASE_URL } from "./models.js"; const DEFAULT_BYTEPLUS_VIDEO_MODEL = "seedance-1-0-lite-t2v-250428"; const DEFAULT_TIMEOUT_MS = 120_000; const POLL_INTERVAL_MS = 5_000; const MAX_POLL_ATTEMPTS = 120; type BytePlusTaskCreateResponse = { id?: string; }; type BytePlusTaskResponse = { id?: string; model?: string; status?: "running" | "failed" | "queued" | "succeeded" | "cancelled"; error?: { code?: string; message?: string; }; content?: { video_url?: string; last_frame_url?: string; file_url?: string; }; duration?: number; ratio?: string; resolution?: string; }; function resolveBytePlusVideoBaseUrl(req: VideoGenerationRequest): string { return ( normalizeOptionalString(req.cfg?.models?.providers?.byteplus?.baseUrl) ?? BYTEPLUS_BASE_URL ); } function toDataUrl(buffer: Buffer, mimeType: string): string { return `data:${mimeType};base64,${buffer.toString("base64")}`; } function resolveBytePlusImageUrl(req: VideoGenerationRequest): string | undefined { const input = req.inputImages?.[0]; if (!input) { return undefined; } const inputUrl = normalizeOptionalString(input.url); if (inputUrl) { return inputUrl; } if (!input.buffer) { throw new Error("BytePlus reference image is missing image data."); } return toDataUrl(input.buffer, normalizeOptionalString(input.mimeType) ?? "image/png"); } async function pollBytePlusTask(params: { taskId: string; headers: Headers; timeoutMs?: number; baseUrl: string; fetchFn: typeof fetch; }): Promise { const deadline = createProviderOperationDeadline({ timeoutMs: params.timeoutMs, label: `BytePlus video generation task ${params.taskId}`, }); for (let attempt = 0; attempt < MAX_POLL_ATTEMPTS; attempt += 1) { const response = await fetchWithTimeout( `${params.baseUrl}/contents/generations/tasks/${params.taskId}`, { method: "GET", headers: params.headers, }, resolveProviderOperationTimeoutMs({ deadline, defaultTimeoutMs: DEFAULT_TIMEOUT_MS }), params.fetchFn, ); await assertOkOrThrowHttpError(response, "BytePlus video status request failed"); const payload = (await response.json()) as BytePlusTaskResponse; switch (normalizeOptionalString(payload.status)) { case "succeeded": return payload; case "failed": case "cancelled": throw new Error( normalizeOptionalString(payload.error?.message) || "BytePlus video generation failed", ); case "queued": case "running": default: await waitProviderOperationPollInterval({ deadline, pollIntervalMs: POLL_INTERVAL_MS }); break; } } throw new Error(`BytePlus video generation task ${params.taskId} did not finish in time`); } async function downloadBytePlusVideo(params: { url: string; timeoutMs?: number; fetchFn: typeof fetch; }): Promise { const response = await fetchWithTimeout( params.url, { method: "GET" }, params.timeoutMs ?? DEFAULT_TIMEOUT_MS, params.fetchFn, ); await assertOkOrThrowHttpError(response, "BytePlus generated video download failed"); const mimeType = normalizeOptionalString(response.headers.get("content-type")) ?? "video/mp4"; const arrayBuffer = await response.arrayBuffer(); return { buffer: Buffer.from(arrayBuffer), mimeType, fileName: `video-1.${mimeType.includes("webm") ? "webm" : "mp4"}`, }; } export function buildBytePlusVideoGenerationProvider(): VideoGenerationProvider { return { id: "byteplus", label: "BytePlus", defaultModel: DEFAULT_BYTEPLUS_VIDEO_MODEL, models: [ DEFAULT_BYTEPLUS_VIDEO_MODEL, "seedance-1-0-lite-i2v-250428", "seedance-1-0-pro-250528", "seedance-1-5-pro-251215", ], isConfigured: ({ agentDir }) => isProviderApiKeyConfigured({ provider: "byteplus", agentDir, }), capabilities: { providerOptions: { seed: "number", draft: "boolean", camera_fixed: "boolean", }, generate: { maxVideos: 1, maxDurationSeconds: 12, supportsAspectRatio: true, supportsResolution: true, supportsAudio: true, supportsWatermark: true, }, imageToVideo: { enabled: true, maxVideos: 1, maxInputImages: 1, maxDurationSeconds: 12, supportsAspectRatio: true, supportsResolution: true, supportsAudio: true, supportsWatermark: true, }, videoToVideo: { enabled: false, }, }, async generateVideo(req) { if ((req.inputVideos?.length ?? 0) > 0) { throw new Error("BytePlus video generation does not support video reference inputs."); } const auth = await resolveApiKeyForProvider({ provider: "byteplus", cfg: req.cfg, agentDir: req.agentDir, store: req.authStore, }); if (!auth.apiKey) { throw new Error("BytePlus API key missing"); } const fetchFn = fetch; const deadline = createProviderOperationDeadline({ timeoutMs: req.timeoutMs, label: "BytePlus video generation", }); const { baseUrl, allowPrivateNetwork, headers, dispatcherPolicy } = resolveProviderHttpRequestConfig({ baseUrl: resolveBytePlusVideoBaseUrl(req), defaultBaseUrl: BYTEPLUS_BASE_URL, allowPrivateNetwork: false, defaultHeaders: { Authorization: `Bearer ${auth.apiKey}`, "Content-Type": "application/json", }, provider: "byteplus", capability: "video", transport: "http", }); // Seedance 1.0 has separate T2V and I2V model IDs (e.g. seedance-1-0-lite-t2v-250428 vs // seedance-1-0-lite-i2v-250428). When input images are provided with a T2V model, auto- // switch to the corresponding I2V variant so the API does not reject with task_type mismatch. // 1.5 Pro uses a single model ID for both modes and is unaffected by this substitution. const hasInputImages = (req.inputImages?.length ?? 0) > 0; const requestedModel = normalizeOptionalString(req.model) || DEFAULT_BYTEPLUS_VIDEO_MODEL; const resolvedModel = hasInputImages && requestedModel.includes("-t2v-") ? requestedModel.replace("-t2v-", "-i2v-") : requestedModel; const content: Array> = [{ type: "text", text: req.prompt }]; const imageUrl = resolveBytePlusImageUrl(req); if (imageUrl) { content.push({ type: "image_url", image_url: { url: imageUrl }, role: "first_frame", }); } const body: Record = { model: resolvedModel, content, }; const aspectRatio = normalizeOptionalString(req.aspectRatio); if (aspectRatio) { body.ratio = aspectRatio; } // Seedance API requires lowercase resolution values (e.g. "480p", "720p"); uppercase // variants like "480P" are rejected with InvalidParameter. const resolution = normalizeOptionalString(req.resolution)?.toLowerCase(); if (resolution) { body.resolution = resolution; } if (typeof req.durationSeconds === "number" && Number.isFinite(req.durationSeconds)) { body.duration = Math.max(1, Math.round(req.durationSeconds)); } if (typeof req.audio === "boolean") { body.generate_audio = req.audio; } if (typeof req.watermark === "boolean") { body.watermark = req.watermark; } // Forward declared providerOptions: seed, draft, camerafixed. // draft=true forces 480p resolution for faster generation. const opts = req.providerOptions ?? {}; const seed = typeof opts.seed === "number" ? opts.seed : undefined; const draft = opts.draft === true; // Official JSON body field is camera_fixed (with underscore). const cameraFixed = typeof opts.camera_fixed === "boolean" ? opts.camera_fixed : undefined; if (seed != null) { body.seed = seed; } if (draft && !body.resolution) { body.resolution = "480p"; } if (cameraFixed != null) { body.camera_fixed = cameraFixed; } const { response, release } = await postJsonRequest({ url: `${baseUrl}/contents/generations/tasks`, headers, body, timeoutMs: resolveProviderOperationTimeoutMs({ deadline, defaultTimeoutMs: DEFAULT_TIMEOUT_MS, }), fetchFn, allowPrivateNetwork, dispatcherPolicy, }); try { await assertOkOrThrowHttpError(response, "BytePlus video generation failed"); const submitted = (await response.json()) as BytePlusTaskCreateResponse; const taskId = normalizeOptionalString(submitted.id); if (!taskId) { throw new Error("BytePlus video generation response missing task id"); } const completed = await pollBytePlusTask({ taskId, headers, timeoutMs: resolveProviderOperationTimeoutMs({ deadline, defaultTimeoutMs: DEFAULT_TIMEOUT_MS, }), baseUrl, fetchFn, }); const videoUrl = normalizeOptionalString(completed.content?.video_url); if (!videoUrl) { throw new Error("BytePlus video generation completed without a video URL"); } const video = await downloadBytePlusVideo({ url: videoUrl, timeoutMs: resolveProviderOperationTimeoutMs({ deadline, defaultTimeoutMs: DEFAULT_TIMEOUT_MS, }), fetchFn, }); return { videos: [video], model: completed.model ?? resolvedModel, metadata: { taskId, status: completed.status, videoUrl, ratio: completed.ratio, resolution: completed.resolution, duration: completed.duration, }, }; } finally { await release(); } }, }; }