@hedra/sdk 2.0.0 → 3.0.0

package/dist/esm/api/types/InputSeedance25EndImage.d.mts

@@ -1,6 +1,6 @@
 import type * as Hedra from "../index.mjs";
 /**
- * End frame (first-last-frame-to-video).
+ * End frame (first-last-frame-to-video). With an aspect ratio from 0.4 to 2.5 and at most 30 MB.
  */
 export type InputSeedance25EndImage = 
 /**

package/dist/esm/api/types/InputSeedance25StartImage.d.mts

@@ -1,6 +1,6 @@
 import type * as Hedra from "../index.mjs";
 /**
- * Start frame (image-to-video).
+ * Start frame (image-to-video). With an aspect ratio from 0.4 to 2.5 and at most 30 MB.
  */
 export type InputSeedance25StartImage = 
 /**

package/dist/esm/api/types/InputSeedream40.d.mts

@@ -17,7 +17,7 @@ export interface InputSeedream40 {
     aspect_ratio: InputSeedream40.AspectRatio;
     /** Output resolution. */
     resolution: InputSeedream40.Resolution;
-    /** Images to edit or blend. */
+    /** Images to edit or blend. 1 to 14 images, each at most 30 MB. */
     images?: Hedra.InputSeedream40ImagesItem[] | undefined;
 }
 export declare namespace InputSeedream40 {

package/dist/esm/api/types/InputSeedream45.d.mts

@@ -17,7 +17,7 @@ export interface InputSeedream45 {
     aspect_ratio: InputSeedream45.AspectRatio;
     /** Output resolution. */
     resolution: InputSeedream45.Resolution;
-    /** Images to edit or blend. */
+    /** Images to edit or blend. 1 to 14 images, each at most 30 MB. */
     images?: Hedra.InputSeedream45ImagesItem[] | undefined;
 }
 export declare namespace InputSeedream45 {

package/dist/esm/api/types/InputSeedream50Lite.d.mts

@@ -17,7 +17,7 @@ export interface InputSeedream50Lite {
     aspect_ratio: InputSeedream50Lite.AspectRatio;
     /** Output resolution. */
     resolution: InputSeedream50Lite.Resolution;
-    /** Images to edit or blend. */
+    /** Images to edit or blend. 1 to 14 images, each at most 30 MB. */
     images?: Hedra.InputSeedream50LiteImagesItem[] | undefined;
 }
 export declare namespace InputSeedream50Lite {

package/dist/esm/api/types/InputSeedream50Pro.d.mts

@@ -17,7 +17,7 @@ export interface InputSeedream50Pro {
     aspect_ratio: InputSeedream50Pro.AspectRatio;
     /** Output resolution. */
     resolution: InputSeedream50Pro.Resolution;
-    /** Images to edit or blend. */
+    /** Images to edit or blend. 1 to 10 images, each at most 30 MB. */
     images?: Hedra.InputSeedream50ProImagesItem[] | undefined;
 }
 export declare namespace InputSeedream50Pro {

package/dist/esm/api/types/InputSora2Pro.d.mts

@@ -9,7 +9,7 @@ import type * as Hedra from "../index.mjs";
 export interface InputSora2Pro {
     /** Number of outputs generated per job. Only 1 is supported. */
     num_outputs?: number | undefined;
-    /** Generation prompt. */
+    /** Generation prompt. At most 5000 characters. */
     prompt: string;
     /** Output aspect ratio. */
     aspect_ratio: InputSora2Pro.AspectRatio;
@@ -17,7 +17,7 @@ export interface InputSora2Pro {
     resolution: InputSora2Pro.Resolution;
     /** Duration in ms. */
     duration_ms: number;
-    /** Start frame (image-to-video). */
+    /** Start frame (image-to-video). At most 10.4 MB. */
     start_image?: Hedra.InputSora2ProStartImage | undefined;
 }
 export declare namespace InputSora2Pro {

package/dist/esm/api/types/InputSora2ProStartImage.d.mts

@@ -1,6 +1,6 @@
 import type * as Hedra from "../index.mjs";
 /**
- * Start frame (image-to-video).
+ * Start frame (image-to-video). At most 10.4 MB.
  */
 export type InputSora2ProStartImage = 
 /**

package/dist/esm/api/types/InputVeedFabric10.d.mts

@@ -11,9 +11,9 @@ export interface InputVeedFabric10 {
     aspect_ratio: InputVeedFabric10.AspectRatio;
     /** Output resolution. */
     resolution: InputVeedFabric10.Resolution;
-    /** Start frame (image-to-video). */
+    /** Start frame (image-to-video). At most 10.4 MB. */
     start_image: Hedra.InputVeedFabric10StartImage;
-    /** Driving audio. */
+    /** Driving audio. At most 104.8 MB. */
     audio: Hedra.InputVeedFabric10Audio;
 }
 export declare namespace InputVeedFabric10 {

package/dist/esm/api/types/InputVeedFabric10Audio.d.mts

@@ -1,6 +1,6 @@
 import type * as Hedra from "../index.mjs";
 /**
- * Driving audio.
+ * Driving audio. At most 104.8 MB.
  */
 export type InputVeedFabric10Audio = 
 /**

package/dist/esm/api/types/InputVeedFabric10StartImage.d.mts

@@ -1,6 +1,6 @@
 import type * as Hedra from "../index.mjs";
 /**
- * Start frame (image-to-video).
+ * Start frame (image-to-video). At most 10.4 MB.
  */
 export type InputVeedFabric10StartImage = 
 /**

package/dist/esm/api/types/InputVeedVideoBackgroundRemoval.d.mts

@@ -0,0 +1,12 @@
+import type * as Hedra from "../index.mjs";
+/**
+ * Model-specific inputs for `veed-video-background-removal`.
+ */
+export interface InputVeedVideoBackgroundRemoval {
+    /** Number of outputs generated per job. Only 1 is supported. */
+    num_outputs?: number | undefined;
+    /** Video whose background should be made transparent. At most 120s and at most 524.2 MB. */
+    source_video: Hedra.InputVeedVideoBackgroundRemovalSourceVideo;
+    /** Optimize segmentation for a person rather than an object. */
+    subject_is_person?: boolean | undefined;
+}

package/dist/esm/api/types/InputVeedVideoBackgroundRemoval.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/InputVeedVideoBackgroundRemovalSourceVideo.d.mts

@@ -0,0 +1,23 @@
+import type * as Hedra from "../index.mjs";
+/**
+ * Video whose background should be made transparent. At most 120s and at most 524.2 MB.
+ */
+export type InputVeedVideoBackgroundRemovalSourceVideo = 
+/**
+ * A file uploaded via POST /v3/files, referenced by the returned url. */
+Hedra.InputVeedVideoBackgroundRemovalSourceVideo.Url
+/**
+ * An existing asset you own, referenced by its id. */
+ | Hedra.InputVeedVideoBackgroundRemovalSourceVideo.Asset;
+export declare namespace InputVeedVideoBackgroundRemovalSourceVideo {
+    interface Url {
+        source: "url";
+        /** A URL returned by POST /v3/files. */
+        url: string;
+    }
+    interface Asset {
+        source: "asset";
+        /** The asset's id (`asset_<uuid>`), as issued by the server — a completed generation publishes one per output as `outputs[].asset_id`. Do not construct one or derive it from any other id. */
+        asset_id: string;
+    }
+}

package/dist/esm/api/types/InputVeedVideoBackgroundRemovalSourceVideo.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/InputVeo2.d.mts

@@ -17,7 +17,7 @@ export interface InputVeo2 {
     resolution?: InputVeo2.Resolution | undefined;
     /** Duration in ms. */
     duration_ms?: number | undefined;
-    /** Start frame (image-to-video). */
+    /** Start frame (image-to-video). At most 8 MB. */
     start_image?: Hedra.InputVeo2StartImage | undefined;
     /** What to avoid in the generated video. */
     negative_prompt?: string | undefined;

package/dist/esm/api/types/InputVeo2StartImage.d.mts

@@ -1,6 +1,6 @@
 import type * as Hedra from "../index.mjs";
 /**
- * Start frame (image-to-video).
+ * Start frame (image-to-video). At most 8 MB.
  */
 export type InputVeo2StartImage = 
 /**

package/dist/esm/api/types/InputVeo3.d.mts

@@ -9,7 +9,7 @@ import type * as Hedra from "../index.mjs";
 export interface InputVeo3 {
     /** Number of outputs generated per job. Only 1 is supported. */
     num_outputs?: number | undefined;
-    /** Generation prompt. */
+    /** Generation prompt. At most 20000 characters. */
     prompt: string;
     /** Output aspect ratio. */
     aspect_ratio: InputVeo3.AspectRatio;
@@ -19,7 +19,7 @@ export interface InputVeo3 {
     duration_ms: number;
     /** Whether to generate native audio for the video. */
     generate_audio?: boolean | undefined;
-    /** Start frame (image-to-video). */
+    /** Start frame (image-to-video). At most 8 MB. */
     start_image?: Hedra.InputVeo3StartImage | undefined;
     /** What to avoid in the generated video. */
     negative_prompt?: string | undefined;

package/dist/esm/api/types/InputVeo31.d.mts

@@ -17,15 +17,15 @@ export interface InputVeo31 {
     generate_audio?: boolean | undefined;
     /** What to avoid in the generated video. */
     negative_prompt?: string | undefined;
-    /** Start frame (image-to-video). */
+    /** Start frame (image-to-video). At most 20 MB. */
     start_image?: Hedra.InputVeo31StartImage | undefined;
-    /** End frame (first-last-frame-to-video). */
+    /** End frame (first-last-frame-to-video). At most 20 MB. */
     end_image?: Hedra.InputVeo31EndImage | undefined;
-    /** Source video (video-to-video). */
+    /** Source video (video-to-video). From 1s to 30s and at most 524.2 MB. */
     source_video?: Hedra.InputVeo31SourceVideo | undefined;
-    /** Reference images. */
+    /** Reference images. 1 to 3 images, each at most 20 MB. */
     images?: Hedra.InputVeo31ImagesItem[] | undefined;
-    /** Seed for reproducible output; omit for a random seed. */
+    /** Seed for reproducible output; omit for a random seed. From 0 to 4294967295. */
     seed?: number | undefined;
     /** Quality level to generate at. */
     quality: InputVeo31.Quality;

package/dist/esm/api/types/InputVeo31EndImage.d.mts

@@ -1,6 +1,6 @@
 import type * as Hedra from "../index.mjs";
 /**
- * End frame (first-last-frame-to-video).
+ * End frame (first-last-frame-to-video). At most 20 MB.
  */
 export type InputVeo31EndImage = 
 /**

package/dist/esm/api/types/InputVeo31SourceVideo.d.mts

@@ -1,6 +1,6 @@
 import type * as Hedra from "../index.mjs";
 /**
- * Source video (video-to-video).
+ * Source video (video-to-video). From 1s to 30s and at most 524.2 MB.
  */
 export type InputVeo31SourceVideo = 
 /**

package/dist/esm/api/types/InputVeo31StartImage.d.mts

@@ -1,6 +1,6 @@
 import type * as Hedra from "../index.mjs";
 /**
- * Start frame (image-to-video).
+ * Start frame (image-to-video). At most 20 MB.
  */
 export type InputVeo31StartImage = 
 /**

package/dist/esm/api/types/InputVeo3StartImage.d.mts

@@ -1,6 +1,6 @@
 import type * as Hedra from "../index.mjs";
 /**
- * Start frame (image-to-video).
+ * Start frame (image-to-video). At most 8 MB.
  */
 export type InputVeo3StartImage = 
 /**

package/dist/esm/api/types/InputViduQ3.d.mts

@@ -10,7 +10,7 @@ import type * as Hedra from "../index.mjs";
 export interface InputViduQ3 {
     /** Number of outputs generated per job. Only 1 is supported. */
     num_outputs?: number | undefined;
-    /** Generation prompt. */
+    /** Generation prompt. At most 2000 characters. */
     prompt: string;
     /** Seed for reproducible output; omit for a random seed. */
     seed?: number | undefined;
@@ -18,9 +18,9 @@ export interface InputViduQ3 {
     resolution: InputViduQ3.Resolution;
     /** Duration in ms. */
     duration_ms: number;
-    /** Start frame (image-to-video). */
+    /** Start frame (image-to-video). At most 10.4 MB. */
     start_image?: Hedra.InputViduQ3StartImage | undefined;
-    /** End frame (first-last-frame-to-video). */
+    /** End frame (first-last-frame-to-video). At most 10.4 MB. */
     end_image?: Hedra.InputViduQ3EndImage | undefined;
     /** Output aspect ratio. */
     aspect_ratio?: InputViduQ3.AspectRatio | undefined;

package/dist/esm/api/types/InputViduQ3EndImage.d.mts

@@ -1,6 +1,6 @@
 import type * as Hedra from "../index.mjs";
 /**
- * End frame (first-last-frame-to-video).
+ * End frame (first-last-frame-to-video). At most 10.4 MB.
  */
 export type InputViduQ3EndImage = 
 /**

package/dist/esm/api/types/InputViduQ3Reference.d.mts

@@ -5,7 +5,7 @@ import type * as Hedra from "../index.mjs";
 export interface InputViduQ3Reference {
     /** Number of outputs generated per job. Only 1 is supported. */
     num_outputs?: number | undefined;
-    /** Generation prompt. */
+    /** Generation prompt. At most 2000 characters. */
     prompt: string;
     /** Seed for reproducible output; omit for a random seed. */
     seed?: number | undefined;
@@ -15,7 +15,7 @@ export interface InputViduQ3Reference {
     resolution: InputViduQ3Reference.Resolution;
     /** Duration in ms. */
     duration_ms: number;
-    /** Reference images. */
+    /** Reference images. 1 to 4 images, each at most 10.4 MB. */
     images: Hedra.InputViduQ3ReferenceImagesItem[];
 }
 export declare namespace InputViduQ3Reference {

package/dist/esm/api/types/InputViduQ3StartImage.d.mts

@@ -1,6 +1,6 @@
 import type * as Hedra from "../index.mjs";
 /**
- * Start frame (image-to-video).
+ * Start frame (image-to-video). At most 10.4 MB.
  */
 export type InputViduQ3StartImage = 
 /**

package/dist/esm/api/types/InputWan27.d.mts

@@ -10,23 +10,23 @@ import type * as Hedra from "../index.mjs";
 export interface InputWan27 {
     /** Number of outputs generated per job. Only 1 is supported. */
     num_outputs?: number | undefined;
-    /** Generation prompt. */
+    /** Generation prompt. At most 5000 characters. */
     prompt: string;
-    /** What to avoid in the generated video. */
+    /** What to avoid in the generated video. At most 500 characters. */
     negative_prompt?: string | undefined;
-    /** Seed for reproducible output; omit for a random seed. */
+    /** Seed for reproducible output; omit for a random seed. From 0 to 2147483647. */
     seed?: number | undefined;
     /** Output resolution. */
     resolution: InputWan27.Resolution;
     /** Duration in ms. */
     duration_ms: number;
-    /** Start frame (image-to-video). */
+    /** Start frame (image-to-video). At most 20 MB. */
     start_image?: Hedra.InputWan27StartImage | undefined;
-    /** End frame (first-last-frame-to-video). */
+    /** End frame (first-last-frame-to-video). At most 20 MB. */
     end_image?: Hedra.InputWan27EndImage | undefined;
     /** Output aspect ratio. */
     aspect_ratio?: InputWan27.AspectRatio | undefined;
-    /** Reference images. */
+    /** Reference images. 1 to 4 images, each at most 20 MB. */
     images?: Hedra.InputWan27ImagesItem[] | undefined;
 }
 export declare namespace InputWan27 {

package/dist/esm/api/types/InputWan27EndImage.d.mts

@@ -1,6 +1,6 @@
 import type * as Hedra from "../index.mjs";
 /**
- * End frame (first-last-frame-to-video).
+ * End frame (first-last-frame-to-video). At most 20 MB.
  */
 export type InputWan27EndImage = 
 /**

package/dist/esm/api/types/InputWan27StartImage.d.mts

@@ -1,6 +1,6 @@
 import type * as Hedra from "../index.mjs";
 /**
- * Start frame (image-to-video).
+ * Start frame (image-to-video). At most 20 MB.
  */
 export type InputWan27StartImage = 
 /**

package/dist/esm/api/types/ModelDetail.d.mts

@@ -7,6 +7,8 @@ export interface ModelDetail {
     name?: (string | null) | undefined;
     /** One-line summary of what the model does. */
     description?: (string | null) | undefined;
+    /** Short USD pricing summary for this model. Exact cost depends on input. */
+    price_description?: string | undefined;
     /** URL of the provider's logo. */
     logo_url?: (string | null) | undefined;
     /** JSON Schema for this model's `input` object on submit — the same schema `GET /v3/models/{model}/openapi.json` embeds. */

package/dist/esm/api/types/ModelSummary.d.mts

@@ -7,6 +7,8 @@ export interface ModelSummary {
     name?: (string | null) | undefined;
     /** One-line summary of what the model does. */
     description?: (string | null) | undefined;
+    /** Short USD pricing summary for this model. Exact cost depends on input. */
+    price_description?: string | undefined;
     /** URL of the provider's logo. */
     logo_url?: (string | null) | undefined;
 }

package/dist/esm/api/types/index.d.mts

@@ -168,6 +168,8 @@ export * from "./InputSora2ProStartImage.mjs";
 export * from "./InputVeedFabric10.mjs";
 export * from "./InputVeedFabric10Audio.mjs";
 export * from "./InputVeedFabric10StartImage.mjs";
+export * from "./InputVeedVideoBackgroundRemoval.mjs";
+export * from "./InputVeedVideoBackgroundRemovalSourceVideo.mjs";
 export * from "./InputVeo2.mjs";
 export * from "./InputVeo2StartImage.mjs";
 export * from "./InputVeo3.mjs";

package/dist/esm/api/types/index.mjs

@@ -168,6 +168,8 @@ export * from "./InputSora2ProStartImage.mjs";
 export * from "./InputVeedFabric10.mjs";
 export * from "./InputVeedFabric10Audio.mjs";
 export * from "./InputVeedFabric10StartImage.mjs";
+export * from "./InputVeedVideoBackgroundRemoval.mjs";
+export * from "./InputVeedVideoBackgroundRemovalSourceVideo.mjs";
 export * from "./InputVeo2.mjs";
 export * from "./InputVeo2StartImage.mjs";
 export * from "./InputVeo3.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.0.0";
+export declare const SDK_VERSION = "3.0.0";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "2.0.0";
+export const SDK_VERSION = "3.0.0";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@hedra/sdk",
-    "version": "2.0.0",
+    "version": "3.0.0",
     "private": false,
     "repository": {
         "type": "git",
@@ -155,6 +155,6 @@
         "node": ">=18.0.0"
     },
     "sideEffects": false,
-    "description": "The official TypeScript library for the Hedra API — API spec 3.3.0",
+    "description": "The official TypeScript library for the Hedra API — API spec 3.9.0",
     "author": "Hedra <support@hedra.com>"
 }

package/reference.md

@@ -2825,7 +2825,6 @@ Submits an asynchronous job and returns `202` with a job id. Fetch the result at
 ```typescript
 await client.jobs.submitKlingO3({
     input: {
-        prompt: "prompt",
         aspect_ratio: "16:9",
         duration_ms: 1,
         quality: "standard"
@@ -3045,7 +3044,6 @@ Submits an asynchronous job and returns `202` with a job id. Fetch the result at
 ```typescript
 await client.jobs.submitKlingV3({
     input: {
-        prompt: "prompt",
         aspect_ratio: "16:9",
         duration_ms: 1,
         quality: "standard"
@@ -5245,6 +5243,78 @@ await client.jobs.submitVeedFabric10({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.jobs.<a href="/src/api/resources/jobs/client/Client.ts">submitVeedVideoBackgroundRemoval</a>({ ...params }) -> Hedra.SubmitResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Remove a video's background and return transparent WebM.
+
+Submits an asynchronous job and returns `202` with a job id. Fetch the result at `GET /v3/jobs/{job_id}` — each item in its `outputs[]` follows the `OutputItem` schema — or track progress via `GET /v3/jobs/{job_id}/status` / the SSE stream at `GET /v3/jobs/{job_id}/stream`.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.jobs.submitVeedVideoBackgroundRemoval({
+    input: {
+        source_video: {
+            source: "url",
+            url: "url"
+        }
+    }
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `Hedra.SubmitBodyVeedVideoBackgroundRemoval` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `JobsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>