@blockrun/llm 3.1.0 → 3.2.1

package/dist/index.cjs

@@ -2606,11 +2606,62 @@ var VideoClient = class {
     const budgetMs = options?.budgetMs ?? DEFAULT_GENERATE_BUDGET_MS;
     return this.submitAndPoll(body, budgetMs);
   }
+  /**
+   * Generate a video from a standard Seedance `content[]` body.
+   *
+   * Targets the gateway's `POST /v1/videos` endpoint, which accepts the
+   * mainstream multimodal `content` array (text + a single reference image)
+   * used by other Seedance APIs — so callers already holding a
+   * `content[]`-shaped request can submit it unchanged. The gateway validates
+   * unsupported inputs *before* charging, then delegates to the same x402
+   * submit+poll pipeline as {@link generate}.
+   *
+   * Most SDK users should prefer {@link generate} (structured options like
+   * `imageUrl` / `lastFrameUrl`) — this exists for migrating existing
+   * `content[]` payloads with no reshaping.
+   *
+   * @param content - The Seedance `content` array, e.g.
+   *   `[{ type: "text", text: "a red apple spinning" }]` or a text item plus
+   *   `{ type: "image_url", image_url: { url: "https://..." } }`.
+   * @param options - `model`, `budgetMs`, plus the same camelCase render options
+   *   as {@link generate} (`durationSeconds`, `aspectRatio`, `resolution`,
+   *   `generateAudio`, `seed`, `watermark`, `returnLastFrame`). These are mapped
+   *   to the gateway's snake_case fields for you. Any other keys you pass are
+   *   forwarded verbatim (use snake_case for those, since the gateway reads
+   *   snake_case only).
+   */
+  async generateFromContent(content, options) {
+    if (!Array.isArray(content) || content.length === 0) {
+      throw new Error("content must be a non-empty array of Seedance content items.");
+    }
+    const {
+      model,
+      budgetMs,
+      durationSeconds,
+      aspectRatio,
+      resolution,
+      generateAudio,
+      seed,
+      watermark,
+      returnLastFrame,
+      ...extra
+    } = options ?? {};
+    const body = { content, ...extra };
+    if (model !== void 0) body.model = model;
+    if (durationSeconds !== void 0) body.duration_seconds = durationSeconds;
+    if (aspectRatio !== void 0) body.aspect_ratio = aspectRatio;
+    if (resolution !== void 0) body.resolution = resolution;
+    if (generateAudio !== void 0) body.generate_audio = generateAudio;
+    if (seed !== void 0) body.seed = seed;
+    if (watermark !== void 0) body.watermark = watermark;
+    if (returnLastFrame !== void 0) body.return_last_frame = returnLastFrame;
+    return this.submitAndPoll(body, budgetMs ?? DEFAULT_GENERATE_BUDGET_MS, "/v1/videos");
+  }
   // --------------------------------------------------------------------
   // Internal: async submit + poll
   // --------------------------------------------------------------------
-  async submitAndPoll(body, budgetMs) {
-    const submitUrl = `${this.apiUrl}/v1/videos/generations`;
+  async submitAndPoll(body, budgetMs, submitPath = "/v1/videos/generations") {
+    const submitUrl = `${this.apiUrl}${submitPath}`;
     const resp402 = await this.fetchWithTimeout(submitUrl, {
       method: "POST",
       headers: { "Content-Type": "application/json" },

package/dist/index.d.cts

@@ -1698,6 +1698,41 @@ declare class VideoClient {
     generate(prompt: string, options?: VideoGenerateOptions & {
         budgetMs?: number;
     }): Promise<VideoResponse>;
+    /**
+     * Generate a video from a standard Seedance `content[]` body.
+     *
+     * Targets the gateway's `POST /v1/videos` endpoint, which accepts the
+     * mainstream multimodal `content` array (text + a single reference image)
+     * used by other Seedance APIs — so callers already holding a
+     * `content[]`-shaped request can submit it unchanged. The gateway validates
+     * unsupported inputs *before* charging, then delegates to the same x402
+     * submit+poll pipeline as {@link generate}.
+     *
+     * Most SDK users should prefer {@link generate} (structured options like
+     * `imageUrl` / `lastFrameUrl`) — this exists for migrating existing
+     * `content[]` payloads with no reshaping.
+     *
+     * @param content - The Seedance `content` array, e.g.
+     *   `[{ type: "text", text: "a red apple spinning" }]` or a text item plus
+     *   `{ type: "image_url", image_url: { url: "https://..." } }`.
+     * @param options - `model`, `budgetMs`, plus the same camelCase render options
+     *   as {@link generate} (`durationSeconds`, `aspectRatio`, `resolution`,
+     *   `generateAudio`, `seed`, `watermark`, `returnLastFrame`). These are mapped
+     *   to the gateway's snake_case fields for you. Any other keys you pass are
+     *   forwarded verbatim (use snake_case for those, since the gateway reads
+     *   snake_case only).
+     */
+    generateFromContent(content: Array<Record<string, unknown>>, options?: {
+        model?: string;
+        budgetMs?: number;
+        durationSeconds?: number;
+        aspectRatio?: string;
+        resolution?: string;
+        generateAudio?: boolean;
+        seed?: number;
+        watermark?: boolean;
+        returnLastFrame?: boolean;
+    } & Record<string, unknown>): Promise<VideoResponse>;
     private submitAndPoll;
     private absolute;
     private extractPaymentRequired;

package/dist/index.d.ts

@@ -1698,6 +1698,41 @@ declare class VideoClient {
     generate(prompt: string, options?: VideoGenerateOptions & {
         budgetMs?: number;
     }): Promise<VideoResponse>;
+    /**
+     * Generate a video from a standard Seedance `content[]` body.
+     *
+     * Targets the gateway's `POST /v1/videos` endpoint, which accepts the
+     * mainstream multimodal `content` array (text + a single reference image)
+     * used by other Seedance APIs — so callers already holding a
+     * `content[]`-shaped request can submit it unchanged. The gateway validates
+     * unsupported inputs *before* charging, then delegates to the same x402
+     * submit+poll pipeline as {@link generate}.
+     *
+     * Most SDK users should prefer {@link generate} (structured options like
+     * `imageUrl` / `lastFrameUrl`) — this exists for migrating existing
+     * `content[]` payloads with no reshaping.
+     *
+     * @param content - The Seedance `content` array, e.g.
+     *   `[{ type: "text", text: "a red apple spinning" }]` or a text item plus
+     *   `{ type: "image_url", image_url: { url: "https://..." } }`.
+     * @param options - `model`, `budgetMs`, plus the same camelCase render options
+     *   as {@link generate} (`durationSeconds`, `aspectRatio`, `resolution`,
+     *   `generateAudio`, `seed`, `watermark`, `returnLastFrame`). These are mapped
+     *   to the gateway's snake_case fields for you. Any other keys you pass are
+     *   forwarded verbatim (use snake_case for those, since the gateway reads
+     *   snake_case only).
+     */
+    generateFromContent(content: Array<Record<string, unknown>>, options?: {
+        model?: string;
+        budgetMs?: number;
+        durationSeconds?: number;
+        aspectRatio?: string;
+        resolution?: string;
+        generateAudio?: boolean;
+        seed?: number;
+        watermark?: boolean;
+        returnLastFrame?: boolean;
+    } & Record<string, unknown>): Promise<VideoResponse>;
     private submitAndPoll;
     private absolute;
     private extractPaymentRequired;

package/dist/index.js

@@ -2499,11 +2499,62 @@ var VideoClient = class {
     const budgetMs = options?.budgetMs ?? DEFAULT_GENERATE_BUDGET_MS;
     return this.submitAndPoll(body, budgetMs);
   }
+  /**
+   * Generate a video from a standard Seedance `content[]` body.
+   *
+   * Targets the gateway's `POST /v1/videos` endpoint, which accepts the
+   * mainstream multimodal `content` array (text + a single reference image)
+   * used by other Seedance APIs — so callers already holding a
+   * `content[]`-shaped request can submit it unchanged. The gateway validates
+   * unsupported inputs *before* charging, then delegates to the same x402
+   * submit+poll pipeline as {@link generate}.
+   *
+   * Most SDK users should prefer {@link generate} (structured options like
+   * `imageUrl` / `lastFrameUrl`) — this exists for migrating existing
+   * `content[]` payloads with no reshaping.
+   *
+   * @param content - The Seedance `content` array, e.g.
+   *   `[{ type: "text", text: "a red apple spinning" }]` or a text item plus
+   *   `{ type: "image_url", image_url: { url: "https://..." } }`.
+   * @param options - `model`, `budgetMs`, plus the same camelCase render options
+   *   as {@link generate} (`durationSeconds`, `aspectRatio`, `resolution`,
+   *   `generateAudio`, `seed`, `watermark`, `returnLastFrame`). These are mapped
+   *   to the gateway's snake_case fields for you. Any other keys you pass are
+   *   forwarded verbatim (use snake_case for those, since the gateway reads
+   *   snake_case only).
+   */
+  async generateFromContent(content, options) {
+    if (!Array.isArray(content) || content.length === 0) {
+      throw new Error("content must be a non-empty array of Seedance content items.");
+    }
+    const {
+      model,
+      budgetMs,
+      durationSeconds,
+      aspectRatio,
+      resolution,
+      generateAudio,
+      seed,
+      watermark,
+      returnLastFrame,
+      ...extra
+    } = options ?? {};
+    const body = { content, ...extra };
+    if (model !== void 0) body.model = model;
+    if (durationSeconds !== void 0) body.duration_seconds = durationSeconds;
+    if (aspectRatio !== void 0) body.aspect_ratio = aspectRatio;
+    if (resolution !== void 0) body.resolution = resolution;
+    if (generateAudio !== void 0) body.generate_audio = generateAudio;
+    if (seed !== void 0) body.seed = seed;
+    if (watermark !== void 0) body.watermark = watermark;
+    if (returnLastFrame !== void 0) body.return_last_frame = returnLastFrame;
+    return this.submitAndPoll(body, budgetMs ?? DEFAULT_GENERATE_BUDGET_MS, "/v1/videos");
+  }
   // --------------------------------------------------------------------
   // Internal: async submit + poll
   // --------------------------------------------------------------------
-  async submitAndPoll(body, budgetMs) {
-    const submitUrl = `${this.apiUrl}/v1/videos/generations`;
+  async submitAndPoll(body, budgetMs, submitPath = "/v1/videos/generations") {
+    const submitUrl = `${this.apiUrl}${submitPath}`;
     const resp402 = await this.fetchWithTimeout(submitUrl, {
       method: "POST",
       headers: { "Content-Type": "application/json" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/llm",
-  "version": "3.1.0",
+  "version": "3.2.1",
   "type": "module",
   "description": "BlockRun SDK - Pay-per-request AI (LLM, Image, Video, Music, Voice) via x402 on Base and Solana",
   "main": "dist/index.cjs",