codai-sdk 0.68.0 → 0.69.0

package/dist/index.d.ts

@@ -4611,7 +4611,7 @@ type paths$1 = {
     readonly get?: never;
     readonly put?: never;
     /**
-     * Build a deck, doc or sheet creative into a file
+     * Build a deck, doc, sheet, carousel or print creative into a file
      * @description Converts the deck, doc or sheet creative at `seq` (default: the head) back into a documents spec and builds the
      *     PPTX, DOCX or XLSX exactly like `POST /v1/studio/documents` (same validation, limits, themes and builders). Each
      *     build is a new version of the same document: `based_on` is the newest document built from this creative, so
@@ -4622,6 +4622,19 @@ type paths$1 = {
      *     The file is free (`cost_micro_usd: "0"` on `document`). `preview: true` also queues a LibreOffice preview, billed
      *     like `POST /v1/studio/documents/{id}/previews` ($0.002 per page, min $0.01). Video and image creatives answer 400
      *     `not_supported_for_kind`.
+     *
+     *     **Carousel and print creatives** (body `CreativePagedBuildRequest`) answer **202** with an export job in `export`
+     *     (poll `GET /v1/studio/exports/{id}` until `succeeded`, then download `url`):
+     *     - carousel `format: png` (default): a zip of one PNG per slide (`slide-01.png` …) at the format size;
+     *       `format: pdf`: one PDF page per slide (LinkedIn document post), no bleed, no crop marks.
+     *     - print `format: pdf`: one sheet per page at the bleed box plus a crop-mark margin, crop marks outside the bleed,
+     *       TrimBox and BleedBox set on every page. The prepress check (bleed safety, minimum text size, image resolution,
+     *       colours outside a coated-CMYK gamut) runs first and its issues are returned in `lint`; they never block the build.
+     *       The PDF is RGB: PDF/X-4 conversion with the output intent is not done by the render worker, which `warnings` states.
+     *
+     *     Price: $0.002 per page (min $0.01), held in the wallet before dispatch (402 when short) and billed once when the
+     *     job finishes. Files carry machine-readable AI marks (PDF Info `Keywords`, PNG XMP) and the `x-codai-ai-generated`
+     *     header. Supports `Idempotency-Key` (24 h).
      */
     readonly post: operations$1['buildCreative'];
     readonly delete?: never;
@@ -5090,6 +5103,32 @@ type paths$1 = {
     readonly patch?: never;
     readonly trace?: never;
   };
+  readonly '/v1/studio/creatives/{id}/nodes/{nodeId}/regenerate': {
+    readonly parameters: {
+      readonly query?: never;
+      readonly header?: never;
+      readonly path?: never;
+      readonly cookie?: never;
+    };
+    readonly get?: never;
+    readonly put?: never;
+    /**
+     * Regenerate the picture of an image node
+     * @description Generates a new image for an `image` node with `codai-image` (billed like `POST /v1/images/generations`: wallet
+     *     hold of the quote first, one usage row, the stored asset is AI-marked) and swaps it in through the edit path. When
+     *     the node has a `castId`, that cast entry's `refAssetIds` are sent as reference images automatically and its
+     *     `description` is appended to the prompt, so the character or product stays the same across shots. The aspect
+     *     ratio defaults to the closest supported ratio of the node box. Video nodes: generate a clip with
+     *     `POST /v1/videos` and `reference_asset_ids`, then `replaceAsset`.
+     *     Supports `Idempotency-Key` (24 h): a retry with the same key and body replays the first response; a different body is 422 `idempotency_key_mismatch`; the first request still running is 409 `idempotency_in_progress`.
+     */
+    readonly post: operations$1['regenerateCreativeNode'];
+    readonly delete?: never;
+    readonly options?: never;
+    readonly head?: never;
+    readonly patch?: never;
+    readonly trace?: never;
+  };
   readonly '/v1/studio/creatives/{id}/ops': {
     readonly parameters: {
       readonly query?: never;
@@ -5142,6 +5181,34 @@ type paths$1 = {
     readonly patch?: never;
     readonly trace?: never;
   };
+  readonly '/v1/studio/creatives/{id}/post-copy': {
+    readonly parameters: {
+      readonly query?: never;
+      readonly header?: never;
+      readonly path?: never;
+      readonly cookie?: never;
+    };
+    readonly get?: never;
+    readonly put?: never;
+    /**
+     * Write social post copy for a creative
+     * @description Writes a caption and hashtags per platform (Instagram, LinkedIn, TikTok, X, Facebook) and one alt text per slide
+     *     for a carousel, image or video creative, in Romanian or English: one bounded `codai` turn with a forced tool over
+     *     the creative's outline, then every answer is repaired to the platform's hard limits (caption characters including
+     *     hashtags, hashtag count, alt text length): hashtags normalised, deduplicated and capped, captions trimmed on a word
+     *     end. What was changed is listed in `fixes`. Nothing is written to the creative.
+     *
+     *     Billing: token-metered (usage model `codai::post-copy`, prompt caching on) under a small wallet hold
+     *     (15 000 µUSD, settled with the real cost; 402 `insufficient_funds` when short). Copy and outlines are never
+     *     logged. Supports `Idempotency-Key` (24 h).
+     */
+    readonly post: operations$1['writeCreativePostCopy'];
+    readonly delete?: never;
+    readonly options?: never;
+    readonly head?: never;
+    readonly patch?: never;
+    readonly trace?: never;
+  };
   readonly '/v1/studio/creatives/{id}/render': {
     readonly parameters: {
       readonly query?: never;
@@ -5471,6 +5538,31 @@ type paths$1 = {
     readonly patch?: never;
     readonly trace?: never;
   };
+  readonly '/v1/studio/creatives/{id}/transcript-cut': {
+    readonly parameters: {
+      readonly query?: never;
+      readonly header?: never;
+      readonly path?: never;
+      readonly cookie?: never;
+    };
+    readonly get?: never;
+    readonly put?: never;
+    /**
+     * Edit a video clip by its transcript
+     * @description Deletes word ranges from a video node: the words are the clip asset's cached transcript (written by
+     *     `POST /v1/studio/creatives/{id}/captions`, word timings in source time). The removed spans are cut out with
+     *     `splitVideo` / `trimVideo` / `setTiming` ops and the pieces are placed back to back from the clip's start, as one
+     *     new version through the same edit path as `POST /v1/studio/creatives/{id}/ops` (rebase on a slightly stale
+     *     `base_seq`, locks honoured). Free: no transcription, no usage row. No cached transcript -> 409
+     *     `captions_required` (run captions on that clip first). Video creatives only.
+     */
+    readonly post: operations$1['transcriptCutCreative'];
+    readonly delete?: never;
+    readonly options?: never;
+    readonly head?: never;
+    readonly patch?: never;
+    readonly trace?: never;
+  };
   readonly '/v1/studio/creatives/{id}/variants': {
     readonly parameters: {
       readonly query?: never;
@@ -9610,6 +9702,8 @@ type components$1 = {
        * @example flat minimalist logo of a paper plane, two colours, white background
        */
       readonly prompt: string;
+      /** @description Your ready studio image assets used as references (e.g. a creative's cast), sent after `reference_images`; together they count against the per-model limit. A missing or foreign asset is 404. */
+      readonly reference_asset_ids?: readonly string[];
       /** @description Images the model must stay consistent with (logo, palette, product, character), sent before the prompt. Per-model limit — `codai-image-fast` accepts 4, the others 14. */
       readonly reference_images?: readonly components$1['schemas']['CoreImageInput'][];
       readonly response_format?: components$1['schemas']['MediaResponseFormat'];
@@ -10260,6 +10354,18 @@ type components$1 = {
       /** @description Number of caption words. */
       readonly words: number;
     };
+    /** Cast entry */
+    readonly CreativeCast: {
+      /** @description Appended to the prompt when the node is regenerated. */
+      readonly description?: string;
+      /** @description Shares the document id namespace with scenes and nodes. */
+      readonly id: string;
+      /** @enum {string} */
+      readonly kind: 'character' | 'product';
+      readonly name: string;
+      /** @description Image assets of the subject. */
+      readonly refAssetIds: readonly string[];
+    };
     /**
      * Frame comment
      * @example {
@@ -10431,6 +10537,8 @@ type components$1 = {
       readonly brand: {
         readonly [key: string]: unknown;
       };
+      /** @description Recurring characters / products (CX-05). An `image` / `video` node binds one with `props.castId`; regenerating that node sends the entry's `refAssetIds` as reference images so the subject looks the same in every shot. */
+      readonly cast?: readonly components$1['schemas']['CreativeCast'][];
       /** @description One of `formats[].id`. */
       readonly defaultFormat: string;
       /** @description Output formats (`{ id, width, height }`); nodes may override their layout per format. */
@@ -10925,6 +11033,11 @@ type components$1 = {
      *     (`control: null` clears it), `setMeta { title?, locale?, formats?, defaultFormat?, fps? }`,
      *     `setLocaleText { locale, texts, by? }` (`texts`: unit key → translation, `null` removes it),
      *     `setLocale { locale, tone?, audio?, captions?, remove? }`, `setLocalization { source?, glossary?, forkOf?, reset? }`.
+     *     Video clips (CX-06, video nodes; source in / out points in media ms, `rate` 0.25–4, J / L cuts via the node's
+     *     `audioLeadMs` / `audioTailMs` props): `trimVideo { target, inMs?, outMs?, fitTiming? }` (`null` clears a point),
+     *     `splitVideo { target, atMs, newId }` (cut at `atMs` after the node start into two nodes),
+     *     `setVideoRate { target, rate, fitTiming? }` (`rate: null` = 1x). Cast (CX-05): `addCast { cast }`,
+     *     `updateCast { target, patch }`, `removeCast { target }` (drops the `castId` of nodes that used it).
      *     Audio ops (any creative's `doc.audio`; songs and podcasts): `addSection { section }`, `updateSection { target, patch }`,
      *     `removeSection { target }`, `moveSection { target, startMs }`, `addTrack { track, index? }`,
      *     `updateTrack { target, patch }`, `removeTrack { target }`, `splitClip { clipId, atMs, newId }`,
@@ -10943,7 +11056,7 @@ type components$1 = {
      */
     readonly CreativeOp: {
       /** @enum {string} */
-      readonly op: 'setProps' | 'setLayout' | 'setTiming' | 'setAnim' | 'insertNode' | 'removeNode' | 'moveNode' | 'addScene' | 'removeScene' | 'updateScene' | 'moveScene' | 'setVar' | 'removeVar' | 'setAsset' | 'replaceAsset' | 'setAudioClip' | 'removeAudioClip' | 'setBrand' | 'restyle' | 'adaptFormat' | 'setControl' | 'setMeta' | 'setLocaleText' | 'setLocale' | 'setLocalization' | 'addSection' | 'updateSection' | 'removeSection' | 'moveSection' | 'addTrack' | 'updateTrack' | 'removeTrack' | 'splitClip' | 'trimClip' | 'moveClip' | 'setFades' | 'addMidiClip' | 'removeMidiClip' | 'updateMidiNotes' | 'setMaster' | 'setLyrics';
+      readonly op: 'setProps' | 'setLayout' | 'setTiming' | 'setAnim' | 'insertNode' | 'removeNode' | 'moveNode' | 'addScene' | 'removeScene' | 'updateScene' | 'moveScene' | 'setVar' | 'removeVar' | 'setAsset' | 'replaceAsset' | 'setAudioClip' | 'removeAudioClip' | 'setBrand' | 'restyle' | 'adaptFormat' | 'setControl' | 'setMeta' | 'setLocaleText' | 'setLocale' | 'setLocalization' | 'trimVideo' | 'splitVideo' | 'setVideoRate' | 'addCast' | 'updateCast' | 'removeCast' | 'addSection' | 'updateSection' | 'removeSection' | 'moveSection' | 'addTrack' | 'updateTrack' | 'removeTrack' | 'splitClip' | 'trimClip' | 'moveClip' | 'setFades' | 'addMidiClip' | 'removeMidiClip' | 'updateMidiNotes' | 'setMaster' | 'setLyrics';
     } & {
       readonly [key: string]: unknown;
     };
@@ -11003,6 +11116,79 @@ type components$1 = {
         readonly [key: string]: unknown;
       };
     };
+    /**
+     * Carousel / print build request
+     * @example {
+     *       "format": "pdf",
+     *       "format_id": "1x1"
+     *     }
+     */
+    readonly CreativePagedBuildRequest: {
+      /**
+       * @description Print only — crop marks outside the bleed.
+       * @default true
+       */
+      readonly crop_marks?: boolean;
+      /** @description File name without extension (default `<slug of the title>-<format_id>`). */
+      readonly filename?: string;
+      /**
+       * @description Output: carousel `png` (zip of slides, default) or `pdf`; print creatives build `pdf` only.
+       * @enum {string}
+       */
+      readonly format?: 'png' | 'pdf';
+      /** @description Layout format of the creative (default its `defaultFormat`), e.g. `4x5`, `1x1`, `a4`, `card`. */
+      readonly format_id?: string;
+      /** @description Accepted for parity with deck builds; ignored. */
+      readonly preview?: boolean;
+      /** @description Creative version to build (default the head). */
+      readonly seq?: number;
+    };
+    /** Prepress issue */
+    readonly CreativePrintLintIssue: {
+      /** @description `print_in_bleed`, `print_outside_safe`, `print_bleed_short`, `print_low_res`, `print_rgb_color`, `print_text_too_small`, `missing_alt`, `svg_empty`. */
+      readonly code: string;
+      readonly fixable?: boolean;
+      readonly format?: string;
+      readonly message: string;
+      /** @enum {string} */
+      readonly severity: 'error' | 'warning';
+      /** @description Node or scene id. */
+      readonly target: string;
+      /** @description Measured value (pt, dpi, mm) where meaningful. */
+      readonly value?: number;
+    };
+    /** Regenerate node request */
+    readonly CreativeRegenerateNodeRequest: {
+      /**
+       * @description Default the closest ratio to the node box.
+       * @enum {string}
+       */
+      readonly aspect_ratio?: '1:1' | '2:3' | '3:2' | '3:4' | '4:3' | '4:5' | '5:4' | '9:16' | '16:9' | '21:9' | '9:21';
+      readonly base_seq?: number;
+      /** @default false */
+      readonly force?: boolean;
+      /** @example codai-image */
+      readonly model?: string;
+      readonly prompt: string;
+    };
+    /** Regenerate node result */
+    readonly CreativeRegenerateNodeResult: {
+      /**
+       * Format: uuid
+       * @description The new image asset.
+       */
+      readonly asset_id: string;
+      readonly cast_id: string | null;
+      readonly changed: readonly string[];
+      readonly cost_micro_usd: string;
+      readonly doc_hash: string;
+      readonly node_id: string;
+      readonly rebased: boolean;
+      /** @description The cast references that were sent. */
+      readonly reference_asset_ids: readonly string[];
+      readonly seq: number;
+      readonly warnings: readonly string[];
+    };
     /** Queued creative render */
     readonly CreativeRenderAccepted: {
       readonly ai_label?: components$1['schemas']['StudioRenderAiLabel'];
@@ -11265,6 +11451,55 @@ type components$1 = {
        */
       readonly type: 'text' | 'image';
     };
+    /**
+     * Transcript cut request
+     * @example {
+     *       "node_id": "clip",
+     *       "remove": [
+     *         {
+     *           "from_word": 3,
+     *           "to_word": 4
+     *         }
+     *       ]
+     *     }
+     */
+    readonly CreativeTranscriptCutRequest: {
+      /** @description The version to edit (default the head). */
+      readonly base_seq?: number;
+      /**
+       * @description Edit locked nodes too.
+       * @default false
+       */
+      readonly force?: boolean;
+      /** @description The video node to edit. */
+      readonly node_id: string;
+      /** @description Word index ranges (inclusive) of the clip transcript to delete; overlapping ranges are merged. */
+      readonly remove: readonly {
+        readonly from_word: number;
+        readonly to_word: number;
+      }[];
+    };
+    /** Transcript cut result */
+    readonly CreativeTranscriptCutResult: {
+      readonly changed: readonly string[];
+      readonly doc_hash: string;
+      readonly node_id: string;
+      /** @description Ids of the clip pieces in playback order (the first is the original node; empty when everything was cut and the node removed). */
+      readonly pieces: readonly string[];
+      readonly rebased: boolean;
+      /** @description Source spans removed (media ms). */
+      readonly removed: readonly {
+        readonly in_ms: number;
+        readonly out_ms: number;
+      }[];
+      /** @description Playback time removed from the clip (ms at its rate). */
+      readonly removed_ms: number;
+      /** @description The new head version. */
+      readonly seq: number;
+      readonly warnings: readonly string[];
+      /** @description Words in the cached transcript. */
+      readonly words: number;
+    };
     /** Variant */
     readonly CreativeVariant: {
       /** @description Ops applied on top of the original. */
@@ -13081,6 +13316,8 @@ type components$1 = {
        * @default []
        */
       readonly asset_ids?: readonly string[];
+      /** @description image.inpaint / image.erase only: a mask painted in an editor, base64 PNG (white = edit, black = keep, at most 8 MB). Send ONE asset id (the image); the gateway stores the mask as a free private asset and passes it as the second input. A quote validates it without storing anything. */
+      readonly mask_png_b64?: string;
       /**
        * @description Per-op parameters (table above).
        * @default {}
@@ -15674,6 +15911,80 @@ type components$1 = {
         readonly seq: number;
       };
     };
+    /**
+     * Carousel / print build
+     * @description A carousel or print creative queued for its paged export; download it from `export.url` once the export succeeds.
+     * @example {
+     *       "object": "studio.creative_build",
+     *       "creative_id": "7a1b2c3d-0000-4000-8000-000000000051",
+     *       "seq": 3,
+     *       "kind": "carousel",
+     *       "format": "png",
+     *       "format_id": "4x5",
+     *       "pages": 6,
+     *       "quote_micro_usd": "12000",
+     *       "warnings": [],
+     *       "lint": [],
+     *       "print": null,
+     *       "document": null,
+     *       "export": {
+     *         "id": "3f0c9a7e-1b2d-4c5e-8f90-a1b2c3d4e5f7",
+     *         "object": "studio.export",
+     *         "kind": "carousel_png",
+     *         "status": "queued",
+     *         "creative_id": "7a1b2c3d-0000-4000-8000-000000000051",
+     *         "seq": 3,
+     *         "format": "4x5",
+     *         "fps": 0,
+     *         "filename": "spring-sale-4x5.zip",
+     *         "url": null,
+     *         "expires_at": null,
+     *         "bytes": null,
+     *         "rendered_seconds": null,
+     *         "cost_micro_usd": null,
+     *         "pages": null,
+     *         "boxes": null,
+     *         "lint": [],
+     *         "warnings": [],
+     *         "error": null,
+     *         "created_at": "2026-10-20T10:00:00Z"
+     *       }
+     *     }
+     */
+    readonly StudioCreativePagedBuild: {
+      /** Format: uuid */
+      readonly creative_id: string;
+      readonly document: null;
+      readonly export: components$1['schemas']['StudioExport'];
+      /** @enum {string} */
+      readonly format: 'png' | 'pdf';
+      readonly format_id: string;
+      /** @enum {string} */
+      readonly kind: 'carousel' | 'print';
+      readonly lint: readonly components$1['schemas']['CreativePrintLintIssue'][];
+      /** @enum {string} */
+      readonly object: 'studio.creative_build';
+      readonly pages: number;
+      /** @description Print PDFs only — physical sheet and PDF boxes. */
+      readonly print: {
+        /** @description BleedBox offsets from the TrimBox in points [left, right, top, bottom]. */
+        readonly bleed_offsets_pt?: readonly number[] | null;
+        /** @description Intended press output intent (e.g. `FOGRA39`); the file itself is RGB. */
+        readonly color_profile?: string;
+        readonly crop_marks?: boolean;
+        /** @description Always `false` today (no PDF/X-4 conversion in the worker). */
+        readonly pdf_x4?: boolean;
+        /** @description Sheet (MediaBox) width and height in mm, bleed and crop-mark margin included. */
+        readonly sheet_mm?: readonly number[];
+        /** @description TrimBox offsets from the MediaBox in points [left, right, top, bottom]. */
+        readonly trim_offsets_pt?: readonly number[] | null;
+      } | null;
+      /** @description Price held for the job in µUSD ($0.002 per page, min $0.01). */
+      readonly quote_micro_usd: string;
+      readonly seq: number;
+      /** @description E.g. the PDF/X-4 limitation of print PDFs, or a note that the prepress check found errors. */
+      readonly warnings: readonly string[];
+    };
     /**
      * Studio export
      * @description An export of a video creative, downloadable once `status` is `succeeded`: an FCPXML zip with `project.fcpxml` and its media (`kind: fcpxml`), or a Lottie JSON / dotLottie file (`kind: lottie`, ready at once).
@@ -15698,6 +16009,8 @@ type components$1 = {
      *     }
      */
     readonly StudioExport: {
+      /** @description Print PDF only: TrimBox and BleedBox were written on every page; `null` until `succeeded`. */
+      readonly boxes?: boolean | null;
       /** @description Size of the zip in bytes; `null` until `succeeded`. */
       readonly bytes: number | null;
       /**
@@ -15733,12 +16046,16 @@ type components$1 = {
       /** Format: uuid */
       readonly id: string;
       /**
-       * @description What was exported: an FCPXML project zip (`export.fcpxml`) or a Lottie file (`export.lottie`).
+       * @description What was exported: an FCPXML project zip (`export.fcpxml`), a Lottie file (`export.lottie`), or a paged build of `POST /v1/studio/creatives/{id}/build`: a carousel PNG zip, a carousel PDF or a print PDF.
        * @enum {string}
        */
-      readonly kind?: 'fcpxml' | 'lottie';
+      readonly kind?: 'fcpxml' | 'lottie' | 'carousel_png' | 'carousel_pdf' | 'print_pdf';
+      /** @description Paged builds only: prepress issues found at dispatch. */
+      readonly lint?: readonly components$1['schemas']['CreativePrintLintIssue'][];
       /** @enum {string} */
       readonly object: 'studio.export';
+      /** @description Paged builds only: pages in the file; `null` until `succeeded`. */
+      readonly pages?: number | null;
       /** @description Seconds of video newly rendered for this export (cached segments excluded); `null` until done. */
       readonly rendered_seconds: number | null;
       /** @description The exported creative version. */
@@ -15881,6 +16198,113 @@ type components$1 = {
       /** @description Default voice. */
       readonly voice?: string;
     };
+    /**
+     * Post copy
+     * @example {
+     *       "object": "studio.post_copy",
+     *       "creative_id": "7a1b2c3d-0000-4000-8000-000000000051",
+     *       "seq": 3,
+     *       "kind": "carousel",
+     *       "language": "ro",
+     *       "platforms": [
+     *         {
+     *           "platform": "linkedin",
+     *           "caption": "Primăvara vine cu reduceri de 20% la toată colecția.",
+     *           "hashtags": [
+     *             "#primăvară",
+     *             "#reduceri"
+     *           ],
+     *           "text": "Primăvara vine cu reduceri de 20% la toată colecția.\n\n#primăvară #reduceri",
+     *           "chars": 74,
+     *           "limits": {
+     *             "caption": 3000,
+     *             "hashtags": 10,
+     *             "alt": 300
+     *           }
+     *         }
+     *       ],
+     *       "alt": [
+     *         {
+     *           "scene_id": "s1",
+     *           "text": "Un buchet de lalele galbene pe o masă albă."
+     *         }
+     *       ],
+     *       "fixes": [],
+     *       "cost_micro_usd": "2140"
+     *     }
+     */
+    readonly StudioPostCopy: {
+      /** @description One alt text per slide in slide order (the first scene of an image), trimmed to the strictest platform's cap. */
+      readonly alt: readonly {
+        readonly scene_id: string;
+        readonly text: string;
+      }[];
+      /** @description Token cost of the turn in µUSD. */
+      readonly cost_micro_usd: string;
+      /** Format: uuid */
+      readonly creative_id: string;
+      /** @description What the limit repair changed (trimmed captions, dropped or capped hashtags, missing alt texts). */
+      readonly fixes: readonly {
+        /** @enum {string} */
+        readonly field?: 'caption' | 'hashtags' | 'alt';
+        readonly message?: string;
+        readonly platform?: string;
+      }[];
+      /** @enum {string} */
+      readonly kind: 'carousel' | 'image' | 'video';
+      /** @enum {string} */
+      readonly language: 'ro' | 'en';
+      /** @enum {string} */
+      readonly object: 'studio.post_copy';
+      /** @description One entry per requested platform, in request order. */
+      readonly platforms: readonly {
+        readonly caption: string;
+        /** @description Length of `text` in Unicode code points. */
+        readonly chars: number;
+        /** @description Normalised `#tags` (letters, digits, underscore; diacritics kept), deduplicated. */
+        readonly hashtags: readonly string[];
+        readonly limits: {
+          readonly alt?: number;
+          readonly caption?: number;
+          readonly hashtags?: number;
+        };
+        /** @enum {string} */
+        readonly platform: 'instagram' | 'linkedin' | 'tiktok' | 'x' | 'facebook';
+        /** @description The post as published — caption, a blank line, then the hashtags not already in the caption. */
+        readonly text: string;
+      }[];
+      readonly seq: number;
+    };
+    /**
+     * Post copy request
+     * @example {
+     *       "platforms": [
+     *         "instagram",
+     *         "linkedin"
+     *       ],
+     *       "language": "ro",
+     *       "brief": "Reducere 20% până duminică"
+     *     }
+     */
+    readonly StudioPostCopyRequest: {
+      /** @description Optional steer — audience, call to action, facts to include. */
+      readonly brief?: string;
+      /**
+       * @default ro
+       * @enum {string}
+       */
+      readonly language?: 'ro' | 'en';
+      /**
+       * @default [
+       *       "instagram",
+       *       "linkedin"
+       *     ]
+       */
+      readonly platforms?: readonly ('instagram' | 'linkedin' | 'tiktok' | 'x' | 'facebook')[];
+      /** @description Creative version to describe (default the head). */
+      readonly seq?: number;
+      readonly tone?: string;
+    };
     /** Studio production */
     readonly StudioProduction: {
       /** @enum {string} */
@@ -27964,6 +28388,8 @@ interface operations$1 {
     readonly parameters: {
       readonly query?: never;
       readonly header?: {
+        /** @description Replays the stored response of an earlier request with the same key for 24 h instead of running it again. */
+        readonly 'Idempotency-Key'?: components$1['parameters']['IdempotencyKey'];
         /** @description Client correlation id; echoed back as `x-codai-trace-id` and persisted on the usage row. */
         readonly 'x-request-id'?: components$1['parameters']['RequestId'];
       };
@@ -27975,7 +28401,7 @@ interface operations$1 {
     };
     readonly requestBody?: {
       readonly content: {
-        readonly 'application/json': components$1['schemas']['CreativeBuildRequest'];
+        readonly 'application/json': components$1['schemas']['CreativeBuildRequest'] | components$1['schemas']['CreativePagedBuildRequest'];
       };
     };
     readonly responses: {
@@ -27988,7 +28414,16 @@ interface operations$1 {
           readonly 'application/json': components$1['schemas']['StudioCreativeBuild'];
         };
       };
-      /** @description Invalid body (`invalid_request`), a video or image creative (`not_supported_for_kind`), a converted spec that fails the documents schema (`invalid_spec`, first issues in the message), or any build error of `POST /v1/studio/documents` (`asset_not_found`, `unsupported_image`, `too_many_charts`, `chart_render_failed`). */
+      /** @description Carousel or print creative — export job queued (poll `GET /v1/studio/exports/{id}`). */
+      readonly 202: {
+        headers: {
+          readonly [name: string]: unknown;
+        };
+        content: {
+          readonly 'application/json': components$1['schemas']['StudioCreativePagedBuild'];
+        };
+      };
+      /** @description Invalid body (`invalid_request`, e.g. `format: png` on a print creative or an unknown `format_id`), a video or image creative (`not_supported_for_kind`), a converted spec that fails the documents schema (`invalid_spec`, first issues in the message), a PNG slide larger than 3840 px (`unsupported_format`), or any build error of `POST /v1/studio/documents` (`asset_not_found`, `unsupported_image`, `too_many_charts`, `chart_render_failed`). */
       readonly 400: {
         headers: {
           readonly [name: string]: unknown;
@@ -28009,7 +28444,7 @@ interface operations$1 {
           readonly 'application/json': components$1['schemas']['Error'];
         };
       };
-      /** @description The generated file is larger than 50 MB (code `document_too_large`). */
+      /** @description The generated file is larger than 50 MB (code `document_too_large`), or a paged build has more than 60 pages (`too_large`). */
       readonly 413: {
         headers: {
           readonly [name: string]: unknown;
@@ -28018,7 +28453,7 @@ interface operations$1 {
           readonly 'application/json': components$1['schemas']['Error'];
         };
       };
-      /** @description Spend cap reached (`rate_limit_exceeded`), or with `preview: true` 3 previews already queued or rendering (`too_many_previews`). */
+      /** @description Spend cap reached (`rate_limit_exceeded`), with `preview: true` 3 previews already queued or rendering (`too_many_previews`), or for carousel / print 3 renders and exports already running (`too_many_renders`). */
       readonly 429: {
         headers: {
           readonly [name: string]: unknown;
@@ -28027,7 +28462,7 @@ interface operations$1 {
           readonly 'application/json': components$1['schemas']['Error'];
         };
       };
-      /** @description Studio documents are not configured on this gateway (code `documents_unavailable`). */
+      /** @description Studio documents are not configured on this gateway (code `documents_unavailable`), or for carousel / print the render worker is not (`renders_unavailable`). */
       readonly 503: {
         headers: {
           readonly [name: string]: unknown;
@@ -28872,6 +29307,60 @@ interface operations$1 {
       };
     };
   };
+  readonly regenerateCreativeNode: {
+    readonly parameters: {
+      readonly query?: never;
+      readonly header?: {
+        /** @description Replays the stored response of an earlier request with the same key for 24 h instead of running it again. */
+        readonly 'Idempotency-Key'?: components$1['parameters']['IdempotencyKey'];
+        /** @description Client correlation id; echoed back as `x-codai-trace-id` and persisted on the usage row. */
+        readonly 'x-request-id'?: components$1['parameters']['RequestId'];
+      };
+      readonly path: {
+        /** @description Creative UUID. A malformed, unknown, deleted or foreign id is 404. */
+        readonly id: components$1['parameters']['CreativeId'];
+        readonly nodeId: string;
+      };
+      readonly cookie?: never;
+    };
+    readonly requestBody: {
+      readonly content: {
+        readonly 'application/json': components$1['schemas']['CreativeRegenerateNodeRequest'];
+      };
+    };
+    readonly responses: {
+      /** @description New version appended. */
+      readonly 200: {
+        headers: {
+          readonly [name: string]: unknown;
+        };
+        content: {
+          readonly 'application/json': components$1['schemas']['CreativeRegenerateNodeResult'];
+        };
+      };
+      /** @description Malformed body, not an image node (`invalid_request`), audio creative (`unsupported_kind`), filtered output (`content_filtered`, nothing charged). */
+      readonly 400: {
+        headers: {
+          readonly [name: string]: unknown;
+        };
+        content: {
+          readonly 'application/json': components$1['schemas']['CreativeError'];
+        };
+      };
+      readonly 401: components$1['responses']['Unauthorized'];
+      readonly 402: components$1['responses']['InsufficientFunds'];
+      readonly 404: components$1['responses']['NotFound'];
+      /** @description The creative changed since `base_seq` and the change overlaps (code `stale`). */
+      readonly 409: {
+        headers: {
+          readonly [name: string]: unknown;
+        };
+        content: {
+          readonly 'application/json': components$1['schemas']['CreativeError'];
+        };
+      };
+    };
+  };
   readonly applyCreativeOps: {
     readonly parameters: {
       readonly query?: never;
@@ -28956,6 +29445,79 @@ interface operations$1 {
       readonly 404: components$1['responses']['NotFound'];
     };
   };
+  readonly writeCreativePostCopy: {
+    readonly parameters: {
+      readonly query?: never;
+      readonly header?: {
+        /** @description Replays the stored response of an earlier request with the same key for 24 h instead of running it again. */
+        readonly 'Idempotency-Key'?: components$1['parameters']['IdempotencyKey'];
+        /** @description Client correlation id; echoed back as `x-codai-trace-id` and persisted on the usage row. */
+        readonly 'x-request-id'?: components$1['parameters']['RequestId'];
+      };
+      readonly path: {
+        /** @description Creative UUID. A malformed, unknown, deleted or foreign id is 404. */
+        readonly id: components$1['parameters']['CreativeId'];
+      };
+      readonly cookie?: never;
+    };
+    readonly requestBody?: {
+      readonly content: {
+        readonly 'application/json': components$1['schemas']['StudioPostCopyRequest'];
+      };
+    };
+    readonly responses: {
+      /** @description Post copy per platform, within each platform's limits. */
+      readonly 200: {
+        headers: {
+          readonly [name: string]: unknown;
+        };
+        content: {
+          readonly 'application/json': components$1['schemas']['StudioPostCopy'];
+        };
+      };
+      /** @description Invalid body (`invalid_request`), or a deck, doc, sheet, print or audio creative (`not_supported_for_kind`). */
+      readonly 400: {
+        headers: {
+          readonly [name: string]: unknown;
+        };
+        content: {
+          readonly 'application/json': components$1['schemas']['CreativeError'];
+        };
+      };
+      readonly 401: components$1['responses']['Unauthorized'];
+      readonly 402: components$1['responses']['InsufficientFunds'];
+      readonly 403: components$1['responses']['Forbidden'];
+      /** @description Unknown creative or `seq` (`not_found`). */
+      readonly 404: {
+        headers: {
+          readonly [name: string]: unknown;
+        };
+        content: {
+          readonly 'application/json': components$1['schemas']['CreativeError'];
+        };
+      };
+      /** @description The model answer could not be used (`no_post_copy`); only the turn that ran is billed. */
+      readonly 422: {
+        headers: {
+          readonly [name: string]: unknown;
+        };
+        content: {
+          readonly 'application/json': components$1['schemas']['CreativeError'];
+        };
+      };
+      readonly 429: components$1['responses']['RateLimited'];
+      readonly 502: components$1['responses']['UpstreamError'];
+      /** @description The turn did not finish within 60 s (`timeout`). */
+      readonly 504: {
+        headers: {
+          readonly [name: string]: unknown;
+        };
+        content: {
+          readonly 'application/json': components$1['schemas']['CreativeError'];
+        };
+      };
+    };
+  };
   readonly renderCreative: {
     readonly parameters: {
       readonly query?: never;
@@ -29562,6 +30124,56 @@ interface operations$1 {
       };
     };
   };
+  readonly transcriptCutCreative: {
+    readonly parameters: {
+      readonly query?: never;
+      readonly header?: {
+        /** @description Client correlation id; echoed back as `x-codai-trace-id` and persisted on the usage row. */
+        readonly 'x-request-id'?: components$1['parameters']['RequestId'];
+      };
+      readonly path: {
+        /** @description Creative UUID. A malformed, unknown, deleted or foreign id is 404. */
+        readonly id: components$1['parameters']['CreativeId'];
+      };
+      readonly cookie?: never;
+    };
+    readonly requestBody: {
+      readonly content: {
+        readonly 'application/json': components$1['schemas']['CreativeTranscriptCutRequest'];
+      };
+    };
+    readonly responses: {
+      /** @description New version appended. */
+      readonly 200: {
+        headers: {
+          readonly [name: string]: unknown;
+        };
+        content: {
+          readonly 'application/json': components$1['schemas']['CreativeTranscriptCutResult'];
+        };
+      };
+      /** @description Malformed body or word range (`invalid_request`), not a video node / creative (`unsupported_kind`), or the edit rejected by the engine (`invalid`, `locked`). */
+      readonly 400: {
+        headers: {
+          readonly [name: string]: unknown;
+        };
+        content: {
+          readonly 'application/json': components$1['schemas']['CreativeError'];
+        };
+      };
+      readonly 401: components$1['responses']['Unauthorized'];
+      readonly 404: components$1['responses']['NotFound'];
+      /** @description No cached transcript for the clip (`captions_required`, with `node_id`), or the creative changed since `base_seq` (`stale`). */
+      readonly 409: {
+        headers: {
+          readonly [name: string]: unknown;
+        };
+        content: {
+          readonly 'application/json': components$1['schemas']['CreativeError'];
+        };
+      };
+    };
+  };
   readonly listCreativeVariants: {
     readonly parameters: {
       readonly query?: never;
@@ -34213,6 +34825,8 @@ interface operations$1 {
           readonly model?: string;
           readonly negative_prompt?: string;
           readonly prompt: string;
+          /** @description Up to 3 of your ready PNG / JPEG image assets showing ONE subject (character or product) that Veo keeps consistent (Vertex `referenceImages`, `referenceType: asset`). Not combinable with `image`; always 8 s. A missing or foreign asset is 404, another type 400 — checked before anything is held or charged. */
+          readonly reference_asset_ids?: readonly string[];
           /** @enum {string} */
           readonly resolution?: '720p' | '1080p';
           /** @enum {integer} */
@@ -35557,6 +36171,12 @@ export interface VideoRequest {
     b64_json: string;
     mime_type?: 'image/png' | 'image/jpeg';
   };
+  /**
+   * Up to 3 of your ready PNG / JPEG Studio image assets showing ONE subject (character or product) that the model
+   * keeps consistent (e.g. a creative's cast `refAssetIds`). Not combinable with `image`; always 8 s. A missing or
+   * foreign asset is 404, another type 400 — checked before anything is held or charged.
+   */
+  reference_asset_ids?: string[];
   seed?: number;
 }
 export interface VideoJob {
@@ -36062,6 +36682,22 @@ export type CreativeTemplate = Schema<'CreativeTemplate'>;
 export type StudioCreativeFromDocument = Schema<'StudioCreativeFromDocument'>;
 export type CreativeBuildRequest = Mutable<Schema<'CreativeBuildRequest'>>;
 export type StudioCreativeBuild = Schema<'StudioCreativeBuild'>;
+/** Build request of a carousel (`format: 'png' | 'pdf'`) or print (`format: 'pdf'`) creative. */
+export type CreativePagedBuildRequest = Mutable<Schema<'CreativePagedBuildRequest'>>;
+/** HTTP 202 answer of `build` for a carousel / print creative: the queued export job is in `export`. */
+export type StudioCreativePagedBuild = Schema<'StudioCreativePagedBuild'>;
+export type CreativePrintLintIssue = Schema<'CreativePrintLintIssue'>;
+/** `build` answers a stored document version (200, deck / doc / sheet) or a queued export (202, carousel / print). */
+export type CreativeBuildResult = StudioCreativeBuild | StudioCreativePagedBuild;
+export type StudioPostCopyRequest = Mutable<Schema<'StudioPostCopyRequest'>>;
+export type StudioPostCopy = Schema<'StudioPostCopy'>;
+export type CreativeTranscriptCutRequest = Mutable<Schema<'CreativeTranscriptCutRequest'>>;
+export type CreativeTranscriptCutResult = Schema<'CreativeTranscriptCutResult'>;
+export type CreativeRegenerateNodeRequest = Mutable<Schema<'CreativeRegenerateNodeRequest'>>;
+export type CreativeRegenerateNodeResult = Schema<'CreativeRegenerateNodeResult'>;
+export type CreativeCast = Schema<'CreativeCast'>;
+/** True when a `build` answer is the 202 carousel / print export job (poll `exports.wait(r.export.id)`). */
+export declare const isPagedBuild: (r: CreativeBuildResult) => r is StudioCreativePagedBuild;
 /** `{ brand_kit_id }` or `{ tokens }` (exactly one) + optional `base_seq`, `snap`, `fonts`, `force`. */
 export type CreativeRestyleRequest = Mutable<Body<'restyleCreative'>>;
 /** Same shape as the `edit` answer (`seq`, `doc_hash`, `changed`, `warnings`, `rebased`). */
@@ -36276,8 +36912,45 @@ export declare class Creatives {
    * Studio document (`document`, exactly the `POST /v1/studio/documents` body). Converter notes come back in
    * `warnings`. The file is free; `preview: true` also queues a billed preview (poll it with
    * `documents.waitForPreview`). 400 `not_supported_for_kind` (video / image) or `invalid_spec`.
+   *
+   * A carousel (`format: 'png'` zip of slides or `'pdf'`) or print (`'pdf'`, PDF/X-4 with bleed and optional
+   * `crop_marks`) creative answers HTTP 202 with a queued export job in `export` (`format_id` picks the format,
+   * `quote_micro_usd` is held). Tell the two apart with `isPagedBuild`, poll with `exports.wait(r.export.id)` or use
+   * `buildAndWait`.
    */
-  build(id: string, body?: CreativeBuildRequest, opts?: CallOpts$28): Promise<StudioCreativeBuild>;
+  build(id: string, body?: CreativeBuildRequest | CreativePagedBuildRequest, opts?: CallOpts$28): Promise<CreativeBuildResult>;
+  /**
+   * `build`, then — for a carousel / print creative — poll the export job until it has `succeeded` or `failed`
+   * (`exports.wait`). Resolves to the 200 build for deck / doc / sheet, or to the finished `StudioExport`.
+   */
+  buildAndWait(id: string, body?: CreativeBuildRequest | CreativePagedBuildRequest, opts?: ExportWaitOptions): Promise<StudioCreativeBuild | StudioExport>;
+  /**
+   * Social post copy for a carousel, image or video creative: a caption + hashtags per platform (`platforms`,
+   * default Instagram + LinkedIn; `language` `ro` (default) | `en`; optional `brief`, `tone`, `seq`) and one alt text
+   * per slide, every answer repaired to the platform's hard limits (changes listed in `fixes`). Nothing is written to
+   * the creative. Token-metered (`cost_micro_usd`) under a small wallet hold (402 `insufficient_funds`); 400
+   * `not_supported_for_kind`, 422 `no_post_copy`, 504 `timeout`. `idempotencyKey` replays a retry (24 h).
+   */
+  postCopy(id: string, body?: StudioPostCopyRequest, opts?: CallOpts$28 & {
+    idempotencyKey?: string;
+  }): Promise<StudioPostCopy>;
+  /**
+   * Edit a video clip by its transcript: delete word ranges (`remove: [{ from_word, to_word }]`, indexes into the
+   * clip asset's cached transcript from `captions`) from video node `node_id`; the pieces are placed back to back as
+   * one new version (`base_seq` rebased like `edit`, locks honoured unless `force`). Free. 409 `captions_required`
+   * (run `captions` on that clip first) or `stale`; video creatives only.
+   */
+  transcriptCut(id: string, body: CreativeTranscriptCutRequest, opts?: CallOpts$28): Promise<CreativeTranscriptCutResult>;
+  /**
+   * Generate a new picture for an `image` node (`prompt`, optional `model`, `aspect_ratio` — default the closest
+   * ratio of the node box — `base_seq`, `force`) and swap it in as one new version. A node with a `castId` sends that
+   * cast entry's `refAssetIds` as references and appends its `description`, so the subject stays consistent. Billed
+   * like `images.generate` (402 `insufficient_funds`); 400 `content_filtered` charges nothing. `idempotencyKey`
+   * replays a retry (24 h).
+   */
+  regenerateNode(id: string, nodeId: string, body: CreativeRegenerateNodeRequest, opts?: CallOpts$28 & {
+    idempotencyKey?: string;
+  }): Promise<CreativeRegenerateNodeResult>;
   /**
    * Re-apply a brand kit (`brand_kit_id`) or a flat token map (`tokens`) to the creative as one new version: literal
    * colours equal to the old brand become token refs, `snap: true` maps every other colour to the nearest kit colour,
@@ -36497,6 +37170,12 @@ export interface MediaOpInput {
   assetIds?: string[];
   /** Per-op parameters (validated strictly by the gateway; see the docs table). */
   params?: Record<string, unknown>;
+  /**
+   * `image.inpaint` / `image.erase` only: a mask painted in an editor, base64 PNG (white = edit, black = keep, at most
+   * 8 MB). Send ONE asset id (the image); the gateway stores the mask as a free private asset and passes it as the
+   * second input. A quote validates it without storing anything.
+   */
+  maskPngB64?: string;
 }
 export interface MediaOpRunOptions extends CallOpts$24 {
   /** `Idempotency-Key`: a retry with the same key replays the first answer instead of running (and billing) again. */