@graph8/sdk 0.251.0 → 0.260.0

package/docs/api/adCreatives.md

@@ -0,0 +1,1708 @@
+<!-- Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. -->
+
+# `g8.api.adCreatives`: Ad Creatives
+
+40 operations (10 read, 11 write, 2 destructive, 17 billable).
+
+No hand-written client covers this area. Call it through `g8.api.adCreatives.*` as shown below, or by operationId with `g8.api.call(operationId, input)`.
+
+Every example below assumes this setup (server-side, API key):
+
+```ts
+import { g8 } from "@graph8/sdk";
+
+g8.init({ apiKey: process.env.G8_API_KEY! });
+```
+
+Example values are placeholders that match each field's type. Only required fields are shown. Every example is type-checked against the SDK in CI.
+
+Exact TypeScript types for every operation on this page, and every schema they use: [adCreatives.d.ts](adCreatives.d.ts).
+
+## Operations
+
+| Call | HTTP | Tier | Scope | Summary |
+|---|---|---|---|---|
+| [`applyAdCreativeReviewFindings`](#op-applyadcreativereviewfindings) | `POST /api/v1/ad-creatives/{creative_id}/ai-review/apply` | write | `campaigns:write` | Apply Ad Creative Review Findings |
+| [`chatEditAdCreative`](#op-chateditadcreative) | `POST /api/v1/ad-creatives/{creative_id}/chat-edit` | billable | `campaigns:run` | Chat Edit Ad Creative |
+| [`continueVideoClip`](#op-continuevideoclip) | `POST /api/v1/ad-creatives/video/clips/{clip_id}/continue` | billable | `campaigns:run` | Continue Video Clip |
+| [`createAdCreative`](#op-createadcreative) | `POST /api/v1/ad-creatives` | billable | `campaigns:run` | Create Ad Creative |
+| [`createAdCreativeSet`](#op-createadcreativeset) | `POST /api/v1/ad-creatives/batch` | billable | `campaigns:run` | Create Ad Creative Set |
+| [`createAdCreativeSizeSet`](#op-createadcreativesizeset) | `POST /api/v1/ad-creatives/{creative_id}/size-set` | billable | `campaigns:run` | Create Ad Creative Size Set |
+| [`createVideoAdCreative`](#op-createvideoadcreative) | `POST /api/v1/ad-creatives/video` | write | `campaigns:write` | Create Video Ad Creative |
+| [`deleteAdCreative`](#op-deleteadcreative) | `DELETE /api/v1/ad-creatives/{creative_id}` | destructive | `campaigns:delete` | Delete Ad Creative |
+| [`discardVideoClip`](#op-discardvideoclip) | `DELETE /api/v1/ad-creatives/video/clips/{clip_id}` | destructive | `campaigns:delete` | Discard Video Clip |
+| [`editAdCreativeImageAtPoint`](#op-editadcreativeimageatpoint) | `POST /api/v1/ad-creatives/{creative_id}/image-edit-at-point` | billable | `campaigns:run` | Edit Ad Creative Image At Point |
+| [`editAdCreativeImageElement`](#op-editadcreativeimageelement) | `POST /api/v1/ad-creatives/{creative_id}/image-element` | write | `campaigns:write` | Edit Ad Creative Image Element |
+| [`enhanceVideoClipPrompt`](#op-enhancevideoclipprompt) | `POST /api/v1/ad-creatives/video/clips/prompt-enhance` | billable | `campaigns:run` | Enhance Video Clip Prompt |
+| [`extendVideoClip`](#op-extendvideoclip) | `POST /api/v1/ad-creatives/video/clips/{clip_id}/extend` | billable | `campaigns:run` | Extend Video Clip |
+| [`generateAdConcepts`](#op-generateadconcepts) | `POST /api/v1/ad-creatives/concepts` | billable | `campaigns:run` | Generate Ad Concepts |
+| [`generateVideoClip`](#op-generatevideoclip) | `POST /api/v1/ad-creatives/video/clips` | billable | `campaigns:run` | Generate Video Clip |
+| [`getAdCreative`](#op-getadcreative) | `GET /api/v1/ad-creatives/{creative_id}` | read | `campaigns:read` | Get Ad Creative |
+| [`getAdCreativeConversation`](#op-getadcreativeconversation) | `GET /api/v1/ad-creatives/{creative_id}/conversation` | read | `campaigns:read` | Get Ad Creative Conversation |
+| [`getAdCreativeSpecs`](#op-getadcreativespecs) | `GET /api/v1/ad-creatives/specs` | read | `campaigns:read` | Get Ad Creative Specs |
+| [`getAdCreativeStatus`](#op-getadcreativestatus) | `GET /api/v1/ad-creatives/{creative_id}/status` | read | `campaigns:read` | Get Ad Creative Status |
+| [`getVideoClip`](#op-getvideoclip) | `GET /api/v1/ad-creatives/video/clips/{clip_id}` | read | `campaigns:read` | Get Video Clip |
+| [`listAdCreativeImageElements`](#op-listadcreativeimageelements) | `GET /api/v1/ad-creatives/{creative_id}/image-elements` | read | `campaigns:read` | List Ad Creative Image Elements |
+| [`listAdCreativeRevisions`](#op-listadcreativerevisions) | `GET /api/v1/ad-creatives/{creative_id}/revisions` | read | `campaigns:read` | List Ad Creative Revisions |
+| [`listAdCreatives`](#op-listadcreatives) | `GET /api/v1/ad-creatives` | read | `campaigns:read` | List Ad Creatives |
+| [`listVideoAdTemplates`](#op-listvideoadtemplates) | `GET /api/v1/ad-creatives/video-templates` | read | `campaigns:read` | List Video Ad Templates |
+| [`listVideoClips`](#op-listvideoclips) | `GET /api/v1/ad-creatives/video/clips` | read | `campaigns:read` | List Video Clips |
+| [`moveAdCreativeToDraft`](#op-moveadcreativetodraft) | `POST /api/v1/ad-creatives/{creative_id}/move-to-draft` | write | `campaigns:write` | Move Ad Creative To Draft |
+| [`moveAdCreativeToGallery`](#op-moveadcreativetogallery) | `POST /api/v1/ad-creatives/{creative_id}/move-to-gallery` | write | `campaigns:write` | Move Ad Creative To Gallery |
+| [`readAdCreativeThroughPersona`](#op-readadcreativethroughpersona) | `POST /api/v1/ad-creatives/{creative_id}/persona-lens` | billable | `campaigns:run` | Read Ad Creative Through Persona |
+| [`regenerateAdCreativeCopy`](#op-regenerateadcreativecopy) | `POST /api/v1/ad-creatives/{creative_id}/regenerate-copy` | billable | `campaigns:run` | Regenerate Ad Creative Copy |
+| [`regenerateAdCreativeImage`](#op-regenerateadcreativeimage) | `POST /api/v1/ad-creatives/{creative_id}/regenerate-image` | billable | `campaigns:run` | Regenerate Ad Creative Image |
+| [`regenerateVideoClip`](#op-regeneratevideoclip) | `POST /api/v1/ad-creatives/video/clips/{clip_id}/regenerate` | billable | `campaigns:run` | Regenerate Video Clip |
+| [`reskinAdCreative`](#op-reskinadcreative) | `POST /api/v1/ad-creatives/{creative_id}/reskin` | write | `campaigns:write` | Reskin Ad Creative |
+| [`restoreAdCreativeRevision`](#op-restoreadcreativerevision) | `POST /api/v1/ad-creatives/{creative_id}/restore-revision` | write | `campaigns:write` | Restore Ad Creative Revision |
+| [`retryAdCreativeGeneration`](#op-retryadcreativegeneration) | `POST /api/v1/ad-creatives/{creative_id}/retry` | billable | `campaigns:run` | Retry Ad Creative Generation |
+| [`reviewAdCreative`](#op-reviewadcreative) | `POST /api/v1/ad-creatives/{creative_id}/ai-review` | billable | `campaigns:run` | Review Ad Creative |
+| [`rewriteAdCreativeField`](#op-rewriteadcreativefield) | `POST /api/v1/ad-creatives/{creative_id}/rewrite-field` | billable | `campaigns:run` | Rewrite Ad Creative Field |
+| [`saveAdCreativeAsTemplate`](#op-saveadcreativeastemplate) | `POST /api/v1/ad-creatives/{creative_id}/save-as-template` | write | `campaigns:write` | Save Ad Creative As Template |
+| [`setAdCreativeImage`](#op-setadcreativeimage) | `POST /api/v1/ad-creatives/{creative_id}/set-image` | write | `campaigns:write` | Set Ad Creative Image |
+| [`setAdCreativeImageFocus`](#op-setadcreativeimagefocus) | `POST /api/v1/ad-creatives/{creative_id}/set-image-focus` | write | `campaigns:write` | Set Ad Creative Image Focus |
+| [`updateAdCreative`](#op-updateadcreative) | `PATCH /api/v1/ad-creatives/{creative_id}` | write | `campaigns:write` | Update Ad Creative |
+
+---
+
+<a id="op-applyadcreativereviewfindings"></a>
+
+### `g8.api.adCreatives.applyAdCreativeReviewFindings(input)`
+
+**Apply Ad Creative Review Findings**
+
+- HTTP: `POST /api/v1/ad-creatives/{creative_id}/ai-review/apply`
+- operationId: `apply_ad_creative_review_findings_ad_creatives__creative_id__ai_review_apply_post` (also callable as `g8.api.call("apply_ad_creative_review_findings_ad_creatives__creative_id__ai_review_apply_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Apply review findings DETERMINISTICALLY. FREE - no model runs.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.creative_id` | `string` | yes | Ad creative id. |
+| `body` | `ApplyFindingsRequest` | yes | Request body; fields below. |
+
+Body fields (`ApplyFindingsRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.finding_ids` | `Array<string>` | yes |  |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.adCreatives.applyAdCreativeReviewFindings({ path: { creative_id: "id" }, body: { finding_ids: ["id"] } });
+```
+
+---
+
+<a id="op-chateditadcreative"></a>
+
+### `g8.api.adCreatives.chatEditAdCreative(input)`
+
+**Chat Edit Ad Creative**
+
+- HTTP: `POST /api/v1/ad-creatives/{creative_id}/chat-edit`
+- operationId: `chat_edit_ad_creative_ad_creatives__creative_id__chat_edit_post` (also callable as `g8.api.call("chat_edit_ad_creative_ad_creatives__creative_id__chat_edit_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Edit the creative with a natural-language instruction. SPENDS CREDIT.
+
+A model rewrites the copy (and, when asked, the image); the previous state
+is snapshotted first, so `/restore-revision` can undo it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.creative_id` | `string` | yes | Ad creative id. |
+| `body` | `AdCreativeChatEditRequest` | yes | Request body; fields below. |
+
+Body fields (`AdCreativeChatEditRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.instruction` | `string` | yes | max length 2000 |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.adCreatives.chatEditAdCreative({ path: { creative_id: "id" }, body: { instruction: "example" } });
+```
+
+---
+
+<a id="op-continuevideoclip"></a>
+
+### `g8.api.adCreatives.continueVideoClip(input)`
+
+**Continue Video Clip**
+
+- HTTP: `POST /api/v1/ad-creatives/video/clips/{clip_id}/continue`
+- operationId: `continue_video_clip_ad_creatives_video_clips__clip_id__continue_post` (also callable as `g8.api.call("continue_video_clip_ad_creatives_video_clips__clip_id__continue_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Generate the NEXT shot from this clip's last frame, with a new prompt. SPENDS CREDIT.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.clip_id` | `string` | yes | Video clip id. |
+| `body` | `ContinueVideoClipRequest` | yes | Request body; fields below. |
+
+Body fields (`ContinueVideoClipRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.prompt_inputs` | `VideoClipPromptInputs` | yes |  |
+| `body.duration_seconds` | `4 \| 6 \| 8` | no | default `8` |
+| `body.prompt_final` | `string \| null` | no | max length 1000 |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.adCreatives.continueVideoClip({
+  path: { clip_id: "id" },
+  body: { prompt_inputs: { subject: "Example" } },
+});
+```
+
+---
+
+<a id="op-createadcreative"></a>
+
+### `g8.api.adCreatives.createAdCreative(input)`
+
+**Create Ad Creative**
+
+- HTTP: `POST /api/v1/ad-creatives`
+- operationId: `create_ad_creative_ad_creatives_post` (also callable as `g8.api.call("create_ad_creative_ad_creatives_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Generate an ad creative. SPENDS CREDIT - a copy pass and an image pass.
+
+ASYNCHRONOUS: the row is committed as `generating` and returned
+immediately; the copy and the image land afterwards. Poll
+`GET /ad-creatives/{id}` until its status settles.
+
+`image_source: "library"` with a `library_image_id` skips the image pass
+and is materially cheaper. `image_source: "ai"` is the default and is what
+the cost of this call mostly is.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `CreateAdCreativeRequest` | yes | Request body; fields below. |
+
+Body fields (`CreateAdCreativeRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.ad_format` | `string` | yes |  |
+| `body.platform` | `string` | yes |  |
+| `body.campaign_id` | `string \| null` | no |  |
+| `body.image_source` | `string` | no | 'ai' generates an image; 'library' reuses one. default `"ai"` |
+| `body.library_image_id` | `string \| null` | no |  |
+| `body.name` | `string \| null` | no |  |
+| `body.prompt` | `string \| null` | no | max length 2000 |
+| `body.reference_image_ids` | `Array<string> \| null` | no |  |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.adCreatives.createAdCreative({ body: { ad_format: "example", platform: "example" } });
+```
+
+---
+
+<a id="op-createadcreativeset"></a>
+
+### `g8.api.adCreatives.createAdCreativeSet(input)`
+
+**Create Ad Creative Set**
+
+- HTTP: `POST /api/v1/ad-creatives/batch`
+- operationId: `create_ad_creative_set_ad_creatives_batch_post` (also callable as `g8.api.call("create_ad_creative_set_ad_creatives_batch_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Generate a persona x platform matrix of creatives. SPENDS CREDIT, per cell.
+
+Up to 24 full creatives (copy pass + image pass each) in one call - the
+largest spend on this router. Every row is committed as `generating`
+before any generation starts; poll each creative's `/status`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `CreateAdCreativeSetRequest` | yes | Request body; fields below. |
+
+Body fields (`CreateAdCreativeSetRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.personas` | `Array<CampaignSetPersona>` | yes | min items 1, max items 6 |
+| `body.platforms` | `Array<string>` | yes | min items 1, max items 4 |
+| `body.brief` | `string \| null` | no | max length 2000 |
+| `body.formats` | `Record<string, unknown> \| null` | no | Platform -> ad_format override. Omit for each platform's default. |
+| `body.image_source` | `"ai"` | no | default `"ai"` |
+| `body.variants_per_cell` | `integer` | no | default `1`, min 1, max 3 |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.adCreatives.createAdCreativeSet({ body: { personas: [{ title: "Example" }], platforms: ["example"] } });
+```
+
+---
+
+<a id="op-createadcreativesizeset"></a>
+
+### `g8.api.adCreatives.createAdCreativeSizeSet(input)`
+
+**Create Ad Creative Size Set**
+
+- HTTP: `POST /api/v1/ad-creatives/{creative_id}/size-set`
+- operationId: `create_ad_creative_size_set_ad_creatives__creative_id__size_set_post` (also callable as `g8.api.call("create_ad_creative_size_set_ad_creatives__creative_id__size_set_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Fan one creative out into the platform's other formats. SPENDS CREDIT.
+
+ONE PASS PER FORMAT, so the cost scales with how many you ask for. Copy is
+locked verbatim; only the layout and the crop change. Omit `formats` and
+you get the platform's FULL set, which is the most expensive call on this
+router - name the formats you actually need.
+
+Asynchronous: the rows appear immediately and fill in afterwards.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.creative_id` | `string` | yes | Ad creative id. |
+| `body` | `SizeSetRequest \| null` | no | Request body; fields below. |
+
+Body fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.formats` | `Array<string> \| null` | no | max items 8 |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.adCreatives.createAdCreativeSizeSet({ path: { creative_id: "id" } });
+```
+
+---
+
+<a id="op-createvideoadcreative"></a>
+
+### `g8.api.adCreatives.createVideoAdCreative(input)`
+
+**Create Video Ad Creative**
+
+- HTTP: `POST /api/v1/ad-creatives/video`
+- operationId: `create_video_ad_creative_ad_creatives_video_post` (also callable as `g8.api.call("create_video_ad_creative_ad_creatives_video_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Assemble generated clips into a video ad on a template. FREE.
+
+The footage was paid for when each clip was generated; this renders the
+storyboard (1-5 shots) and the template's copy slots into one creative.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `CreateVideoCreativeRequest` | yes | Request body; fields below. |
+
+Body fields (`CreateVideoCreativeRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.storyboard` | `VideoStoryboard` | yes |  |
+| `body.template_id` | `string` | yes | min length 1, max length 40 |
+| `body.campaign_id` | `string \| null` | no |  |
+| `body.name` | `string \| null` | no | max length 200 |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.adCreatives.createVideoAdCreative({ body: { storyboard: {}, template_id: "id" } });
+```
+
+---
+
+<a id="op-deleteadcreative"></a>
+
+### `g8.api.adCreatives.deleteAdCreative(input)`
+
+**Delete Ad Creative**
+
+- HTTP: `DELETE /api/v1/ad-creatives/{creative_id}`
+- operationId: `delete_ad_creative_ad_creatives__creative_id__delete` (also callable as `g8.api.call("delete_ad_creative_ad_creatives__creative_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `campaigns:delete`
+
+Delete a creative and its revisions.
+
+`ads:edit`, not `ads:delete` - the app's own gate, kept rather than
+invented, because inventing a stricter one here would refuse callers the
+app accepts.
+
+Spends nothing.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.creative_id` | `string` | yes | Ad creative id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.adCreatives.deleteAdCreative({ path: { creative_id: "id" } });
+```
+
+---
+
+<a id="op-discardvideoclip"></a>
+
+### `g8.api.adCreatives.discardVideoClip(input)`
+
+**Discard Video Clip**
+
+- HTTP: `DELETE /api/v1/ad-creatives/video/clips/{clip_id}`
+- operationId: `discard_video_clip_ad_creatives_video_clips__clip_id__delete` (also callable as `g8.api.call("discard_video_clip_ad_creatives_video_clips__clip_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `campaigns:delete`
+
+Discard a clip. FREE, and NOT a refund - the footage was already paid for.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.clip_id` | `string` | yes | Video clip id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.adCreatives.discardVideoClip({ path: { clip_id: "id" } });
+```
+
+---
+
+<a id="op-editadcreativeimageatpoint"></a>
+
+### `g8.api.adCreatives.editAdCreativeImageAtPoint(input)`
+
+**Edit Ad Creative Image At Point**
+
+- HTTP: `POST /api/v1/ad-creatives/{creative_id}/image-edit-at-point`
+- operationId: `edit_ad_creative_image_at_point_ad_creatives__creative_id__image_edit_at_point_post` (also callable as `g8.api.call("edit_ad_creative_image_at_point_ad_creatives__creative_id__image_edit_at_point_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Pin a point on the image and say what changes there. SPENDS CREDIT.
+
+An image model runs. `/image-element` is the free, deterministic way to
+change TEXT in the image - reach for that first.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.creative_id` | `string` | yes | Ad creative id. |
+| `body` | `ImagePointEditRequest` | yes | Request body; fields below. |
+
+Body fields (`ImagePointEditRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.instruction` | `string` | yes | min length 1, max length 500 |
+| `body.x` | `number` | yes | min 0, max 100000 |
+| `body.y` | `number` | yes | min 0, max 100000 |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.adCreatives.editAdCreativeImageAtPoint({
+  path: { creative_id: "id" },
+  body: { instruction: "example", x: 0, y: 0 },
+});
+```
+
+---
+
+<a id="op-editadcreativeimageelement"></a>
+
+### `g8.api.adCreatives.editAdCreativeImageElement(input)`
+
+**Edit Ad Creative Image Element**
+
+- HTTP: `POST /api/v1/ad-creatives/{creative_id}/image-element`
+- operationId: `edit_ad_creative_image_element_ad_creatives__creative_id__image_element_post` (also callable as `g8.api.call("edit_ad_creative_image_element_ad_creatives__creative_id__image_element_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Change one text element in the image. FREE - no model runs.
+
+Deterministic: it rewrites the SVG. Send at least one of `text`, `fill` or
+`font_size`; `index` comes from `GET /{id}/image-elements`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.creative_id` | `string` | yes | Ad creative id. |
+| `body` | `EditImageElementRequest` | yes | Request body; fields below. |
+
+Body fields (`EditImageElementRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.index` | `integer` | yes | min 0 |
+| `body.fill` | `string \| null` | no | pattern `^#(?:[0-9a-fA-F]{3}\|[0-9a-fA-F]{4}\|[0-9a-fA-F]{6}\|[0-9a-fA-F]{8})$` |
+| `body.font_size` | `integer \| null` | no | min 8, max 120 |
+| `body.text` | `string \| null` | no | min length 1, max length 300 |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.adCreatives.editAdCreativeImageElement({ path: { creative_id: "id" }, body: { index: 0 } });
+```
+
+---
+
+<a id="op-enhancevideoclipprompt"></a>
+
+### `g8.api.adCreatives.enhanceVideoClipPrompt(input)`
+
+**Enhance Video Clip Prompt**
+
+- HTTP: `POST /api/v1/ad-creatives/video/clips/prompt-enhance`
+- operationId: `enhance_video_clip_prompt_ad_creatives_video_clips_prompt_enhance_post` (also callable as `g8.api.call("enhance_video_clip_prompt_ad_creatives_video_clips_prompt_enhance_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Write one generation prompt from the structured shot form. SPENDS CREDIT (small).
+
+A model rewrites the form into the prompt `POST /ad-creatives/video/clips`
+takes as `prompt_final`; the response carries `credits_charged`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `VideoPromptEnhanceRequest` | yes | Request body; fields below. |
+
+Body fields (`VideoPromptEnhanceRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.prompt_inputs` | `VideoClipPromptInputs` | yes |  |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.adCreatives.enhanceVideoClipPrompt({ body: { prompt_inputs: { subject: "Example" } } });
+```
+
+---
+
+<a id="op-extendvideoclip"></a>
+
+### `g8.api.adCreatives.extendVideoClip(input)`
+
+**Extend Video Clip**
+
+- HTTP: `POST /api/v1/ad-creatives/video/clips/{clip_id}/extend`
+- operationId: `extend_video_clip_ad_creatives_video_clips__clip_id__extend_post` (also callable as `g8.api.call("extend_video_clip_ad_creatives_video_clips__clip_id__extend_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Generate more footage continuing this clip. SPENDS CREDIT - priced per added second.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.clip_id` | `string` | yes | Video clip id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.adCreatives.extendVideoClip({ path: { clip_id: "id" } });
+```
+
+---
+
+<a id="op-generateadconcepts"></a>
+
+### `g8.api.adCreatives.generateAdConcepts(input)`
+
+**Generate Ad Concepts**
+
+- HTTP: `POST /api/v1/ad-creatives/concepts`
+- operationId: `generate_ad_concepts_ad_creatives_concepts_post` (also callable as `g8.api.call("generate_ad_concepts_ad_creatives_concepts_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Three to six creative DIRECTIONS to react to. SPENDS CREDIT - one pass.
+
+Stateless: nothing is persisted, and no creative is generated. This is the
+cheap step to take BEFORE `POST /ad-creatives`, which spends a copy pass
+and an image pass per creative - reacting to four directions here costs a
+fraction of generating four ads and discarding three.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `ConceptsRequest` | yes | Request body; fields below. |
+
+Body fields (`ConceptsRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.brief` | `string \| null` | no | max length 2000 |
+| `body.count` | `integer` | no | default `4`, min 3, max 6 |
+
+**Returns** `ApiResponse_StudioContentListPayload_`: the envelope `{ data: StudioContentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`StudioContentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.adCreatives.generateAdConcepts({ body: {} });
+```
+
+---
+
+<a id="op-generatevideoclip"></a>
+
+### `g8.api.adCreatives.generateVideoClip(input)`
+
+**Generate Video Clip**
+
+- HTTP: `POST /api/v1/ad-creatives/video/clips`
+- operationId: `generate_video_clip_ad_creatives_video_clips_post` (also callable as `g8.api.call("generate_video_clip_ad_creatives_video_clips_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Generate one video clip. SPENDS CREDIT - priced per second of footage.
+
+ASYNCHRONOUS: the clip is queued and returned at once; poll
+`GET /ad-creatives/video/clips/{clip_id}`. An org can have only a few
+clips generating at a time - over that cap is a 429.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `GenerateVideoClipRequest` | yes | Request body; fields below. |
+
+Body fields (`GenerateVideoClipRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.prompt_inputs` | `VideoClipPromptInputs` | yes |  |
+| `body.aspect_ratio` | `"16:9" \| "9:16"` | no | default `"16:9"` |
+| `body.creative_id` | `string \| null` | no |  |
+| `body.duration_seconds` | `4 \| 6 \| 8` | no | default `8` |
+| `body.prompt_final` | `string \| null` | no | max length 1000 |
+| `body.reference_image_urls` | `Array<string>` | no | max items 3 |
+| `body.start_image_url` | `string \| null` | no | max length 2000 |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.adCreatives.generateVideoClip({ body: { prompt_inputs: { subject: "Example" } } });
+```
+
+---
+
+<a id="op-getadcreative"></a>
+
+### `g8.api.adCreatives.getAdCreative(input)`
+
+**Get Ad Creative**
+
+- HTTP: `GET /api/v1/ad-creatives/{creative_id}`
+- operationId: `get_ad_creative_ad_creatives__creative_id__get` (also callable as `g8.api.call("get_ad_creative_ad_creatives__creative_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+One creative, with its copy, its image and its generation status. FREE.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.creative_id` | `string` | yes | Ad creative id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.adCreatives.getAdCreative({ path: { creative_id: "id" } });
+```
+
+---
+
+<a id="op-getadcreativeconversation"></a>
+
+### `g8.api.adCreatives.getAdCreativeConversation(input)`
+
+**Get Ad Creative Conversation**
+
+- HTTP: `GET /api/v1/ad-creatives/{creative_id}/conversation`
+- operationId: `get_ad_creative_conversation_ad_creatives__creative_id__conversation_get` (also callable as `g8.api.call("get_ad_creative_conversation_ad_creatives__creative_id__conversation_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+The chat-edit conversation recorded against this creative. FREE.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.creative_id` | `string` | yes | Ad creative id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.adCreatives.getAdCreativeConversation({ path: { creative_id: "id" } });
+```
+
+---
+
+<a id="op-getadcreativespecs"></a>
+
+### `g8.api.adCreatives.getAdCreativeSpecs(input?)`
+
+**Get Ad Creative Specs**
+
+- HTTP: `GET /api/v1/ad-creatives/specs`
+- operationId: `get_ad_creative_specs_ad_creatives_specs_get` (also callable as `g8.api.call("get_ad_creative_specs_ad_creatives_specs_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+Every platform and ad format the generator supports. FREE.
+
+The SOURCE of the `platform` / `ad_format` values `POST /ad-creatives`
+accepts, and of the `formats` list `/size-set` takes. Read it first: an
+invented format is rejected inside the service, after the request has
+already been accepted.
+
+**Input**: none.
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.adCreatives.getAdCreativeSpecs();
+```
+
+---
+
+<a id="op-getadcreativestatus"></a>
+
+### `g8.api.adCreatives.getAdCreativeStatus(input)`
+
+**Get Ad Creative Status**
+
+- HTTP: `GET /api/v1/ad-creatives/{creative_id}/status`
+- operationId: `get_ad_creative_status_ad_creatives__creative_id__status_get` (also callable as `g8.api.call("get_ad_creative_status_ad_creatives__creative_id__status_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+Just the generation status of one creative. FREE - the cheap poll target.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.creative_id` | `string` | yes | Ad creative id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.adCreatives.getAdCreativeStatus({ path: { creative_id: "id" } });
+```
+
+---
+
+<a id="op-getvideoclip"></a>
+
+### `g8.api.adCreatives.getVideoClip(input)`
+
+**Get Video Clip**
+
+- HTTP: `GET /api/v1/ad-creatives/video/clips/{clip_id}`
+- operationId: `get_video_clip_ad_creatives_video_clips__clip_id__get` (also callable as `g8.api.call("get_video_clip_ad_creatives_video_clips__clip_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+One clip and its generation status. FREE - the poll target for clip generation.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.clip_id` | `string` | yes | Video clip id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.adCreatives.getVideoClip({ path: { clip_id: "id" } });
+```
+
+---
+
+<a id="op-listadcreativeimageelements"></a>
+
+### `g8.api.adCreatives.listAdCreativeImageElements(input)`
+
+**List Ad Creative Image Elements**
+
+- HTTP: `GET /api/v1/ad-creatives/{creative_id}/image-elements`
+- operationId: `list_ad_creative_image_elements_ad_creatives__creative_id__image_elements_get` (also callable as `g8.api.call("list_ad_creative_image_elements_ad_creatives__creative_id__image_elements_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+Every editable text element inside the image, with its geometry. FREE.
+
+The SOURCE of the `index` that `POST /{id}/image-element` takes. The
+indices are positional and a regenerate reshuffles them, so re-read this
+after any call that changes the image.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.creative_id` | `string` | yes | Ad creative id. |
+
+**Returns** `ApiResponse_StudioContentListPayload_`: the envelope `{ data: StudioContentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`StudioContentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.adCreatives.listAdCreativeImageElements({ path: { creative_id: "id" } });
+```
+
+---
+
+<a id="op-listadcreativerevisions"></a>
+
+### `g8.api.adCreatives.listAdCreativeRevisions(input)`
+
+**List Ad Creative Revisions**
+
+- HTTP: `GET /api/v1/ad-creatives/{creative_id}/revisions`
+- operationId: `list_ad_creative_revisions_ad_creatives__creative_id__revisions_get` (also callable as `g8.api.call("list_ad_creative_revisions_ad_creatives__creative_id__revisions_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+The creative's snapshots. FREE - the `index` values restore takes.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.creative_id` | `string` | yes | Ad creative id. |
+
+**Returns** `ApiResponse_StudioContentListPayload_`: the envelope `{ data: StudioContentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`StudioContentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.adCreatives.listAdCreativeRevisions({ path: { creative_id: "id" } });
+```
+
+---
+
+<a id="op-listadcreatives"></a>
+
+### `g8.api.adCreatives.listAdCreatives(input?)`
+
+**List Ad Creatives**
+
+- HTTP: `GET /api/v1/ad-creatives`
+- operationId: `list_ad_creatives_ad_creatives_get` (also callable as `g8.api.call("list_ad_creatives_ad_creatives_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+The org's ad creatives. FREE.
+
+`templates=true` switches the collection entirely: it returns the reusable
+templates, not a filtered view of the working creatives. The two sets do
+not overlap.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.status` | `string \| null` | no | Filter by status. |
+| `query.platform` | `string \| null` | no | Filter to one platform. |
+| `query.ad_format` | `string \| null` | no | Filter to one format - landscape, square, portrait, ... |
+| `query.templates` | `boolean` | no | List reusable TEMPLATES instead of working creatives. default `false` |
+| `query.limit` | `integer` | no | default `50` |
+| `query.offset` | `integer` | no | default `0` |
+
+**Returns** `ApiResponse_StudioContentListPayload_`: the envelope `{ data: StudioContentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`StudioContentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.adCreatives.listAdCreatives();
+```
+
+---
+
+<a id="op-listvideoadtemplates"></a>
+
+### `g8.api.adCreatives.listVideoAdTemplates(input?)`
+
+**List Video Ad Templates**
+
+- HTTP: `GET /api/v1/ad-creatives/video-templates`
+- operationId: `list_video_ad_templates_ad_creatives_video_templates_get` (also callable as `g8.api.call("list_video_ad_templates_ad_creatives_video_templates_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+The video ad templates. FREE - the valid `template_id` values for `POST /ad-creatives/video`.
+
+**Input**: none.
+
+**Returns** `ApiResponse_StudioContentListPayload_`: the envelope `{ data: StudioContentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`StudioContentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.adCreatives.listVideoAdTemplates();
+```
+
+---
+
+<a id="op-listvideoclips"></a>
+
+### `g8.api.adCreatives.listVideoClips(input?)`
+
+**List Video Clips**
+
+- HTTP: `GET /api/v1/ad-creatives/video/clips`
+- operationId: `list_video_clips_ad_creatives_video_clips_get` (also callable as `g8.api.call("list_video_clips_ad_creatives_video_clips_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+The org's generated video clips. FREE.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.creative_id` | `string \| null` | no | Only the clips attached to this creative. |
+| `query.include_discarded` | `boolean` | no | Include clips you discarded. default `false` |
+
+**Returns** `ApiResponse_StudioContentListPayload_`: the envelope `{ data: StudioContentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`StudioContentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.adCreatives.listVideoClips();
+```
+
+---
+
+<a id="op-moveadcreativetodraft"></a>
+
+### `g8.api.adCreatives.moveAdCreativeToDraft(input)`
+
+**Move Ad Creative To Draft**
+
+- HTTP: `POST /api/v1/ad-creatives/{creative_id}/move-to-draft`
+- operationId: `move_ad_creative_to_draft_ad_creatives__creative_id__move_to_draft_post` (also callable as `g8.api.call("move_ad_creative_to_draft_ad_creatives__creative_id__move_to_draft_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Take the creative back out of the gallery. Inverse of move-to-gallery.
+
+Spends nothing.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.creative_id` | `string` | yes | Ad creative id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.adCreatives.moveAdCreativeToDraft({ path: { creative_id: "id" } });
+```
+
+---
+
+<a id="op-moveadcreativetogallery"></a>
+
+### `g8.api.adCreatives.moveAdCreativeToGallery(input)`
+
+**Move Ad Creative To Gallery**
+
+- HTTP: `POST /api/v1/ad-creatives/{creative_id}/move-to-gallery`
+- operationId: `move_ad_creative_to_gallery_ad_creatives__creative_id__move_to_gallery_post` (also callable as `g8.api.call("move_ad_creative_to_gallery_ad_creatives__creative_id__move_to_gallery_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Move the creative out of drafts and into the GALLERY.
+
+`ads:launch`, which the app's own permission table marks CRITICAL - the
+gallery is what the ad-platform surface picks from, so this is the step
+that makes a creative eligible to go live and start spending the
+customer's advertising budget. Everything else on this router is
+`ads:view` / `ads:create` / `ads:edit`.
+
+`/move-to-draft` is the inverse and needs only `ads:edit`, matching the
+app: taking a creative back out of the gallery is not the consequential
+direction.
+
+Spends nothing.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.creative_id` | `string` | yes | Ad creative id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.adCreatives.moveAdCreativeToGallery({ path: { creative_id: "id" } });
+```
+
+---
+
+<a id="op-readadcreativethroughpersona"></a>
+
+### `g8.api.adCreatives.readAdCreativeThroughPersona(input)`
+
+**Read Ad Creative Through Persona**
+
+- HTTP: `POST /api/v1/ad-creatives/{creative_id}/persona-lens`
+- operationId: `read_ad_creative_through_persona_ad_creatives__creative_id__persona_lens_post` (also callable as `g8.api.call("read_ad_creative_through_persona_ad_creatives__creative_id__persona_lens_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Critique the ad through a buyer persona's eyes. SPENDS CREDIT.
+
+READ-ONLY against the creative - it returns a critique and changes
+nothing - but a model runs, so it still costs. That is why it is not
+tiered as a read.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.creative_id` | `string` | yes | Ad creative id. |
+| `body` | `PersonaLensRequest` | yes | Request body; fields below. |
+
+Body fields (`PersonaLensRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.persona` | `CampaignSetPersona` | yes |  |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.adCreatives.readAdCreativeThroughPersona({
+  path: { creative_id: "id" },
+  body: { persona: { title: "Example" } },
+});
+```
+
+---
+
+<a id="op-regenerateadcreativecopy"></a>
+
+### `g8.api.adCreatives.regenerateAdCreativeCopy(input)`
+
+**Regenerate Ad Creative Copy**
+
+- HTTP: `POST /api/v1/ad-creatives/{creative_id}/regenerate-copy`
+- operationId: `regenerate_ad_creative_copy_ad_creatives__creative_id__regenerate_copy_post` (also callable as `g8.api.call("regenerate_ad_creative_copy_ad_creatives__creative_id__regenerate_copy_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Regenerate ALL the copy. SPENDS CREDIT, and DISCARDS the current text.
+
+There is no instruction to steer it - it re-runs the original prompt. Use
+`/rewrite-field` to change one field with direction, or `PATCH` to set the
+words yourself for nothing.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.creative_id` | `string` | yes | Ad creative id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.adCreatives.regenerateAdCreativeCopy({ path: { creative_id: "id" } });
+```
+
+---
+
+<a id="op-regenerateadcreativeimage"></a>
+
+### `g8.api.adCreatives.regenerateAdCreativeImage(input)`
+
+**Regenerate Ad Creative Image**
+
+- HTTP: `POST /api/v1/ad-creatives/{creative_id}/regenerate-image`
+- operationId: `regenerate_ad_creative_image_ad_creatives__creative_id__regenerate_image_post` (also callable as `g8.api.call("regenerate_ad_creative_image_ad_creatives__creative_id__regenerate_image_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Regenerate the image. SPENDS CREDIT - a full image pass.
+
+The previous image is snapshotted into the revision list first, so it is
+recoverable through `/restore-revision`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.creative_id` | `string` | yes | Ad creative id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.adCreatives.regenerateAdCreativeImage({ path: { creative_id: "id" } });
+```
+
+---
+
+<a id="op-regeneratevideoclip"></a>
+
+### `g8.api.adCreatives.regenerateVideoClip(input)`
+
+**Regenerate Video Clip**
+
+- HTTP: `POST /api/v1/ad-creatives/video/clips/{clip_id}/regenerate`
+- operationId: `regenerate_video_clip_ad_creatives_video_clips__clip_id__regenerate_post` (also callable as `g8.api.call("regenerate_video_clip_ad_creatives_video_clips__clip_id__regenerate_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Generate the clip again from the same prompt. SPENDS CREDIT - a full new generation.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.clip_id` | `string` | yes | Video clip id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.adCreatives.regenerateVideoClip({ path: { clip_id: "id" } });
+```
+
+---
+
+<a id="op-reskinadcreative"></a>
+
+### `g8.api.adCreatives.reskinAdCreative(input)`
+
+**Reskin Ad Creative**
+
+- HTTP: `POST /api/v1/ad-creatives/{creative_id}/reskin`
+- operationId: `reskin_ad_creative_ad_creatives__creative_id__reskin_post` (also callable as `g8.api.call("reskin_ad_creative_ad_creatives__creative_id__reskin_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Swap the creative's palette. FREE - deterministic colour replacement.
+
+Brand colours only. Nothing is regenerated, so the layout and the copy are
+byte-identical afterwards.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.creative_id` | `string` | yes | Ad creative id. |
+| `body` | `ReskinRequest` | yes | Request body; fields below. |
+
+Body fields (`ReskinRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.swaps` | `Array<ColorSwap>` | yes | min items 1, max items 8 |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.adCreatives.reskinAdCreative({
+  path: { creative_id: "id" },
+  body: { swaps: [{ from_color: "example", to_color: "example" }] },
+});
+```
+
+---
+
+<a id="op-restoreadcreativerevision"></a>
+
+### `g8.api.adCreatives.restoreAdCreativeRevision(input)`
+
+**Restore Ad Creative Revision**
+
+- HTTP: `POST /api/v1/ad-creatives/{creative_id}/restore-revision`
+- operationId: `restore_ad_creative_revision_ad_creatives__creative_id__restore_revision_post` (also callable as `g8.api.call("restore_ad_creative_revision_ad_creatives__creative_id__restore_revision_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Roll the creative back to a snapshot. FREE, and REVERSIBLE.
+
+The restore is itself snapshotted first, so restoring the wrong revision
+is undone by restoring the one this call just created.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.creative_id` | `string` | yes | Ad creative id. |
+| `body` | `RestoreRevisionRequest` | yes | Request body; fields below. |
+
+Body fields (`RestoreRevisionRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.index` | `integer` | yes | min 0 |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.adCreatives.restoreAdCreativeRevision({ path: { creative_id: "id" }, body: { index: 0 } });
+```
+
+---
+
+<a id="op-retryadcreativegeneration"></a>
+
+### `g8.api.adCreatives.retryAdCreativeGeneration(input)`
+
+**Retry Ad Creative Generation**
+
+- HTTP: `POST /api/v1/ad-creatives/{creative_id}/retry`
+- operationId: `retry_ad_creative_generation_ad_creatives__creative_id__retry_post` (also callable as `g8.api.call("retry_ad_creative_generation_ad_creatives__creative_id__retry_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Re-run a FAILED generation. SPENDS CREDIT - the copy and image passes run again.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.creative_id` | `string` | yes | Ad creative id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.adCreatives.retryAdCreativeGeneration({ path: { creative_id: "id" } });
+```
+
+---
+
+<a id="op-reviewadcreative"></a>
+
+### `g8.api.adCreatives.reviewAdCreative(input)`
+
+**Review Ad Creative**
+
+- HTTP: `POST /api/v1/ad-creatives/{creative_id}/ai-review`
+- operationId: `review_ad_creative_ad_creatives__creative_id__ai_review_post` (also callable as `g8.api.call("review_ad_creative_ad_creatives__creative_id__ai_review_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Review the creative and return findings. SPENDS CREDIT.
+
+`deep` defaults FALSE here and TRUE on the landing-page review. That is
+the app's own asymmetry and it is preserved rather than smoothed over -
+the two passes cost differently, and quietly changing either default would
+make the same call behave differently through the API than in Studio.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.creative_id` | `string` | yes | Ad creative id. |
+| `body` | `AdAIReviewRequest \| null` | no | Request body; fields below. |
+
+Body fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.deep` | `boolean` | no | default `false` |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.adCreatives.reviewAdCreative({ path: { creative_id: "id" } });
+```
+
+---
+
+<a id="op-rewriteadcreativefield"></a>
+
+### `g8.api.adCreatives.rewriteAdCreativeField(input)`
+
+**Rewrite Ad Creative Field**
+
+- HTTP: `POST /api/v1/ad-creatives/{creative_id}/rewrite-field`
+- operationId: `rewrite_ad_creative_field_ad_creatives__creative_id__rewrite_field_post` (also callable as `g8.api.call("rewrite_ad_creative_field_ad_creatives__creative_id__rewrite_field_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Rewrite ONE copy field with an instruction. SPENDS CREDIT.
+
+The cheap, steerable alternative to `/regenerate-copy`: it touches one
+field and leaves the rest alone.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.creative_id` | `string` | yes | Ad creative id. |
+| `body` | `RewriteFieldRequest` | yes | Request body; fields below. |
+
+Body fields (`RewriteFieldRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.field` | `string` | yes | max length 64 |
+| `body.instruction` | `string` | yes | max length 2000 |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.adCreatives.rewriteAdCreativeField({
+  path: { creative_id: "id" },
+  body: { field: "example", instruction: "example" },
+});
+```
+
+---
+
+<a id="op-saveadcreativeastemplate"></a>
+
+### `g8.api.adCreatives.saveAdCreativeAsTemplate(input)`
+
+**Save Ad Creative As Template**
+
+- HTTP: `POST /api/v1/ad-creatives/{creative_id}/save-as-template`
+- operationId: `save_ad_creative_as_template_ad_creatives__creative_id__save_as_template_post` (also callable as `g8.api.call("save_ad_creative_as_template_ad_creatives__creative_id__save_as_template_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Clone a finished creative as a reusable template. FREE.
+
+A COPY - the original creative is untouched, and the template appears in
+`GET /ad-creatives?templates=true` rather than in the main list.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.creative_id` | `string` | yes | Ad creative id. |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.adCreatives.saveAdCreativeAsTemplate({ path: { creative_id: "id" } });
+```
+
+---
+
+<a id="op-setadcreativeimage"></a>
+
+### `g8.api.adCreatives.setAdCreativeImage(input)`
+
+**Set Ad Creative Image**
+
+- HTTP: `POST /api/v1/ad-creatives/{creative_id}/set-image`
+- operationId: `set_ad_creative_image_ad_creatives__creative_id__set_image_post` (also callable as `g8.api.call("set_ad_creative_image_ad_creatives__creative_id__set_image_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Point the creative at an image already in the library. FREE.
+
+The API-shaped alternative to the multipart upload route: put the file in
+the image library, then reference it here by id.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.creative_id` | `string` | yes | Ad creative id. |
+| `body` | `SetImageRequest` | yes | Request body; fields below. |
+
+Body fields (`SetImageRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.library_image_id` | `string` | yes |  |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.adCreatives.setAdCreativeImage({ path: { creative_id: "id" }, body: { library_image_id: "id" } });
+```
+
+---
+
+<a id="op-setadcreativeimagefocus"></a>
+
+### `g8.api.adCreatives.setAdCreativeImageFocus(input)`
+
+**Set Ad Creative Image Focus**
+
+- HTTP: `POST /api/v1/ad-creatives/{creative_id}/set-image-focus`
+- operationId: `set_ad_creative_image_focus_ad_creatives__creative_id__set_image_focus_post` (also callable as `g8.api.call("set_ad_creative_image_focus_ad_creatives__creative_id__set_image_focus_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Move the crop focal point. FREE.
+
+0-1 in each axis, 0.5/0.5 being the centre. It decides what survives the
+crop in every OTHER format the creative is rendered at.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.creative_id` | `string` | yes | Ad creative id. |
+| `body` | `SetImageFocusRequest` | yes | Request body; fields below. |
+
+Body fields (`SetImageFocusRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.focus_x` | `number` | no | default `0.5` |
+| `body.focus_y` | `number` | no | default `0.5` |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.adCreatives.setAdCreativeImageFocus({ path: { creative_id: "id" }, body: {} });
+```
+
+---
+
+<a id="op-updateadcreative"></a>
+
+### `g8.api.adCreatives.updateAdCreative(input)`
+
+**Update Ad Creative**
+
+- HTTP: `PATCH /api/v1/ad-creatives/{creative_id}`
+- operationId: `update_ad_creative_ad_creatives__creative_id__patch` (also callable as `g8.api.call("update_ad_creative_ad_creatives__creative_id__patch", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Edit the copy by hand. FREE - no model runs.
+
+Use this rather than `/rewrite-field` when you already know the words.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.creative_id` | `string` | yes | Ad creative id. |
+| `body` | `UpdateAdCreativeRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdateAdCreativeRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.cta` | `string \| null` | no |  |
+| `body.description` | `string \| null` | no |  |
+| `body.headline` | `string \| null` | no |  |
+| `body.name` | `string \| null` | no |  |
+| `body.primary_text` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.adCreatives.updateAdCreative({ path: { creative_id: "id" }, body: {} });
+```
+
+---
+
+## Referenced types
+
+Named types that appear in the tables above. Full TypeScript definitions: `G8Contract.<Name>` (`import type { G8Contract } from "@graph8/sdk"`).
+
+<a id="type-campaignsetpersona"></a>
+
+### `CampaignSetPersona`
+
+A buyer persona, as the lens pass needs to see it.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `title` | `string` | yes | min length 1, max length 120 |
+| `id` | `string \| null` | no |  |
+| `summary` | `string \| null` | no | max length 600 |
+
+<a id="type-colorswap"></a>
+
+### `ColorSwap`
+
+One colour replaced by another, both as hex.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `from_color` | `string` | yes | pattern `^#(?:[0-9a-fA-F]{3}\|[0-9a-fA-F]{4}\|[0-9a-fA-F]{6}\|[0-9a-fA-F]{8})$` |
+| `to_color` | `string` | yes | pattern `^#(?:[0-9a-fA-F]{3}\|[0-9a-fA-F]{4}\|[0-9a-fA-F]{6}\|[0-9a-fA-F]{8})$` |
+
+<a id="type-videoclippromptinputs"></a>
+
+### `VideoClipPromptInputs`
+
+The structured shot description. `subject` is the only required field.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `subject` | `string` | yes | min length 3, max length 500 |
+| `camera` | `string \| null` | no | max length 40 |
+| `lighting` | `string \| null` | no | max length 120 |
+| `negative` | `string \| null` | no | max length 300 |
+| `setting` | `string \| null` | no | max length 300 |
+| `style` | `string \| null` | no | max length 40 |
+
+<a id="type-videostoryboard"></a>
+
+### `VideoStoryboard`
+
+The ordered shots (1-5) and the copy for the template's text slots.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `copy` | `Record<string, string>` | no | Copy slot id (headline, subline, cta, ...) -> text. |
+| `shots` | `Array<VideoShot>` | no | max items 5 |