codai-sdk 0.72.0 → 0.73.0

package/dist/index.d.ts

@@ -6099,8 +6099,26 @@ type paths$1 = {
     readonly get?: never;
     readonly put?: never;
     /**
-     * Create a production (brief → video)
-     * @description One brief becomes a finished promo video, server-side: ONE model turn storyboards it on a built-in video starter
+     * Create a production (brief → finished output)
+     * @description One brief becomes a finished output of one of 8 kinds (`kind`, default `video`), server-side. Every kind runs one
+     *     bounded plan turn (`codai::production-storyboard`), generates its images or music under one wallet hold, saves an
+     *     editable creative and builds the output with the regular Studio builders:
+     *
+     *     | kind | plan | output (`outputs[].role` → format) |
+     *     |---|---|---|
+     *     | `video` | storyboard on a starter | MP4 render (`render_id`), vision review + one repair |
+     *     | `image` | headline, subline, image prompt, format (1:1, 4:5 or 9:16) | `image` → PNG |
+     *     | `deck` | title + 4–8 slides | `document` → PPTX (16:9) |
+     *     | `doc` | title + 4–8 sections | `document` → DOCX (A4) |
+     *     | `sheet` | title + columns + 5–20 rows | `document` → XLSX |
+     *     | `carousel` | 4–8 slides (4:5) | `pages` → ZIP of PNGs, `cover` → PNG |
+     *     | `print` | poster or flyer, A4 or A5 | `pdf` → PDF |
+     *     | `audio` | jingle or song, ≤ 60 s (Lyria 3 Clip, not available on EU data-residency keys) | `audio` → MP3 |
+     *
+     *     `starter`, `voice`, `narration` and `aspect_ratio` apply to `video` only (`starter` with another kind is a 400).
+     *     Non-video kinds have no review/repair step and return `kind`, `output_asset_id` and `outputs`; video responses are
+     *     unchanged. For `video`:
+     *     one brief becomes a finished promo video: ONE model turn storyboards it on a built-in video starter
      *     (copy vars, one image prompt and one narration line per scene), every scene gets a codai-image still and a
      *     narration line (in parallel, billed once each under one wallet hold), the result is saved as an editable creative
      *     and a draft render is queued. When the render is ready a vision review of one frame per scene may fix text once
@@ -8225,7 +8243,7 @@ type components$1 = {
        * @description Outcome of `referral_code`; `null` when not sent.
        * @enum {string|null}
        */
-      readonly referral_result: 'window_closed' | 'none' | 'invalid_code' | 'self' | 'already_referred' | 'flagged' | 'granted' | 'cap_reached' | null;
+      readonly referral_result: 'window_closed' | 'none' | 'invalid_code' | 'self' | 'already_referred' | 'flagged' | 'pending_payment' | 'granted' | 'cap_reached' | null;
       readonly training_opt_out: boolean;
       /** Format: uuid */
       readonly user_id: string;
@@ -16748,14 +16766,22 @@ type components$1 = {
       /** Format: date-time */
       readonly created_at: string;
       readonly creative_id: string | null;
+      /** @description Requested length in seconds (video productions); null when none was requested. */
+      readonly duration_s?: number | null;
       readonly error: string | null;
       readonly first_render_id: string | null;
       /** Format: uuid */
       readonly id: string;
+      /** @description Present only for non-video productions. */
+      readonly kind?: components$1['schemas']['StudioProductionKind'];
       /** @enum {string} */
       readonly language: 'en' | 'ro';
       /** @enum {string} */
       readonly object: 'studio.production';
+      /** @description The primary output (`outputs[0].asset_id`), `null` until `status` is `succeeded`. Present only for non-video productions. */
+      readonly output_asset_id?: string | null;
+      /** @description The built outputs (empty until `status` is `succeeded`). Present only for non-video productions. */
+      readonly outputs?: readonly components$1['schemas']['StudioProductionOutput'][];
       /**
        * @description storyboard → assets → render → qa → repair (at most once) → ready | failed.
        * @enum {string}
@@ -16782,15 +16808,18 @@ type components$1 = {
     /** Studio production request */
     readonly StudioProductionCreate: {
       /**
-       * @description Output format.
+       * @description Output format (`video` only; the other kinds pick their own format).
        * @default 16:9
        * @enum {string}
        */
       readonly aspect_ratio?: '16:9' | '9:16' | '1:1';
-      /** @description What the video should say: product, audience, tone, call to action (10–2,000 characters). */
+      /** @description What the output should say: product, audience, tone, call to action (10–2,000 characters). */
       readonly brief: string;
       /** @description Spending cap for the whole production in micro-USD (default 3,000,000, max 20,000,000). */
       readonly budget_micro_usd?: number;
+      /** @description Target length in seconds (`video` only). The storyboard and voice-over are planned for it and the scenes stretch to reach it; default: the starter's natural length (about 15–30 s). With another kind it is a 400. */
+      readonly duration_s?: number;
+      readonly kind?: components$1['schemas']['StudioProductionKind'];
       /**
        * @description Language of the copy and the voice-over (and of the starters the model chooses from).
        * @default ro
@@ -16798,17 +16827,35 @@ type components$1 = {
        */
       readonly language?: 'en' | 'ro';
       /**
-       * @description Add a voice-over (one line per scene).
+       * @description Add a voice-over (one line per scene). `video` only.
        * @default true
        */
       readonly narration?: boolean;
-      /** @description Optional video starter to use (`starter:<slug>:<language>`); default: the model picks one. */
+      /** @description Optional video starter to use (`starter:<slug>:<language>`); default: the model picks one. `video` only. */
       readonly starter?: string;
       /** @description Optional title (default: the storyboard title). */
       readonly title?: string;
       /** @description Optional narration voice (a Cloud TTS voice name or `custom:<uuid>`). */
       readonly voice?: string;
     };
+    /**
+     * Studio production kind
+     * @description What the production builds: `video` (MP4), `image` (PNG), `deck` (PPTX), `doc` (DOCX), `sheet` (XLSX), `audio` (MP3 jingle or song), `carousel` (PNG slides in a ZIP + cover) or `print` (A4/A5 PDF poster or flyer).
+     * @default video
+     * @enum {string}
+     */
+    readonly StudioProductionKind: 'video' | 'image' | 'deck' | 'doc' | 'sheet' | 'audio' | 'carousel' | 'print';
+    /**
+     * Studio production output
+     * @description A built output of a non-video production: the regular Studio asset plus its `role`. `url` is a 1 h signed GET, `null` while not ready.
+     */
+    readonly StudioProductionOutput: components$1['schemas']['AssetDto'] & {
+      /**
+       * @description What the asset is: `image` (PNG), `cover` (carousel cover PNG), `document` (PPTX, DOCX or XLSX), `pages` (ZIP of carousel PNGs), `pdf` or `audio` (MP3).
+       * @enum {string}
+       */
+      readonly role: 'image' | 'cover' | 'document' | 'pages' | 'pdf' | 'audio';
+    };
     /** Review decision */
     readonly StudioPublicDecisionRequest: {
       /** @enum {string} */
@@ -37879,6 +37926,8 @@ export declare class Templates {
 }
 export type StudioProductionCreate = Mutable<Body<'createStudioProduction'>>;
 export type StudioProduction = Schema<'StudioProduction'>;
+export type StudioProductionKind = Schema<'StudioProductionKind'>;
+export type StudioProductionOutput = Schema<'StudioProductionOutput'>;
 type CallOpts$27 = {
   ext?: CodaiRequestExtensions;
   signal?: AbortSignal;