corent-sdk 0.1.0 → 0.2.0

package/README.md

@@ -35,6 +35,22 @@ console.log(speech.url, speech.costCents);
 - **Backoff** — 429/5xx retried with `Retry-After` respected.
 - **Honest receipts** — `width`/`height` are the *measured* pixels of the delivered file; `costCents` is the exact charge.
 
+## Pick a model yourself (direct access)
+
+Pass `model` instead of `tier` to pin an exact model. It is never substituted:
+if that model can't deliver, the call fails and you are not charged.
+
+```ts
+const image = await client.images.generate("a lighthouse at dusk", { model: "flux-schnell" });
+console.log(image.model); // "flux-schnell" — the name you asked for
+
+await client.models(); // the menu: every model with its kind, quality and exact price
+```
+
+Each model has one name. When we can reach it by more than one route, Corent
+serves whichever is cheapest at that moment and charges you that price — you
+never have to shop between near-identical entries.
+
 ## Fine-grained control
 
 ```ts
@@ -42,7 +58,8 @@ const job = await client.images.generate("...", { tier: "max_pro", wait: false }
 const done = await client.jobs.wait(job.id); // resume any time
 
 await client.tiers();        // live catalog with honest min–max price ranges
+await client.models();       // direct-access menu with per-model prices
 await client.balanceCents(); // prepaid balance
 ```
 
-Tiers: `air` | `lite` | `premium` | `pro` | `max_pro` — see [corent.tech/pricing](https://corent.tech/pricing). Docs: [corent.tech/docs](https://corent.tech/docs). MCP server for agents: [`corent-mcp`](https://www.npmjs.com/package/corent-mcp).
+Tiers: `air` | `lite` | `premium` | `pro` | `max_pro` — see [corent.tech/pricing](https://corent.tech/pricing). Models: [corent.tech/models](https://corent.tech/models). Docs: [corent.tech/docs](https://corent.tech/docs). MCP server for agents: [`corent-mcp`](https://www.npmjs.com/package/corent-mcp).

package/dist/index.cjs

@@ -78,6 +78,12 @@ var Corent = class {
     const r = await this.request("GET", "/v1/tiers");
     return r.tiers;
   }
+  /** The direct-access menu: every model you can pin by name, with its kind,
+   * quality score and flat cost-plus price. Public. */
+  async models() {
+    const r = await this.request("GET", "/v1/models");
+    return r.models;
+  }
   /** @internal */
   async request(method, path, body, idempotent = false) {
     const headers = {
@@ -139,7 +145,11 @@ var Images = class {
   }
   c;
   /** Render an image. Submits as a background job and polls, so a client
-   * timeout can never lose a finished render. Pass wait:false for the Job. */
+   * timeout can never lose a finished render. Pass wait:false for the Job.
+   *
+   * `model` pins an exact model from client.models() instead of letting the
+   * router choose — direct access: never substituted, flat cost-plus price.
+   * Pass tier OR model, not both. */
   async generate(prompt, options = {}) {
     const body = {
       prompt,
@@ -147,6 +157,7 @@ var Images = class {
       async: true
     };
     if (options.tier) body.tier = options.tier;
+    if (options.model) body.model = options.model;
     if (options.style) body.style = options.style;
     const submitted = await this.c.request("POST", "/v1/images/generate", body, true);
     if (submitted.status === "completed") return imageFromJob(submitted);
@@ -163,13 +174,18 @@ var Videos = class {
   c;
   /** Render a video (1–5 minutes typical). resolution: 720p | 1080p | 4k —
    * tier-capped, clamped down rather than rejected. imageUrl animates an
-   * existing image (image-to-video). */
+   * existing image (image-to-video).
+   *
+   * `model` pins an exact model from client.models() — direct access, never
+   * substituted, and duration/resolution snap to THAT model's own menu rather
+   * than a tier cap. Pass tier OR model, not both. */
   async generate(prompt, options = {}) {
     const body = {
       prompt,
       aspect_ratio: options.aspectRatio ?? "16:9"
     };
     if (options.tier) body.tier = options.tier;
+    if (options.model) body.model = options.model;
     if (options.durationS !== void 0) body.duration_s = options.durationS;
     if (options.resolution) body.resolution = options.resolution;
     if (options.imageUrl) body.image_url = options.imageUrl;
@@ -185,10 +201,12 @@ var Speech = class {
     this.c = c;
   }
   c;
-  /** Text to speech; synchronous, returns the finished audio and exact charge. */
+  /** Text to speech; synchronous, returns the finished audio and exact charge.
+   * `model` pins an exact speech model from client.models(). */
   async generate(text, options = {}) {
     const body = { text };
     if (options.voiceId) body.voice_id = options.voiceId;
+    if (options.model) body.model = options.model;
     const r = await this.c.request("POST", "/v1/audio/speech", body, true);
     const meta = r.meta ?? {};
     return { id: r.id, url: r.audio_url, model: meta.model, costCents: meta.cost_cents };

package/dist/index.d.cts

@@ -73,6 +73,9 @@ declare class Corent {
     balanceCents(): Promise<number>;
     /** The live tier catalog with honest min–max price ranges. Public. */
     tiers(): Promise<Record<string, unknown>[]>;
+    /** The direct-access menu: every model you can pin by name, with its kind,
+     * quality score and flat cost-plus price. Public. */
+    models(): Promise<Record<string, unknown>[]>;
     /** @internal */
     request(method: string, path: string, body?: Record<string, unknown>, idempotent?: boolean): Promise<Record<string, any>>;
     /** @internal */
@@ -82,9 +85,14 @@ declare class Images {
     private c;
     constructor(c: Corent);
     /** Render an image. Submits as a background job and polls, so a client
-     * timeout can never lose a finished render. Pass wait:false for the Job. */
+     * timeout can never lose a finished render. Pass wait:false for the Job.
+     *
+     * `model` pins an exact model from client.models() instead of letting the
+     * router choose — direct access: never substituted, flat cost-plus price.
+     * Pass tier OR model, not both. */
     generate(prompt: string, options?: {
         tier?: Tier;
+        model?: string;
         style?: string;
         aspectRatio?: string;
         wait?: false | true;
@@ -96,9 +104,14 @@ declare class Videos {
     constructor(c: Corent);
     /** Render a video (1–5 minutes typical). resolution: 720p | 1080p | 4k —
      * tier-capped, clamped down rather than rejected. imageUrl animates an
-     * existing image (image-to-video). */
+     * existing image (image-to-video).
+     *
+     * `model` pins an exact model from client.models() — direct access, never
+     * substituted, and duration/resolution snap to THAT model's own menu rather
+     * than a tier cap. Pass tier OR model, not both. */
     generate(prompt: string, options?: {
         tier?: Tier;
+        model?: string;
         aspectRatio?: string;
         durationS?: number;
         resolution?: "720p" | "1080p" | "4k";
@@ -110,9 +123,11 @@ declare class Videos {
 declare class Speech {
     private c;
     constructor(c: Corent);
-    /** Text to speech; synchronous, returns the finished audio and exact charge. */
+    /** Text to speech; synchronous, returns the finished audio and exact charge.
+     * `model` pins an exact speech model from client.models(). */
     generate(text: string, options?: {
         voiceId?: string;
+        model?: string;
     }): Promise<GeneratedSpeech>;
 }
 declare class Jobs {

package/dist/index.d.ts

@@ -73,6 +73,9 @@ declare class Corent {
     balanceCents(): Promise<number>;
     /** The live tier catalog with honest min–max price ranges. Public. */
     tiers(): Promise<Record<string, unknown>[]>;
+    /** The direct-access menu: every model you can pin by name, with its kind,
+     * quality score and flat cost-plus price. Public. */
+    models(): Promise<Record<string, unknown>[]>;
     /** @internal */
     request(method: string, path: string, body?: Record<string, unknown>, idempotent?: boolean): Promise<Record<string, any>>;
     /** @internal */
@@ -82,9 +85,14 @@ declare class Images {
     private c;
     constructor(c: Corent);
     /** Render an image. Submits as a background job and polls, so a client
-     * timeout can never lose a finished render. Pass wait:false for the Job. */
+     * timeout can never lose a finished render. Pass wait:false for the Job.
+     *
+     * `model` pins an exact model from client.models() instead of letting the
+     * router choose — direct access: never substituted, flat cost-plus price.
+     * Pass tier OR model, not both. */
     generate(prompt: string, options?: {
         tier?: Tier;
+        model?: string;
         style?: string;
         aspectRatio?: string;
         wait?: false | true;
@@ -96,9 +104,14 @@ declare class Videos {
     constructor(c: Corent);
     /** Render a video (1–5 minutes typical). resolution: 720p | 1080p | 4k —
      * tier-capped, clamped down rather than rejected. imageUrl animates an
-     * existing image (image-to-video). */
+     * existing image (image-to-video).
+     *
+     * `model` pins an exact model from client.models() — direct access, never
+     * substituted, and duration/resolution snap to THAT model's own menu rather
+     * than a tier cap. Pass tier OR model, not both. */
     generate(prompt: string, options?: {
         tier?: Tier;
+        model?: string;
         aspectRatio?: string;
         durationS?: number;
         resolution?: "720p" | "1080p" | "4k";
@@ -110,9 +123,11 @@ declare class Videos {
 declare class Speech {
     private c;
     constructor(c: Corent);
-    /** Text to speech; synchronous, returns the finished audio and exact charge. */
+    /** Text to speech; synchronous, returns the finished audio and exact charge.
+     * `model` pins an exact speech model from client.models(). */
     generate(text: string, options?: {
         voiceId?: string;
+        model?: string;
     }): Promise<GeneratedSpeech>;
 }
 declare class Jobs {

package/dist/index.js

@@ -50,6 +50,12 @@ var Corent = class {
     const r = await this.request("GET", "/v1/tiers");
     return r.tiers;
   }
+  /** The direct-access menu: every model you can pin by name, with its kind,
+   * quality score and flat cost-plus price. Public. */
+  async models() {
+    const r = await this.request("GET", "/v1/models");
+    return r.models;
+  }
   /** @internal */
   async request(method, path, body, idempotent = false) {
     const headers = {
@@ -111,7 +117,11 @@ var Images = class {
   }
   c;
   /** Render an image. Submits as a background job and polls, so a client
-   * timeout can never lose a finished render. Pass wait:false for the Job. */
+   * timeout can never lose a finished render. Pass wait:false for the Job.
+   *
+   * `model` pins an exact model from client.models() instead of letting the
+   * router choose — direct access: never substituted, flat cost-plus price.
+   * Pass tier OR model, not both. */
   async generate(prompt, options = {}) {
     const body = {
       prompt,
@@ -119,6 +129,7 @@ var Images = class {
       async: true
     };
     if (options.tier) body.tier = options.tier;
+    if (options.model) body.model = options.model;
     if (options.style) body.style = options.style;
     const submitted = await this.c.request("POST", "/v1/images/generate", body, true);
     if (submitted.status === "completed") return imageFromJob(submitted);
@@ -135,13 +146,18 @@ var Videos = class {
   c;
   /** Render a video (1–5 minutes typical). resolution: 720p | 1080p | 4k —
    * tier-capped, clamped down rather than rejected. imageUrl animates an
-   * existing image (image-to-video). */
+   * existing image (image-to-video).
+   *
+   * `model` pins an exact model from client.models() — direct access, never
+   * substituted, and duration/resolution snap to THAT model's own menu rather
+   * than a tier cap. Pass tier OR model, not both. */
   async generate(prompt, options = {}) {
     const body = {
       prompt,
       aspect_ratio: options.aspectRatio ?? "16:9"
     };
     if (options.tier) body.tier = options.tier;
+    if (options.model) body.model = options.model;
     if (options.durationS !== void 0) body.duration_s = options.durationS;
     if (options.resolution) body.resolution = options.resolution;
     if (options.imageUrl) body.image_url = options.imageUrl;
@@ -157,10 +173,12 @@ var Speech = class {
     this.c = c;
   }
   c;
-  /** Text to speech; synchronous, returns the finished audio and exact charge. */
+  /** Text to speech; synchronous, returns the finished audio and exact charge.
+   * `model` pins an exact speech model from client.models(). */
   async generate(text, options = {}) {
     const body = { text };
     if (options.voiceId) body.voice_id = options.voiceId;
+    if (options.model) body.model = options.model;
     const r = await this.c.request("POST", "/v1/audio/speech", body, true);
     const meta = r.meta ?? {};
     return { id: r.id, url: r.audio_url, model: meta.model, costCents: meta.cost_cents };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "corent-sdk",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Official TypeScript/JavaScript SDK for Corent — one API for AI image, video, and voice generation with built-in routing, failover, and exact receipts.",
   "license": "MIT",
   "type": "module",