segmind 0.1.0 → 0.2.0

package/dist/index.d.cts

@@ -64,9 +64,13 @@ interface ChatMessage {
     content: string | Array<Record<string, unknown>>;
     [key: string]: unknown;
 }
-/** Chat inputs: `messages` or `prompt` (at least one), plus any model params. */
+/**
+ * Chat inputs: `messages` or `prompt` (at least one), plus any model params.
+ * `messages` is a list for OpenAI- and Anthropic-style models; Gemini models
+ * take their own object (`{ system_instruction, contents }`), sent unchanged.
+ */
 type ChatParams = Params & {
-    messages?: ChatMessage[];
+    messages?: ChatMessage[] | Record<string, unknown>;
     prompt?: string;
 };
 type Raw = Record<string, unknown>;
@@ -101,8 +105,17 @@ interface HttpConfig {
 interface HttpRequest {
     method: HttpMethod;
     url: string;
+    /** Query parameters; `undefined` values are left out. */
+    query?: Record<string, string | number | boolean | undefined>;
     /** Sent as JSON. */
     body?: unknown;
+    /** Sent as is, instead of a JSON `body`. */
+    rawBody?: Uint8Array | Blob;
+    /**
+     * Send only `headers`: no API key, no `X-Initiator`, no default headers. For
+     * presigned URLs on other hosts, which must never see the key.
+     */
+    bare?: boolean;
     headers?: Record<string, string>;
     signal?: AbortSignal;
     /** Milliseconds for this attempt; defaults to the client's timeout. */
@@ -126,6 +139,132 @@ declare class HttpClient {
     private attempt;
 }
 
+/** A file to send: a path (Node only), a `Blob` or `File`, or raw bytes. */
+type FileInput = string | Blob | ArrayBuffer | Uint8Array;
+
+interface UploadOptions {
+    /** The file's name, with an extension: the server types the file from it. */
+    filename?: string;
+    /** The file's type, when neither the name nor the bytes tell. */
+    mimeType?: string;
+    signal?: AbortSignal;
+}
+interface UploadedFile {
+    /** Public URL to pass as a model input. */
+    url: string;
+    filename: string;
+    size: number;
+}
+/**
+ * Uploads files to pass as model inputs. Each file goes straight to storage on
+ * a presigned URL, so large videos never travel as base64 JSON. The URLs are
+ * public and temporary: the files are kept for at least two days.
+ */
+declare class Files {
+    private readonly client;
+    constructor(client: Segmind);
+    /** Uploads one file and returns its URL. */
+    upload(file: FileInput, options?: UploadOptions): Promise<UploadedFile>;
+    /** Uploads several files, in order. */
+    upload(files: FileInput[], options?: Omit<UploadOptions, 'filename'>): Promise<UploadedFile[]>;
+    private uploadOne;
+}
+
+/** One page of a paginated list. */
+interface Page<T> {
+    total_records: number;
+    total_pages: number;
+    current_page: number;
+    per_page: number;
+    has_next: boolean;
+    has_previous: boolean;
+    data: T[];
+    [key: string]: unknown;
+}
+/** A generated output, with the request behind it. */
+interface Generation {
+    request_id: string;
+    model_name: string;
+    generation_url: string;
+    created_at: string;
+    status?: string | null;
+    /** Cost in USD. */
+    credits_deduction?: number | null;
+    latency_ms?: number | null;
+    prompt?: string | null;
+    parameters?: Record<string, unknown> | null;
+    [key: string]: unknown;
+}
+/** A request, failed and in-flight ones included. */
+interface RequestRecord {
+    request_id: string;
+    model_name: string;
+    model_status: string;
+    /** Cost in USD. */
+    credits_deduction: number | null;
+    /** The inputs as sent, as a JSON string. */
+    request_body?: string | null;
+    generation_url?: string | null;
+    latency_ms?: number | null;
+    model_created?: string;
+    error?: string | null;
+    [key: string]: unknown;
+}
+interface GenerationsListOptions {
+    page?: number;
+    modelName?: string;
+    /** YYYY-MM-DD. */
+    startDate?: string;
+    /** YYYY-MM-DD. */
+    endDate?: string;
+    /** Inside a team, any member's user id; otherwise only your own. */
+    userId?: string;
+    signal?: AbortSignal;
+}
+interface HistoryOptions {
+    page?: number;
+    /** 1–100. Default 20. */
+    perPage?: number;
+    /** YYYY-MM-DD. Default 7 days ago. */
+    fromDate?: string;
+    /** YYYY-MM-DD, inclusive. Default today. At most 31 days after `fromDate`. */
+    toDate?: string;
+    /** Substring match on the model slug. */
+    modelName?: string;
+    status?: 'COMPLETED' | 'FAILED' | 'PENDING';
+    /** Inside a team, any member's user id; otherwise only your own. */
+    userId?: string;
+    /** Same as `userId`, by email. Pass one or the other. */
+    userEmail?: string;
+    sortBy?: 'model_created' | 'model_name' | 'credits_deduction';
+    sortOrder?: 'asc' | 'desc';
+    signal?: AbortSignal;
+}
+/** Your generations and request history. */
+declare class Generations {
+    private readonly client;
+    constructor(client: Segmind);
+    /** Generated outputs, newest first. */
+    list(options?: GenerationsListOptions): Promise<Page<Generation>>;
+    /** The newest generations for one model. */
+    recent(modelName: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<{
+        data: Array<Pick<Generation, 'request_id' | 'generation_url' | 'created_at' | 'status'>>;
+    }>;
+    /**
+     * Requests with their cost, inputs and outcome, failures included. A request
+     * with several outputs appears once per output, each carrying its full cost:
+     * de-duplicate on `request_id` before summing.
+     */
+    history(options?: HistoryOptions): Promise<Page<RequestRecord>>;
+    /** One of your own requests, of any age. A teammate's request id is not found. */
+    get(requestId: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<RequestRecord>;
+    private read;
+}
+
 declare const DEFAULT_WAIT_TIMEOUT_MS = 600000;
 declare const DEFAULT_WAIT_INTERVAL_MS = 1000;
 /**
@@ -164,6 +303,103 @@ declare class Job<T = RunResult> {
     private read;
 }
 
+interface PixelflowSubmitOptions {
+    /**
+     * `v2` (default) runs on the current workflow engine, which also loads
+     * older graphs. `v1` is the legacy engine.
+     */
+    engine?: 'v1' | 'v2';
+    signal?: AbortSignal;
+}
+interface PixelflowWaitOptions {
+    /** Give up after this many milliseconds. Default 600 000. */
+    timeout?: number;
+    /** Milliseconds between status checks. Default 2000. */
+    interval?: number;
+    signal?: AbortSignal;
+}
+interface PixelflowStatus {
+    /** `QUEUED`, `PROCESSING`, `COMPLETED` or `FAILED`, upper-cased. */
+    status: string;
+    /** The finished outputs by keyname, unwrapped to their URL or value. `{}` until done. */
+    outputs: Record<string, unknown>;
+    /** The engine's own body, with `output` decoded from its JSON string. */
+    raw: Record<string, unknown>;
+}
+/**
+ * Published PixelFlow workflows, run through the gateway. `slug` is the
+ * workflow's API slug from its API tab. Inputs are a flat object keyed by each
+ * input's keyname: `{ Text_Prompt: 'a red fox' }`.
+ */
+declare class PixelFlows {
+    private readonly client;
+    constructor(client: Segmind);
+    /** Runs a workflow and waits for its outputs. */
+    run(slug: string, inputs?: Record<string, unknown>, options?: PixelflowSubmitOptions & PixelflowWaitOptions): Promise<PixelflowStatus>;
+    /** Starts a workflow and returns a job to wait on. Never retried: a run bills. */
+    submit(slug: string, inputs?: Record<string, unknown>, options?: PixelflowSubmitOptions): Promise<PixelflowJob>;
+    /** A run's current state, without waiting. */
+    getStatus(requestId: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<PixelflowStatus>;
+    /** Waits for a run started earlier, by its request id. */
+    poll(requestId: string, options?: PixelflowWaitOptions): Promise<PixelflowStatus>;
+}
+/** A started workflow run. */
+declare class PixelflowJob {
+    private readonly pixelflows;
+    readonly requestId: string;
+    constructor(pixelflows: PixelFlows, requestId: string);
+    status(options?: {
+        signal?: AbortSignal;
+    }): Promise<PixelflowStatus>;
+    /**
+     * Polls until the run finishes. Throws `InferenceFailed` (its `detail` names
+     * the failing node) or `InferenceTimeout`; the run may still finish after a
+     * timeout, so `wait()` can be called again.
+     */
+    wait(options?: PixelflowWaitOptions): Promise<PixelflowStatus>;
+}
+
+/** A webhook registration, as the API returns it. Only the common fields are typed. */
+interface Webhook {
+    webhook_id?: string;
+    webhook_url?: string;
+    event?: {
+        types?: string[];
+    };
+    [key: string]: unknown;
+}
+/**
+ * Your webhook registrations. Event types are the console's names, such as
+ * `PIXELFLOW` and `PIXELFLOW_API_RUN`.
+ */
+declare class Webhooks {
+    private readonly client;
+    constructor(client: Segmind);
+    /** Every registration; `[]` when you have none. */
+    get(options?: {
+        signal?: AbortSignal;
+    }): Promise<Webhook[]>;
+    /** Registers an endpoint for the given event types. */
+    add(webhookUrl: string, eventTypes: string[], options?: {
+        signal?: AbortSignal;
+    }): Promise<Record<string, unknown>>;
+    /** Changes a registration's URL and event types. */
+    update(webhookId: string, webhookUrl: string, eventTypes: string[], options?: {
+        signal?: AbortSignal;
+    }): Promise<Record<string, unknown>>;
+    /** Deactivates a registration. */
+    delete(webhookId: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<Record<string, unknown>>;
+    /** Delivery history for one registration. */
+    logs(webhookId: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<Record<string, unknown>>;
+    private call;
+}
+
 declare const DEFAULT_BASE_URL = "https://api.segmind.com";
 declare const DEFAULT_SPOT_URL = "https://api.spotprod.segmind.com";
 declare const DEFAULT_CONSOLE_URL = "https://cloud.segmind.com/api";
@@ -172,7 +408,7 @@ interface ClientOptions {
     apiKey?: string;
     /** The inference API root, without `/v1`. Defaults to `SEGMIND_BASE_URL` or https://api.segmind.com. */
     baseURL?: string;
-    /** The catalog and history API. Default https://api.spotprod.segmind.com. */
+    /** The catalog, history, webhook and upload API. Default https://api.spotprod.segmind.com. */
     spotURL?: string;
     /** The account API. Default https://cloud.segmind.com/api. */
     consoleURL?: string;
@@ -205,6 +441,14 @@ declare class Segmind {
     readonly consoleURL: string;
     readonly models: Models;
     readonly accounts: Accounts;
+    /** Upload files to pass as model inputs. */
+    readonly files: Files;
+    /** Your generations and request history. */
+    readonly generations: Generations;
+    /** Your webhook registrations. */
+    readonly webhooks: Webhooks;
+    /** Run published PixelFlow workflows. */
+    readonly pixelflows: PixelFlows;
     /** @internal */
     readonly http: HttpClient;
     constructor(options?: ClientOptions);
@@ -277,7 +521,7 @@ interface ImageUrlPart {
         url: string;
     };
 }
-type ImageInput = string | Blob | ArrayBuffer | Uint8Array;
+type ImageInput = FileInput;
 /**
  * Builds an image part for a chat message.
  *
@@ -320,7 +564,7 @@ declare class APIConnectionError extends SegmindError {
 declare class InferenceFailed extends SegmindError {
     /** The status body that reported the failure. */
     readonly statusBody: Record<string, unknown>;
-    constructor(requestId: string, statusBody: Record<string, unknown>);
+    constructor(requestId: string, statusBody: Record<string, unknown>, detail?: string);
 }
 /**
  * `wait()` ran past its timeout. The request may still finish on the server:
@@ -331,7 +575,7 @@ declare class InferenceTimeout extends SegmindError {
     constructor(requestId: string, elapsedMs: number);
 }
 
-declare const VERSION = "0.1.0";
+declare const VERSION = "0.2.0";
 
 /** `new Segmind().run(...)` with the key from `SEGMIND_API_KEY`. */
 declare const run: (slug: string, params?: Params, options?: RunOptions) => Promise<RunResult>;
@@ -357,6 +601,14 @@ declare const accounts: {
         signal?: AbortSignal;
     }) => Promise<Record<string, unknown>>;
 };
+/** `new Segmind().files` with the key from `SEGMIND_API_KEY`. */
+declare const files: Pick<Files, 'upload'>;
+/** `new Segmind().generations` with the key from `SEGMIND_API_KEY`. */
+declare const generations: Pick<Generations, 'list' | 'recent' | 'history' | 'get'>;
+/** `new Segmind().webhooks` with the key from `SEGMIND_API_KEY`. */
+declare const webhooks: Pick<Webhooks, 'get' | 'add' | 'update' | 'delete' | 'logs'>;
+/** `new Segmind().pixelflows` with the key from `SEGMIND_API_KEY`. */
+declare const pixelflows: Pick<PixelFlows, 'run' | 'submit' | 'getStatus' | 'poll'>;
 
-export { APIConnectionError, Accounts, ChatResponse, DEFAULT_BASE_URL, DEFAULT_CONSOLE_URL, DEFAULT_SPOT_URL, DEFAULT_WAIT_INTERVAL_MS, DEFAULT_WAIT_TIMEOUT_MS, InferenceFailed, InferenceTimeout, Job, Models, Segmind, SegmindError, VERSION, accounts, chat, chatSync, imageUrl, models, run, runSync, submit, submitChat };
-export type { CallOptions, ChatMessage, ChatParams, ClientOptions, ImageInput, ImageUrlPart, JobState, JobStatus, ModelInfo, ModelsListResponse, Params, RunOptions, RunResult, SubmitOptions, SubmitResponse, WaitOptions };
+export { APIConnectionError, Accounts, ChatResponse, DEFAULT_BASE_URL, DEFAULT_CONSOLE_URL, DEFAULT_SPOT_URL, DEFAULT_WAIT_INTERVAL_MS, DEFAULT_WAIT_TIMEOUT_MS, Files, Generations, InferenceFailed, InferenceTimeout, Job, Models, PixelFlows, PixelflowJob, Segmind, SegmindError, VERSION, Webhooks, accounts, chat, chatSync, files, generations, imageUrl, models, pixelflows, run, runSync, submit, submitChat, webhooks };
+export type { CallOptions, ChatMessage, ChatParams, ClientOptions, FileInput, Generation, GenerationsListOptions, HistoryOptions, ImageInput, ImageUrlPart, JobState, JobStatus, ModelInfo, ModelsListResponse, Page, Params, PixelflowStatus, PixelflowSubmitOptions, PixelflowWaitOptions, RequestRecord, RunOptions, RunResult, SubmitOptions, SubmitResponse, UploadOptions, UploadedFile, WaitOptions, Webhook };

package/dist/index.d.ts

@@ -64,9 +64,13 @@ interface ChatMessage {
     content: string | Array<Record<string, unknown>>;
     [key: string]: unknown;
 }
-/** Chat inputs: `messages` or `prompt` (at least one), plus any model params. */
+/**
+ * Chat inputs: `messages` or `prompt` (at least one), plus any model params.
+ * `messages` is a list for OpenAI- and Anthropic-style models; Gemini models
+ * take their own object (`{ system_instruction, contents }`), sent unchanged.
+ */
 type ChatParams = Params & {
-    messages?: ChatMessage[];
+    messages?: ChatMessage[] | Record<string, unknown>;
     prompt?: string;
 };
 type Raw = Record<string, unknown>;
@@ -101,8 +105,17 @@ interface HttpConfig {
 interface HttpRequest {
     method: HttpMethod;
     url: string;
+    /** Query parameters; `undefined` values are left out. */
+    query?: Record<string, string | number | boolean | undefined>;
     /** Sent as JSON. */
     body?: unknown;
+    /** Sent as is, instead of a JSON `body`. */
+    rawBody?: Uint8Array | Blob;
+    /**
+     * Send only `headers`: no API key, no `X-Initiator`, no default headers. For
+     * presigned URLs on other hosts, which must never see the key.
+     */
+    bare?: boolean;
     headers?: Record<string, string>;
     signal?: AbortSignal;
     /** Milliseconds for this attempt; defaults to the client's timeout. */
@@ -126,6 +139,132 @@ declare class HttpClient {
     private attempt;
 }
 
+/** A file to send: a path (Node only), a `Blob` or `File`, or raw bytes. */
+type FileInput = string | Blob | ArrayBuffer | Uint8Array;
+
+interface UploadOptions {
+    /** The file's name, with an extension: the server types the file from it. */
+    filename?: string;
+    /** The file's type, when neither the name nor the bytes tell. */
+    mimeType?: string;
+    signal?: AbortSignal;
+}
+interface UploadedFile {
+    /** Public URL to pass as a model input. */
+    url: string;
+    filename: string;
+    size: number;
+}
+/**
+ * Uploads files to pass as model inputs. Each file goes straight to storage on
+ * a presigned URL, so large videos never travel as base64 JSON. The URLs are
+ * public and temporary: the files are kept for at least two days.
+ */
+declare class Files {
+    private readonly client;
+    constructor(client: Segmind);
+    /** Uploads one file and returns its URL. */
+    upload(file: FileInput, options?: UploadOptions): Promise<UploadedFile>;
+    /** Uploads several files, in order. */
+    upload(files: FileInput[], options?: Omit<UploadOptions, 'filename'>): Promise<UploadedFile[]>;
+    private uploadOne;
+}
+
+/** One page of a paginated list. */
+interface Page<T> {
+    total_records: number;
+    total_pages: number;
+    current_page: number;
+    per_page: number;
+    has_next: boolean;
+    has_previous: boolean;
+    data: T[];
+    [key: string]: unknown;
+}
+/** A generated output, with the request behind it. */
+interface Generation {
+    request_id: string;
+    model_name: string;
+    generation_url: string;
+    created_at: string;
+    status?: string | null;
+    /** Cost in USD. */
+    credits_deduction?: number | null;
+    latency_ms?: number | null;
+    prompt?: string | null;
+    parameters?: Record<string, unknown> | null;
+    [key: string]: unknown;
+}
+/** A request, failed and in-flight ones included. */
+interface RequestRecord {
+    request_id: string;
+    model_name: string;
+    model_status: string;
+    /** Cost in USD. */
+    credits_deduction: number | null;
+    /** The inputs as sent, as a JSON string. */
+    request_body?: string | null;
+    generation_url?: string | null;
+    latency_ms?: number | null;
+    model_created?: string;
+    error?: string | null;
+    [key: string]: unknown;
+}
+interface GenerationsListOptions {
+    page?: number;
+    modelName?: string;
+    /** YYYY-MM-DD. */
+    startDate?: string;
+    /** YYYY-MM-DD. */
+    endDate?: string;
+    /** Inside a team, any member's user id; otherwise only your own. */
+    userId?: string;
+    signal?: AbortSignal;
+}
+interface HistoryOptions {
+    page?: number;
+    /** 1–100. Default 20. */
+    perPage?: number;
+    /** YYYY-MM-DD. Default 7 days ago. */
+    fromDate?: string;
+    /** YYYY-MM-DD, inclusive. Default today. At most 31 days after `fromDate`. */
+    toDate?: string;
+    /** Substring match on the model slug. */
+    modelName?: string;
+    status?: 'COMPLETED' | 'FAILED' | 'PENDING';
+    /** Inside a team, any member's user id; otherwise only your own. */
+    userId?: string;
+    /** Same as `userId`, by email. Pass one or the other. */
+    userEmail?: string;
+    sortBy?: 'model_created' | 'model_name' | 'credits_deduction';
+    sortOrder?: 'asc' | 'desc';
+    signal?: AbortSignal;
+}
+/** Your generations and request history. */
+declare class Generations {
+    private readonly client;
+    constructor(client: Segmind);
+    /** Generated outputs, newest first. */
+    list(options?: GenerationsListOptions): Promise<Page<Generation>>;
+    /** The newest generations for one model. */
+    recent(modelName: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<{
+        data: Array<Pick<Generation, 'request_id' | 'generation_url' | 'created_at' | 'status'>>;
+    }>;
+    /**
+     * Requests with their cost, inputs and outcome, failures included. A request
+     * with several outputs appears once per output, each carrying its full cost:
+     * de-duplicate on `request_id` before summing.
+     */
+    history(options?: HistoryOptions): Promise<Page<RequestRecord>>;
+    /** One of your own requests, of any age. A teammate's request id is not found. */
+    get(requestId: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<RequestRecord>;
+    private read;
+}
+
 declare const DEFAULT_WAIT_TIMEOUT_MS = 600000;
 declare const DEFAULT_WAIT_INTERVAL_MS = 1000;
 /**
@@ -164,6 +303,103 @@ declare class Job<T = RunResult> {
     private read;
 }
 
+interface PixelflowSubmitOptions {
+    /**
+     * `v2` (default) runs on the current workflow engine, which also loads
+     * older graphs. `v1` is the legacy engine.
+     */
+    engine?: 'v1' | 'v2';
+    signal?: AbortSignal;
+}
+interface PixelflowWaitOptions {
+    /** Give up after this many milliseconds. Default 600 000. */
+    timeout?: number;
+    /** Milliseconds between status checks. Default 2000. */
+    interval?: number;
+    signal?: AbortSignal;
+}
+interface PixelflowStatus {
+    /** `QUEUED`, `PROCESSING`, `COMPLETED` or `FAILED`, upper-cased. */
+    status: string;
+    /** The finished outputs by keyname, unwrapped to their URL or value. `{}` until done. */
+    outputs: Record<string, unknown>;
+    /** The engine's own body, with `output` decoded from its JSON string. */
+    raw: Record<string, unknown>;
+}
+/**
+ * Published PixelFlow workflows, run through the gateway. `slug` is the
+ * workflow's API slug from its API tab. Inputs are a flat object keyed by each
+ * input's keyname: `{ Text_Prompt: 'a red fox' }`.
+ */
+declare class PixelFlows {
+    private readonly client;
+    constructor(client: Segmind);
+    /** Runs a workflow and waits for its outputs. */
+    run(slug: string, inputs?: Record<string, unknown>, options?: PixelflowSubmitOptions & PixelflowWaitOptions): Promise<PixelflowStatus>;
+    /** Starts a workflow and returns a job to wait on. Never retried: a run bills. */
+    submit(slug: string, inputs?: Record<string, unknown>, options?: PixelflowSubmitOptions): Promise<PixelflowJob>;
+    /** A run's current state, without waiting. */
+    getStatus(requestId: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<PixelflowStatus>;
+    /** Waits for a run started earlier, by its request id. */
+    poll(requestId: string, options?: PixelflowWaitOptions): Promise<PixelflowStatus>;
+}
+/** A started workflow run. */
+declare class PixelflowJob {
+    private readonly pixelflows;
+    readonly requestId: string;
+    constructor(pixelflows: PixelFlows, requestId: string);
+    status(options?: {
+        signal?: AbortSignal;
+    }): Promise<PixelflowStatus>;
+    /**
+     * Polls until the run finishes. Throws `InferenceFailed` (its `detail` names
+     * the failing node) or `InferenceTimeout`; the run may still finish after a
+     * timeout, so `wait()` can be called again.
+     */
+    wait(options?: PixelflowWaitOptions): Promise<PixelflowStatus>;
+}
+
+/** A webhook registration, as the API returns it. Only the common fields are typed. */
+interface Webhook {
+    webhook_id?: string;
+    webhook_url?: string;
+    event?: {
+        types?: string[];
+    };
+    [key: string]: unknown;
+}
+/**
+ * Your webhook registrations. Event types are the console's names, such as
+ * `PIXELFLOW` and `PIXELFLOW_API_RUN`.
+ */
+declare class Webhooks {
+    private readonly client;
+    constructor(client: Segmind);
+    /** Every registration; `[]` when you have none. */
+    get(options?: {
+        signal?: AbortSignal;
+    }): Promise<Webhook[]>;
+    /** Registers an endpoint for the given event types. */
+    add(webhookUrl: string, eventTypes: string[], options?: {
+        signal?: AbortSignal;
+    }): Promise<Record<string, unknown>>;
+    /** Changes a registration's URL and event types. */
+    update(webhookId: string, webhookUrl: string, eventTypes: string[], options?: {
+        signal?: AbortSignal;
+    }): Promise<Record<string, unknown>>;
+    /** Deactivates a registration. */
+    delete(webhookId: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<Record<string, unknown>>;
+    /** Delivery history for one registration. */
+    logs(webhookId: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<Record<string, unknown>>;
+    private call;
+}
+
 declare const DEFAULT_BASE_URL = "https://api.segmind.com";
 declare const DEFAULT_SPOT_URL = "https://api.spotprod.segmind.com";
 declare const DEFAULT_CONSOLE_URL = "https://cloud.segmind.com/api";
@@ -172,7 +408,7 @@ interface ClientOptions {
     apiKey?: string;
     /** The inference API root, without `/v1`. Defaults to `SEGMIND_BASE_URL` or https://api.segmind.com. */
     baseURL?: string;
-    /** The catalog and history API. Default https://api.spotprod.segmind.com. */
+    /** The catalog, history, webhook and upload API. Default https://api.spotprod.segmind.com. */
     spotURL?: string;
     /** The account API. Default https://cloud.segmind.com/api. */
     consoleURL?: string;
@@ -205,6 +441,14 @@ declare class Segmind {
     readonly consoleURL: string;
     readonly models: Models;
     readonly accounts: Accounts;
+    /** Upload files to pass as model inputs. */
+    readonly files: Files;
+    /** Your generations and request history. */
+    readonly generations: Generations;
+    /** Your webhook registrations. */
+    readonly webhooks: Webhooks;
+    /** Run published PixelFlow workflows. */
+    readonly pixelflows: PixelFlows;
     /** @internal */
     readonly http: HttpClient;
     constructor(options?: ClientOptions);
@@ -277,7 +521,7 @@ interface ImageUrlPart {
         url: string;
     };
 }
-type ImageInput = string | Blob | ArrayBuffer | Uint8Array;
+type ImageInput = FileInput;
 /**
  * Builds an image part for a chat message.
  *
@@ -320,7 +564,7 @@ declare class APIConnectionError extends SegmindError {
 declare class InferenceFailed extends SegmindError {
     /** The status body that reported the failure. */
     readonly statusBody: Record<string, unknown>;
-    constructor(requestId: string, statusBody: Record<string, unknown>);
+    constructor(requestId: string, statusBody: Record<string, unknown>, detail?: string);
 }
 /**
  * `wait()` ran past its timeout. The request may still finish on the server:
@@ -331,7 +575,7 @@ declare class InferenceTimeout extends SegmindError {
     constructor(requestId: string, elapsedMs: number);
 }
 
-declare const VERSION = "0.1.0";
+declare const VERSION = "0.2.0";
 
 /** `new Segmind().run(...)` with the key from `SEGMIND_API_KEY`. */
 declare const run: (slug: string, params?: Params, options?: RunOptions) => Promise<RunResult>;
@@ -357,6 +601,14 @@ declare const accounts: {
         signal?: AbortSignal;
     }) => Promise<Record<string, unknown>>;
 };
+/** `new Segmind().files` with the key from `SEGMIND_API_KEY`. */
+declare const files: Pick<Files, 'upload'>;
+/** `new Segmind().generations` with the key from `SEGMIND_API_KEY`. */
+declare const generations: Pick<Generations, 'list' | 'recent' | 'history' | 'get'>;
+/** `new Segmind().webhooks` with the key from `SEGMIND_API_KEY`. */
+declare const webhooks: Pick<Webhooks, 'get' | 'add' | 'update' | 'delete' | 'logs'>;
+/** `new Segmind().pixelflows` with the key from `SEGMIND_API_KEY`. */
+declare const pixelflows: Pick<PixelFlows, 'run' | 'submit' | 'getStatus' | 'poll'>;
 
-export { APIConnectionError, Accounts, ChatResponse, DEFAULT_BASE_URL, DEFAULT_CONSOLE_URL, DEFAULT_SPOT_URL, DEFAULT_WAIT_INTERVAL_MS, DEFAULT_WAIT_TIMEOUT_MS, InferenceFailed, InferenceTimeout, Job, Models, Segmind, SegmindError, VERSION, accounts, chat, chatSync, imageUrl, models, run, runSync, submit, submitChat };
-export type { CallOptions, ChatMessage, ChatParams, ClientOptions, ImageInput, ImageUrlPart, JobState, JobStatus, ModelInfo, ModelsListResponse, Params, RunOptions, RunResult, SubmitOptions, SubmitResponse, WaitOptions };
+export { APIConnectionError, Accounts, ChatResponse, DEFAULT_BASE_URL, DEFAULT_CONSOLE_URL, DEFAULT_SPOT_URL, DEFAULT_WAIT_INTERVAL_MS, DEFAULT_WAIT_TIMEOUT_MS, Files, Generations, InferenceFailed, InferenceTimeout, Job, Models, PixelFlows, PixelflowJob, Segmind, SegmindError, VERSION, Webhooks, accounts, chat, chatSync, files, generations, imageUrl, models, pixelflows, run, runSync, submit, submitChat, webhooks };
+export type { CallOptions, ChatMessage, ChatParams, ClientOptions, FileInput, Generation, GenerationsListOptions, HistoryOptions, ImageInput, ImageUrlPart, JobState, JobStatus, ModelInfo, ModelsListResponse, Page, Params, PixelflowStatus, PixelflowSubmitOptions, PixelflowWaitOptions, RequestRecord, RunOptions, RunResult, SubmitOptions, SubmitResponse, UploadOptions, UploadedFile, WaitOptions, Webhook };