@nodaro/sdk 2.76.0 → 2.78.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (112) hide show
  1. package/dist/{chunk-HUYI5G3D.js → chunk-3NG4HPM5.js} +2 -2
  2. package/dist/{chunk-HUYI5G3D.js.map → chunk-3NG4HPM5.js.map} +1 -1
  3. package/dist/chunk-5QNCWXKG.cjs +22 -0
  4. package/dist/chunk-5QNCWXKG.cjs.map +1 -0
  5. package/dist/{chunk-IO7NEEZZ.cjs → chunk-6BPQYCUG.cjs} +54 -3
  6. package/dist/chunk-6BPQYCUG.cjs.map +1 -0
  7. package/dist/{chunk-TZFZDEWI.js → chunk-6ZKW7767.js} +54 -3
  8. package/dist/chunk-6ZKW7767.js.map +1 -0
  9. package/dist/{chunk-7PMOXQEO.cjs → chunk-7WVQZPUW.cjs} +51 -8
  10. package/dist/chunk-7WVQZPUW.cjs.map +1 -0
  11. package/dist/{chunk-GIQDM2MH.js → chunk-C3H3V5PN.js} +2 -2
  12. package/dist/{chunk-GIQDM2MH.js.map → chunk-C3H3V5PN.js.map} +1 -1
  13. package/dist/{chunk-CSNYBGHP.js → chunk-D45ATYCE.js} +2 -2
  14. package/dist/chunk-D45ATYCE.js.map +1 -0
  15. package/dist/{chunk-A3XA6UNM.cjs → chunk-FQHMDWSP.cjs} +2 -2
  16. package/dist/{chunk-A3XA6UNM.cjs.map → chunk-FQHMDWSP.cjs.map} +1 -1
  17. package/dist/{chunk-SGVTZ2J5.cjs → chunk-G6ASA5RQ.cjs} +18 -18
  18. package/dist/{chunk-SGVTZ2J5.cjs.map → chunk-G6ASA5RQ.cjs.map} +1 -1
  19. package/dist/{chunk-UPWAODYT.cjs → chunk-H6ZB7WYE.cjs} +26 -2
  20. package/dist/chunk-H6ZB7WYE.cjs.map +1 -0
  21. package/dist/{chunk-SGVJUVFD.cjs → chunk-HEJE6L3E.cjs} +3 -3
  22. package/dist/{chunk-SGVJUVFD.cjs.map → chunk-HEJE6L3E.cjs.map} +1 -1
  23. package/dist/{chunk-FOC4VPGK.js → chunk-IAHNPMIX.js} +3 -3
  24. package/dist/{chunk-FOC4VPGK.js.map → chunk-IAHNPMIX.js.map} +1 -1
  25. package/dist/{chunk-U2F6IHHY.js → chunk-JCLJRCMR.js} +10 -10
  26. package/dist/{chunk-U2F6IHHY.js.map → chunk-JCLJRCMR.js.map} +1 -1
  27. package/dist/{chunk-KNBZFWVO.cjs → chunk-JIFGF6PA.cjs} +13 -2
  28. package/dist/chunk-JIFGF6PA.cjs.map +1 -0
  29. package/dist/chunk-NDX4QUTI.js +3 -0
  30. package/dist/{chunk-CHZBONJJ.js.map → chunk-NDX4QUTI.js.map} +1 -1
  31. package/dist/{chunk-GWL4O3J2.js → chunk-PNTVCJZV.js} +13 -2
  32. package/dist/chunk-PNTVCJZV.js.map +1 -0
  33. package/dist/{chunk-AOHDYZSZ.js → chunk-QV4QD6XI.js} +26 -2
  34. package/dist/chunk-QV4QD6XI.js.map +1 -0
  35. package/dist/{chunk-6NIKAVI3.cjs → chunk-STKXUHEM.cjs} +2 -2
  36. package/dist/chunk-STKXUHEM.cjs.map +1 -0
  37. package/dist/{chunk-57GANTLV.cjs → chunk-USBDYHSO.cjs} +2 -2
  38. package/dist/{chunk-57GANTLV.cjs.map → chunk-USBDYHSO.cjs.map} +1 -1
  39. package/dist/{chunk-OO4AKYUN.js → chunk-VPBPVDKY.js} +52 -10
  40. package/dist/chunk-VPBPVDKY.js.map +1 -0
  41. package/dist/{chunk-D3F2BWD6.cjs → chunk-VZCCECKW.cjs} +2 -2
  42. package/dist/{chunk-D3F2BWD6.cjs.map → chunk-VZCCECKW.cjs.map} +1 -1
  43. package/dist/chunk-YPZCTRFB.js +12 -0
  44. package/dist/chunk-YPZCTRFB.js.map +1 -0
  45. package/dist/entries/cast-swap.cjs +2 -2
  46. package/dist/entries/cast-swap.d.cts +1 -1
  47. package/dist/entries/cast-swap.d.ts +1 -1
  48. package/dist/entries/cast-swap.js +1 -1
  49. package/dist/entries/characters.d.cts +2 -1
  50. package/dist/entries/characters.d.ts +2 -1
  51. package/dist/entries/client.cjs +14 -14
  52. package/dist/entries/client.d.cts +2 -2
  53. package/dist/entries/client.d.ts +2 -2
  54. package/dist/entries/client.js +9 -9
  55. package/dist/entries/core.cjs +5 -5
  56. package/dist/entries/core.js +1 -1
  57. package/dist/entries/creatures.cjs +6 -6
  58. package/dist/entries/creatures.d.cts +2 -3
  59. package/dist/entries/creatures.d.ts +2 -3
  60. package/dist/entries/creatures.js +1 -1
  61. package/dist/entries/edit.cjs +12 -8
  62. package/dist/entries/edit.d.cts +272 -71
  63. package/dist/entries/edit.d.ts +272 -71
  64. package/dist/entries/edit.js +2 -2
  65. package/dist/entries/locations.d.cts +2 -1
  66. package/dist/entries/locations.d.ts +2 -1
  67. package/dist/entries/media.cjs +2 -2
  68. package/dist/entries/media.d.cts +68 -2
  69. package/dist/entries/media.d.ts +68 -2
  70. package/dist/entries/media.js +1 -1
  71. package/dist/entries/nodes.cjs +9 -5
  72. package/dist/entries/nodes.d.cts +3 -2
  73. package/dist/entries/nodes.d.ts +3 -2
  74. package/dist/entries/nodes.js +2 -2
  75. package/dist/entries/objects.cjs +6 -6
  76. package/dist/entries/objects.d.cts +2 -3
  77. package/dist/entries/objects.d.ts +2 -3
  78. package/dist/entries/objects.js +1 -1
  79. package/dist/entries/scene3d.d.cts +3 -2
  80. package/dist/entries/scene3d.d.ts +3 -2
  81. package/dist/entries/trends.cjs +2 -2
  82. package/dist/entries/trends.d.cts +36 -17
  83. package/dist/entries/trends.d.ts +36 -17
  84. package/dist/entries/trends.js +1 -1
  85. package/dist/entries/video-remake.cjs +2 -2
  86. package/dist/entries/video-remake.d.cts +1 -1
  87. package/dist/entries/video-remake.d.ts +1 -1
  88. package/dist/entries/video-remake.js +1 -1
  89. package/dist/index.cjs +48 -40
  90. package/dist/index.d.cts +5 -5
  91. package/dist/index.d.ts +5 -5
  92. package/dist/index.js +11 -11
  93. package/dist/{nodes-BaRqRB2Z.d.ts → nodes-C6e2wign.d.ts} +86 -8
  94. package/dist/{nodes-BHtjh6gl.d.cts → nodes-D71Ec9b5.d.cts} +86 -8
  95. package/dist/{video-remake-C-KR7YtT.d.ts → video-remake-CnnJMGwj.d.ts} +166 -5
  96. package/dist/{video-remake-DTuCyhd9.d.cts → video-remake-EHwCWlUW.d.cts} +166 -5
  97. package/package.json +3 -3
  98. package/dist/chunk-6NIKAVI3.cjs.map +0 -1
  99. package/dist/chunk-7PMOXQEO.cjs.map +0 -1
  100. package/dist/chunk-AOHDYZSZ.js.map +0 -1
  101. package/dist/chunk-CHZBONJJ.js +0 -3
  102. package/dist/chunk-CSNYBGHP.js.map +0 -1
  103. package/dist/chunk-GWL4O3J2.js.map +0 -1
  104. package/dist/chunk-IO7NEEZZ.cjs.map +0 -1
  105. package/dist/chunk-KNBZFWVO.cjs.map +0 -1
  106. package/dist/chunk-OO4AKYUN.js.map +0 -1
  107. package/dist/chunk-RKYZY6NA.cjs +0 -16
  108. package/dist/chunk-RKYZY6NA.cjs.map +0 -1
  109. package/dist/chunk-TZFZDEWI.js.map +0 -1
  110. package/dist/chunk-UPWAODYT.cjs.map +0 -1
  111. package/dist/chunk-WFFVCGNU.js +0 -3
  112. package/dist/chunk-WFFVCGNU.js.map +0 -1
@@ -8,6 +8,7 @@ import * as _nodaro_shared_scene3d from '@nodaro/shared/scene3d';
8
8
  import { Scene3DPlan, Scene3DEditOperation, Scene3DV2EditOperation, Scene3DReference, Pro3DRenderSource, Pro3DRenderEngine, Pro3DRenderQuality, Pro3DRenderStyle, Scene3DJobOutputAny, Pro3DRenderJobOutput as Pro3DRenderJobOutput$1, Pro3DRenderCapabilities, Scene3DPlanV2, Pro3DRenderQuote as Pro3DRenderQuote$1 } from '@nodaro/shared/scene3d';
9
9
  import { UpscaleFactor } from '@nodaro/shared/credits';
10
10
  import { ImageToImageAttachColumn } from '@nodaro/shared/entities';
11
+ import { G as VideoRemakeEngine, I as VideoRemakeEstimate, S as VideoRemakeParams } from './video-remake-EHwCWlUW.cjs';
11
12
  import { LlmReasoningEffort } from '@nodaro/shared/llm-models';
12
13
  import { N as NodaroClientCore } from './developer-apps-D59GfAnO.cjs';
13
14
  import { JobsResource, JobStatusResult } from './entries/jobs.cjs';
@@ -512,9 +513,13 @@ type GenerateMaskJobOutput = NodeJobOutput & GenerateMaskOutput;
512
513
 
513
514
  /**
514
515
  * Typed request body for `nodes.run("video-to-video", …)` / `runAndWait` /
515
- * `quote` — `POST /v1/video-to-video`: change or restyle an existing clip from
516
- * a prompt. Mirrors the route's body; fields a model does not use are ignored
517
- * by that model.
516
+ * `quote` — `POST /v1/video-to-video`: edit an existing clip by instruction.
517
+ * Video Remake (`client.videoRemake`, Nodaro Cloud) is the recommended way to
518
+ * edit, modify, restyle or transfer the motion of a clip: it keeps the clip's
519
+ * motion, camera and timing and changes what you ask. Its two engines are
520
+ * named choices here too ({@link VideoToVideoRemakeParams}), which answer its
521
+ * quote and start nothing. Mirrors the route's body; fields a model does not
522
+ * use are ignored by that model.
518
523
  */
519
524
  interface VideoToVideoParams extends GenerationSessionParams {
520
525
  /** The clip to change. */
@@ -524,15 +529,19 @@ interface VideoToVideoParams extends GenerationSessionParams {
524
529
  prompt?: string;
525
530
  /** The person's own words, kept for the record when `prompt` was rewritten. */
526
531
  userPrompt?: string;
527
- /** Default `"wan"`. `seedance-2-5` edits the whole clip and is priced by the
528
- * clip's length (see `nodes.quote`). The platform tells Seedance the run is
532
+ /** Default `"seedance-2-5"`, which edits the whole clip by instruction (it
533
+ * needs a `prompt` and a 4–30 s clip) and is priced by the clip's length
534
+ * (see `nodes.quote`). `wan` / `wan-flash` do not edit the clip: they make a
535
+ * new clip featuring its subject. The platform tells Seedance the run is
529
536
  * an edit when every clip (`videoUrl` and `referenceVideoUrls`) is 4–30 s
530
537
  * long (a draft included), so this lane takes no `referenceTaskType` of its own. */
531
538
  provider?: VideoToVideoNodeProvider;
532
539
  /** Wan / Wan Flash. A Seedance edit ignores it: the result keeps the source
533
540
  * clip's own length. */
534
541
  duration?: "5" | "10";
535
- /** `480p` is Seedance only. */
542
+ /** `480p` is Seedance only. A request naming neither a `provider` nor a
543
+ * `resolution` renders at 480p; one naming `seedance-2-5` and no resolution
544
+ * renders at 720p. */
536
545
  resolution?: "480p" | "720p" | "1080p";
537
546
  /** Native audio: Wan Flash's audio track, Seedance's generated sound. */
538
547
  audio?: boolean;
@@ -572,6 +581,70 @@ interface VideoToVideoParams extends GenerationSessionParams {
572
581
  referenceAudioUrls?: string[];
573
582
  [k: string]: unknown;
574
583
  }
584
+ /**
585
+ * `nodes.run("video-to-video", …)` / `nodes.quote` with a Video Remake engine
586
+ * as the `provider` (`"nodaro-prism"`, `"nodaro-pulse"`; Nodaro Cloud). The
587
+ * route starts NOTHING for these two: `run` resolves a
588
+ * {@link VideoToVideoRemakeQuote}, Video Remake's price for the clip and the
589
+ * instruction, with the request that runs it on `client.videoRemake.run`.
590
+ *
591
+ * Video Remake reads `videoUrl`, `prompt` (its instruction, the run's
592
+ * `postPrompt`), `resolution` and `draft`. Every other Video to Video lever
593
+ * (`duration`, `aspectRatio`, `seed`, `audio`, `multiShots`, …) does not apply
594
+ * and is dropped; a reference list (`referenceImageUrl`, `referenceImageUrls`,
595
+ * `referenceVideoUrls`, `referenceAudioUrls`) is refused with a 400: Video
596
+ * Remake takes pictures as roles and fixed references on its own route.
597
+ * Refusals: 404 `not_available` (a deployment without Video Remake), 403
598
+ * `node_not_available` / `model_not_available`, 503 `engine_unavailable`, and
599
+ * Video Remake's own (a clip outside 4–30 s, and the rest of its estimate's).
600
+ */
601
+ interface VideoToVideoRemakeParams {
602
+ /** The clip to change, 4–30 seconds. */
603
+ videoUrl: string;
604
+ /** What to change, in your own words. Required. */
605
+ prompt: string;
606
+ /** The Video Remake engine, by its public id. */
607
+ provider: VideoRemakeEngine;
608
+ /** Nodaro Prism: 480p (its default), 720p or 1080p. Nodaro Pulse: 720p (its default) or 1080p. */
609
+ resolution?: "480p" | "720p" | "1080p";
610
+ /** Nodaro Prism only: a 480p draft that Full Quality can finish at 1080p. */
611
+ draft?: boolean;
612
+ [k: string]: unknown;
613
+ }
614
+ /** The `client.videoRemake.run` body that runs a {@link VideoToVideoRemakeQuote}: the clip, the instruction, no role. */
615
+ type VideoToVideoRemakeRun = Pick<VideoRemakeParams, "videoUrl" | "roles" | "postPrompt" | "resolution" | "draft"> & {
616
+ roles: [];
617
+ postPrompt: string;
618
+ engine: VideoRemakeEngine;
619
+ };
620
+ /**
621
+ * What `POST /v1/video-to-video` answers for a Video Remake engine: a QUOTE,
622
+ * never a started job. There is no `jobId`; `quoteOnly` is always `true`.
623
+ * Nothing was held or charged. To run it:
624
+ * `client.videoRemake.run(result.videoRemake.run.body)`.
625
+ */
626
+ interface VideoToVideoRemakeQuote {
627
+ readonly quoteOnly: true;
628
+ /** The same, in words. */
629
+ readonly message: string;
630
+ readonly videoRemake: {
631
+ /** Video Remake's quote for this clip and instruction: `totalCredits` is the hold, `expectedCredits` the expected charge. */
632
+ readonly quote: Omit<VideoRemakeEstimate, "engine" | "maskingCredits"> & {
633
+ readonly engine: VideoRemakeEngine;
634
+ /** The engine's name, as people read it ("Nodaro Prism", "Nodaro Pulse"). */
635
+ readonly engineName: string;
636
+ };
637
+ /** The request that runs it. */
638
+ readonly run: {
639
+ readonly method: "POST";
640
+ readonly path: "/v1/video-remake";
641
+ readonly body: VideoToVideoRemakeRun;
642
+ };
643
+ };
644
+ readonly jobId?: never;
645
+ }
646
+ /** Whether a `nodes.run("video-to-video", …)` answer is a Video Remake quote (nothing started) rather than a job. */
647
+ declare function isVideoToVideoRemakeQuote(result: unknown): result is VideoToVideoRemakeQuote;
575
648
  /** One way the platform shaped the price — shown so a client can explain it. */
576
649
  interface QuoteAdjustment {
577
650
  /** Stable code, e.g. `ref_video_length`, `extra_reference_images`,
@@ -1511,6 +1584,9 @@ declare class NodesResource {
1511
1584
  run(type: "text-to-speech", params: TextToSpeechParams): Promise<RunNodeResult>;
1512
1585
  run(type: "generate-video", params?: GenerateVideoParams, options?: RunNodeOptions): Promise<RunNodeResult>;
1513
1586
  run(type: "text-to-video", params: TextToVideoParams, options?: RunNodeOptions): Promise<RunNodeResult>;
1587
+ /** A Video Remake engine as the `provider` (`"nodaro-prism"`, `"nodaro-pulse"`): answers its QUOTE and
1588
+ * the request that runs it on `client.videoRemake.run`. No job is started and nothing is held. */
1589
+ run(type: "video-to-video", params: VideoToVideoRemakeParams, options?: RunNodeOptions): Promise<VideoToVideoRemakeQuote>;
1514
1590
  run(type: "video-to-video", params: VideoToVideoParams, options?: RunNodeOptions): Promise<RunNodeResult>;
1515
1591
  /** Synchronous: answers `{ jobId, generatedText }`. */
1516
1592
  run(type: "llm-chat", params: LlmChatParams, options?: RunNodeOptions): Promise<RunNodeResult>;
@@ -1548,7 +1624,9 @@ declare class NodesResource {
1548
1624
  */
1549
1625
  quote(type: "text-to-video", params: TextToVideoParams): Promise<NodeQuote>;
1550
1626
  quote(type: "generate-video", params: GenerateVideoParams): Promise<NodeQuote>;
1551
- quote(type: "video-to-video", params: VideoToVideoParams): Promise<NodeQuote>;
1627
+ /** With a Video Remake engine as the `provider`: Video Remake's own quote (`reserve` its hold,
1628
+ * `expected` its expected charge), with a `quote_only_provider` warning. */
1629
+ quote(type: "video-to-video", params: VideoToVideoParams | VideoToVideoRemakeParams): Promise<NodeQuote>;
1552
1630
  /** A Seedance 2.5 draft's 1080p finalize (`seedance-2-5-hd`) is priced from
1553
1631
  * the draft itself, including the clips it was made with. */
1554
1632
  quote(type: "video-upscale", params: VideoUpscaleParams): Promise<NodeQuote>;
@@ -1650,4 +1728,4 @@ declare class NodesResource {
1650
1728
  private pollUntilSettled;
1651
1729
  }
1652
1730
 
1653
- export { type SocialSearchJobOutput as $, type AssembleNarratedVideoParams as A, type BatchJobOutcome as B, type RetainedScene3DEditParams as C, type RetainedScene3DEditResult as D, type EditImageCommonParams as E, type RunAndWaitOptions as F, type GenerateImageBatchGroup as G, type RunManyResult as H, type ImageJobStarted as I, type JobOutputImage as J, type RunNodeAdjustment as K, type LlmChatParams as L, type RunNodeOptions as M, type NodeCategory as N, type OutputType as O, type Pro3DRenderJobOutput as P, type QuoteAdjustment as Q, type ReferenceCaptionParams as R, type RunNodeResult as S, type RunNodeWarning as T, SCENE3D_DELIVERY_ASSET_USAGE as U, type Scene3DAuthoringEngine as V, type Scene3DCapabilities as W, type Scene3DDelivery as X, type Scene3DDeliveryAsset as Y, type Scene3DDeliveryAssetKind as Z, type Scene3DJobOutput as _, type EditImageFromTaskParams as a, type SplitImageParams as a0, type SplitImageResult as a1, type SplitImageTile as a2, type StructuredReferenceParams as a3, type Subject as a4, type TextToSpeechParams as a5, type TextToVideoParams as a6, type VideoDepthParams as a7, type VideoToVideoParams as a8, type VideoUpscaleParams as a9, type EditImageFromUrlParams as b, type EditImageParams as c, type EditScene3DParams as d, type GenerateImageBatchOutput as e, type GenerateImageBatchResult as f, type GenerateImageParams as g, type GenerateMaskJobOutput as h, type GenerateMaskParams as i, type GenerateScene3DParams as j, type GenerateVideoParams as k, type GenerationSessionParams as l, type ImageToImageParams as m, type NodeCreditRate as n, type NodeDescriptor as o, type NodeInputField as p, type NodeInputSchema as q, type NodeJobOutput as r, type NodeQuote as s, NodesResource as t, type Pro3DRenderParams as u, type Pro3DRenderQuote as v, type Pro3DRenderRunOptions as w, type Pro3DRenderRunParams as x, type QuoteWarning as y, type RenderScene3DParams as z };
1731
+ export { type SocialSearchJobOutput as $, type AssembleNarratedVideoParams as A, type BatchJobOutcome as B, type RetainedScene3DEditParams as C, type RetainedScene3DEditResult as D, type EditImageCommonParams as E, type RunAndWaitOptions as F, type GenerateImageBatchGroup as G, type RunManyResult as H, type ImageJobStarted as I, type JobOutputImage as J, type RunNodeAdjustment as K, type LlmChatParams as L, type RunNodeOptions as M, type NodeCategory as N, type OutputType as O, type Pro3DRenderJobOutput as P, type QuoteAdjustment as Q, type ReferenceCaptionParams as R, type RunNodeResult as S, type RunNodeWarning as T, SCENE3D_DELIVERY_ASSET_USAGE as U, type Scene3DAuthoringEngine as V, type Scene3DCapabilities as W, type Scene3DDelivery as X, type Scene3DDeliveryAsset as Y, type Scene3DDeliveryAssetKind as Z, type Scene3DJobOutput as _, type EditImageFromTaskParams as a, type SplitImageParams as a0, type SplitImageResult as a1, type SplitImageTile as a2, type StructuredReferenceParams as a3, type Subject as a4, type TextToSpeechParams as a5, type TextToVideoParams as a6, type VideoDepthParams as a7, type VideoToVideoParams as a8, type VideoToVideoRemakeParams as a9, type VideoToVideoRemakeQuote as aa, type VideoToVideoRemakeRun as ab, type VideoUpscaleParams as ac, isVideoToVideoRemakeQuote as ad, type EditImageFromUrlParams as b, type EditImageParams as c, type EditScene3DParams as d, type GenerateImageBatchOutput as e, type GenerateImageBatchResult as f, type GenerateImageParams as g, type GenerateMaskJobOutput as h, type GenerateMaskParams as i, type GenerateScene3DParams as j, type GenerateVideoParams as k, type GenerationSessionParams as l, type ImageToImageParams as m, type NodeCreditRate as n, type NodeDescriptor as o, type NodeInputField as p, type NodeInputSchema as q, type NodeJobOutput as r, type NodeQuote as s, NodesResource as t, type Pro3DRenderParams as u, type Pro3DRenderQuote as v, type Pro3DRenderRunOptions as w, type Pro3DRenderRunParams as x, type QuoteWarning as y, type RenderScene3DParams as z };
@@ -304,10 +304,14 @@ interface VideoRemakeParams {
304
304
  * the engine, where it is that run's change), and one with a pre or post prompt
305
305
  * runs as any other art-style run. The job records it in
306
306
  * `input_data.direction`.
307
+ *
308
+ * A custom style: `{ customStyle: "<text>" }` in place of `{ style }` gives
309
+ * the style in your own words (see {@link VideoRemakeCustomStyleDirection}),
310
+ * only where {@link VideoRemakeResource.styleChoice} answers `customStyle`
311
+ * true for the engine. It goes wherever a catalog art style goes and counts
312
+ * as the run's change wherever one does. Never both: send one of the two.
307
313
  */
308
- direction?: {
309
- style: string;
310
- };
314
+ direction?: VideoRemakeArtStyleDirection | VideoRemakeCustomStyleDirection;
311
315
  /**
312
316
  * Nodaro Pulse only (Prism ignores it): which end of the clip is cut to
313
317
  * whole seconds (see {@link VideoRemakeMotionLength}). Default `"cut-end"`.
@@ -353,6 +357,83 @@ interface VideoRemakeParams {
353
357
  origin?: string;
354
358
  }
355
359
  /** What a run would cost, in credits. */
360
+ /** A run's art style from the catalog: a `style` picker id (see {@link VideoRemakeParams}'s `direction`). */
361
+ interface VideoRemakeArtStyleDirection {
362
+ style: string;
363
+ customStyle?: never;
364
+ }
365
+ /**
366
+ * A run's custom style: the visual style in your own words, in place of a
367
+ * catalog art style. Describe the look only: the medium (drawn, 3D-rendered
368
+ * or filmed), line, colour, lighting and texture; not who or what is in the
369
+ * video. At most 600 characters, never blank. The words are used as written;
370
+ * the run itself works out whether the style is drawn, rendered or filmed, at
371
+ * no extra charge (the estimate is the same as for a catalog art style). The
372
+ * job records the text as sent in `input_data.direction.customStyle`.
373
+ * {@link VideoRemakeResource.describeStyle} writes such a text from an image.
374
+ *
375
+ * Nodaro Prism only, on a direct run, and only where
376
+ * {@link VideoRemakeResource.styleChoice} answers `customStyle` true for the
377
+ * engine. Refusals: {@link VideoRemakeCustomStyleRefusalCode}.
378
+ */
379
+ interface VideoRemakeCustomStyleDirection {
380
+ customStyle: string;
381
+ style?: never;
382
+ }
383
+ /**
384
+ * The `code` of a refusal that concerns a custom style (`NodaroError.code`),
385
+ * all before anything is charged.
386
+ *
387
+ * On {@link VideoRemakeResource.run} and {@link VideoRemakeResource.estimate}:
388
+ * - `custom_style_with_art_style` (400): `direction` carries both `style` and
389
+ * `customStyle`; send one;
390
+ * - `custom_style_empty` (400): the text is blank, or nothing is left of it
391
+ * once its curly braces are taken out;
392
+ * - `custom_style_too_long` (400): more than 600 characters;
393
+ * - `custom_style_not_available` (403): a custom style is not offered here
394
+ * (see {@link VideoRemakeStyleChoice.customStyle}); choose a catalog art
395
+ * style instead;
396
+ * - `raw_reference_token` (400): the text holds `{image:…}`, `{video:…}` or
397
+ * `{audio:…}`;
398
+ * - `art_style_needs_prism` / `art_style_needs_flex` (400): where a catalog
399
+ * art style could not go either (Nodaro Pulse, a trend run).
400
+ *
401
+ * On {@link VideoRemakeResource.describeStyle}:
402
+ * - `unauthorized` (401): no authenticated user;
403
+ * - `validation_error` (400), `unsafe_url` (400): the body, or an address that
404
+ * is not a public http(s) one;
405
+ * - `custom_style_not_available` (403): as above;
406
+ * - `image_unreadable` (400): the image could not be fetched, is larger than
407
+ * 10 MB, or is not a PNG, JPEG, WebP or GIF;
408
+ * - `describe_style_failed` (502): the image could not be described just now;
409
+ * try again;
410
+ * - `style_not_described` (422): no style could be described from this image;
411
+ * try another, or write the style yourself;
412
+ * - `rate_limit_exceeded` (429): too many calls in a minute for this account.
413
+ *
414
+ * Open-ended: a code not listed here may still arrive.
415
+ */
416
+ type VideoRemakeCustomStyleRefusalCode = "custom_style_with_art_style" | "custom_style_empty" | "custom_style_too_long" | "custom_style_not_available" | "raw_reference_token" | "art_style_needs_prism" | "art_style_needs_flex" | "unauthorized" | "validation_error" | "unsafe_url" | "image_unreadable" | "describe_style_failed" | "style_not_described" | "rate_limit_exceeded" | (string & {});
417
+ /** What {@link VideoRemakeResource.describeStyle} takes. */
418
+ interface VideoRemakeDescribeStyleParams {
419
+ /** A public http(s) image (PNG, JPEG, WebP or GIF, at most 10 MB) whose visual style is put into words. */
420
+ imageUrl: string;
421
+ /** A wish about the style, at most 600 characters ("like this, but darker"). */
422
+ note?: string;
423
+ }
424
+ /** The medium a described style reads as: drawn or painted, computer-rendered or modelled, or filmed. */
425
+ type VideoRemakeStyleMedium = "2d" | "3d" | "photo";
426
+ /** The tones a described style reads as. */
427
+ type VideoRemakeStyleTones = "colour" | "black-and-white" | "one-colour";
428
+ /** What {@link VideoRemakeResource.describeStyle} answers. */
429
+ interface VideoRemakeDescribedStyle {
430
+ /** The image's visual style in words (never its content), at most 600 characters: ready to edit and send as `direction.customStyle`. */
431
+ text: string;
432
+ /** How the description reads, a hint for an interface only: a run works out its style's medium itself, from the words it is sent. */
433
+ medium?: VideoRemakeStyleMedium;
434
+ /** As `medium`. */
435
+ tones?: VideoRemakeStyleTones;
436
+ }
356
437
  interface VideoRemakeEstimate {
357
438
  /**
358
439
  * The engine the run would use, by its public id (absent from an older
@@ -561,6 +642,43 @@ interface VideoRemakeStyleChoice {
561
642
  * missing from it: `false`.
562
643
  */
563
644
  preciseArtStyleAlone?: Partial<Record<VideoRemakeEngine, boolean>>;
645
+ /**
646
+ * Per engine, whether a direct run takes a custom style there: the style in
647
+ * your own words (`direction: { customStyle }`, see
648
+ * {@link VideoRemakeCustomStyleDirection}) in place of a catalog art style,
649
+ * and {@link VideoRemakeResource.describeStyle} with it. `true` only where
650
+ * the engine takes one and Nodaro offers it on this deployment. Nodaro
651
+ * Pulse is always `false` (it takes no art style). Absent from an older
652
+ * server, and an engine missing from it: `false` (offer the catalog's art
653
+ * styles alone; a custom style sent anyway is refused).
654
+ */
655
+ customStyle?: Partial<Record<VideoRemakeEngine, boolean>>;
656
+ }
657
+ /**
658
+ * What {@link VideoRemakeResource.advanced} answers: whether the Video Remake
659
+ * page shows its Advanced options.
660
+ */
661
+ interface VideoRemakeAdvanced {
662
+ /**
663
+ * Whether the Video Remake page shows `prepareReferences` and `prePrompt`
664
+ * under its Advanced options: `false` until Nodaro turns them on, one
665
+ * setting for the whole page, the same for every engine.
666
+ */
667
+ show: boolean;
668
+ }
669
+ /**
670
+ * One art style of {@link VideoRemakeResource.artStyles}: a style Video
671
+ * Remake's art style picker offers, with its preview.
672
+ */
673
+ interface VideoRemakeArtStyle {
674
+ /** The style's id: what a run takes as `direction.style` (an id of the `style` picker catalog). */
675
+ id: string;
676
+ /** The style's name in the language asked for; English where that language does not name it. */
677
+ label: string;
678
+ /** A short clip of real footage wiping into the style (an absolute https address). */
679
+ clipUrl: string;
680
+ /** A still frame cut from that clip (an absolute https address). */
681
+ stillUrl: string;
564
682
  }
565
683
  declare class VideoRemakeResource {
566
684
  private client;
@@ -589,10 +707,53 @@ declare class VideoRemakeResource {
589
707
  * art style alone is refused, and one with a pre or post prompt runs as any
590
708
  * other art-style run. Its `preciseArtStyle` says, per engine, whether a
591
709
  * Precise run takes an art style there too, and its `preciseArtStyleAlone`
592
- * whether that art style alone is the run's change.
710
+ * whether that art style alone is the run's change. Its `customStyle` says,
711
+ * per engine, whether a run takes the style in your own words there
712
+ * (`direction: { customStyle }`, and {@link describeStyle}).
593
713
  * Public (no sign-in needed); the answer may be up to a minute old.
594
714
  */
595
715
  styleChoice(): Promise<VideoRemakeStyleChoice>;
716
+ /**
717
+ * Whether the Video Remake page shows its Advanced options
718
+ * (`GET /v1/video-remake/advanced`): `show` is `true` where the page offers
719
+ * `prepareReferences` and `prePrompt`, and `false` until Nodaro turns them
720
+ * on. One answer for the whole page, whatever the engine, so an app built
721
+ * on the SDK can show or hide the same options. It describes the page only:
722
+ * {@link run} and {@link estimate} take both fields as sent, whatever it
723
+ * answers.
724
+ * Public (no sign-in needed); the answer may be up to a minute old.
725
+ */
726
+ advanced(): Promise<VideoRemakeAdvanced>;
727
+ /**
728
+ * Put an image's visual style into words
729
+ * (`POST /v1/video-remake/describe-style`): `text` describes how the image
730
+ * is made and how it looks (the medium, line, colour, lighting and
731
+ * texture), never who or what it shows, ready to show, edit and send as a
732
+ * run's `direction: { customStyle: text }`. With `note`, a wish about the
733
+ * style is folded in ("like this, but darker"). Free: it starts no job and
734
+ * charges nothing, and nothing of the image is kept. Needs a signed-in
735
+ * account, and is limited to 10 calls a minute per account. Only where
736
+ * {@link styleChoice} answers `customStyle` true (403
737
+ * `custom_style_not_available` elsewhere). Refusals:
738
+ * {@link VideoRemakeCustomStyleRefusalCode}.
739
+ */
740
+ describeStyle(params: VideoRemakeDescribeStyleParams): Promise<VideoRemakeDescribedStyle>;
741
+ /**
742
+ * The art styles Video Remake's art style picker offers
743
+ * (`GET /v1/video-remake/art-styles`), in the picker's order: each with its
744
+ * `id` (a run's `direction.style`), its name in `locale` (a Nodaro language
745
+ * id such as `"he"`, `"ja"`, `"ko"` or `"pt-BR"`; English when left out,
746
+ * for a language Nodaro does not have, and for a style the language does
747
+ * not name) and its preview, a clip and a still cut from it. The list is
748
+ * empty where there is nothing to offer: a deployment that does not show
749
+ * Nodaro's previews, or one without Video Remake or its art styles. It
750
+ * lists what the picker shows; whether a run takes an art style on an
751
+ * engine is {@link styleChoice}'s to say.
752
+ * Public (no sign-in needed); the answer may be up to five minutes old.
753
+ */
754
+ artStyles(params?: {
755
+ locale?: string;
756
+ }): Promise<VideoRemakeArtStyle[]>;
596
757
  /** Quote a run before starting it (`POST /v1/video-remake/estimate`); spends nothing. */
597
758
  estimate(params: VideoRemakeParams): Promise<VideoRemakeEstimate>;
598
759
  /**
@@ -673,4 +834,4 @@ type CastSwapStyleChoiceOption = VideoRemakeStyleChoiceOption;
673
834
  /** @deprecated use {@link VideoRemakeStyleChoice}. */
674
835
  type CastSwapStyleChoice = VideoRemakeStyleChoice;
675
836
 
676
- export { type VideoRemakeEstimate as A, type VideoRemakeFaceMasking as B, type CastSwapEngine as C, type VideoRemakeFaceMaskingZone as D, type VideoRemakeFullQualityEstimate as E, type VideoRemakeFullQualityKind as F, type VideoRemakeFullQualityParams as G, type VideoRemakeFullQualityRefusalCode as H, type VideoRemakeFullQualityResult as I, type VideoRemakeLocationRole as J, type VideoRemakeMotionLength as K, type VideoRemakeParams as L, type VideoRemakePersonRole as M, type VideoRemakePetRole as N, type VideoRemakeProductRole as O, type VideoRemakeReference as P, VideoRemakeResource as Q, type VideoRemakeRole as R, type VideoRemakeRolePreviewSettings as S, type VideoRemakeRunOptions as T, type VideoRemakeStyle as U, type VideoRemakeEngine as V, type VideoRemakeStyleChoice as W, type VideoRemakeStyleChoiceOption as X, type VideoRemakeTraitSource as Y, type CastSwapEngineLegacyId as a, type CastSwapEstimate as b, type CastSwapFaceMasking as c, type CastSwapFaceMaskingZone as d, type CastSwapFullQualityEstimate as e, type CastSwapFullQualityKind as f, type CastSwapFullQualityParams as g, type CastSwapFullQualityRefusalCode as h, type CastSwapFullQualityResult as i, type CastSwapKlingLength as j, type CastSwapLocationRole as k, type CastSwapMotionLength as l, type CastSwapParams as m, type CastSwapPersonRole as n, type CastSwapPetRole as o, type CastSwapProductRole as p, type CastSwapReference as q, CastSwapResource as r, type CastSwapRole as s, type CastSwapRolePreviewSettings as t, type CastSwapRunOptions as u, type CastSwapStyle as v, type CastSwapStyleChoice as w, type CastSwapStyleChoiceOption as x, type CastSwapTraitSource as y, type VideoRemakeEngineLegacyId as z };
837
+ export { type VideoRemakeRunOptions as $, type VideoRemakeArtStyleDirection as A, type VideoRemakeCustomStyleDirection as B, type CastSwapEngine as C, type VideoRemakeCustomStyleRefusalCode as D, type VideoRemakeDescribeStyleParams as E, type VideoRemakeDescribedStyle as F, type VideoRemakeEngine as G, type VideoRemakeEngineLegacyId as H, type VideoRemakeEstimate as I, type VideoRemakeFaceMasking as J, type VideoRemakeFaceMaskingZone as K, type VideoRemakeFullQualityEstimate as L, type VideoRemakeFullQualityKind as M, type VideoRemakeFullQualityParams as N, type VideoRemakeFullQualityRefusalCode as O, type VideoRemakeFullQualityResult as P, type VideoRemakeLocationRole as Q, type VideoRemakeMotionLength as R, type VideoRemakeParams as S, type VideoRemakePersonRole as T, type VideoRemakePetRole as U, type VideoRemakeAdvanced as V, type VideoRemakeProductRole as W, type VideoRemakeReference as X, VideoRemakeResource as Y, type VideoRemakeRole as Z, type VideoRemakeRolePreviewSettings as _, type CastSwapEngineLegacyId as a, type VideoRemakeStyle as a0, type VideoRemakeStyleChoice as a1, type VideoRemakeStyleChoiceOption as a2, type VideoRemakeStyleMedium as a3, type VideoRemakeStyleTones as a4, type VideoRemakeTraitSource as a5, type CastSwapEstimate as b, type CastSwapFaceMasking as c, type CastSwapFaceMaskingZone as d, type CastSwapFullQualityEstimate as e, type CastSwapFullQualityKind as f, type CastSwapFullQualityParams as g, type CastSwapFullQualityRefusalCode as h, type CastSwapFullQualityResult as i, type CastSwapKlingLength as j, type CastSwapLocationRole as k, type CastSwapMotionLength as l, type CastSwapParams as m, type CastSwapPersonRole as n, type CastSwapPetRole as o, type CastSwapProductRole as p, type CastSwapReference as q, CastSwapResource as r, type CastSwapRole as s, type CastSwapRolePreviewSettings as t, type CastSwapRunOptions as u, type CastSwapStyle as v, type CastSwapStyleChoice as w, type CastSwapStyleChoiceOption as x, type CastSwapTraitSource as y, type VideoRemakeArtStyle as z };
@@ -304,10 +304,14 @@ interface VideoRemakeParams {
304
304
  * the engine, where it is that run's change), and one with a pre or post prompt
305
305
  * runs as any other art-style run. The job records it in
306
306
  * `input_data.direction`.
307
+ *
308
+ * A custom style: `{ customStyle: "<text>" }` in place of `{ style }` gives
309
+ * the style in your own words (see {@link VideoRemakeCustomStyleDirection}),
310
+ * only where {@link VideoRemakeResource.styleChoice} answers `customStyle`
311
+ * true for the engine. It goes wherever a catalog art style goes and counts
312
+ * as the run's change wherever one does. Never both: send one of the two.
307
313
  */
308
- direction?: {
309
- style: string;
310
- };
314
+ direction?: VideoRemakeArtStyleDirection | VideoRemakeCustomStyleDirection;
311
315
  /**
312
316
  * Nodaro Pulse only (Prism ignores it): which end of the clip is cut to
313
317
  * whole seconds (see {@link VideoRemakeMotionLength}). Default `"cut-end"`.
@@ -353,6 +357,83 @@ interface VideoRemakeParams {
353
357
  origin?: string;
354
358
  }
355
359
  /** What a run would cost, in credits. */
360
+ /** A run's art style from the catalog: a `style` picker id (see {@link VideoRemakeParams}'s `direction`). */
361
+ interface VideoRemakeArtStyleDirection {
362
+ style: string;
363
+ customStyle?: never;
364
+ }
365
+ /**
366
+ * A run's custom style: the visual style in your own words, in place of a
367
+ * catalog art style. Describe the look only: the medium (drawn, 3D-rendered
368
+ * or filmed), line, colour, lighting and texture; not who or what is in the
369
+ * video. At most 600 characters, never blank. The words are used as written;
370
+ * the run itself works out whether the style is drawn, rendered or filmed, at
371
+ * no extra charge (the estimate is the same as for a catalog art style). The
372
+ * job records the text as sent in `input_data.direction.customStyle`.
373
+ * {@link VideoRemakeResource.describeStyle} writes such a text from an image.
374
+ *
375
+ * Nodaro Prism only, on a direct run, and only where
376
+ * {@link VideoRemakeResource.styleChoice} answers `customStyle` true for the
377
+ * engine. Refusals: {@link VideoRemakeCustomStyleRefusalCode}.
378
+ */
379
+ interface VideoRemakeCustomStyleDirection {
380
+ customStyle: string;
381
+ style?: never;
382
+ }
383
+ /**
384
+ * The `code` of a refusal that concerns a custom style (`NodaroError.code`),
385
+ * all before anything is charged.
386
+ *
387
+ * On {@link VideoRemakeResource.run} and {@link VideoRemakeResource.estimate}:
388
+ * - `custom_style_with_art_style` (400): `direction` carries both `style` and
389
+ * `customStyle`; send one;
390
+ * - `custom_style_empty` (400): the text is blank, or nothing is left of it
391
+ * once its curly braces are taken out;
392
+ * - `custom_style_too_long` (400): more than 600 characters;
393
+ * - `custom_style_not_available` (403): a custom style is not offered here
394
+ * (see {@link VideoRemakeStyleChoice.customStyle}); choose a catalog art
395
+ * style instead;
396
+ * - `raw_reference_token` (400): the text holds `{image:…}`, `{video:…}` or
397
+ * `{audio:…}`;
398
+ * - `art_style_needs_prism` / `art_style_needs_flex` (400): where a catalog
399
+ * art style could not go either (Nodaro Pulse, a trend run).
400
+ *
401
+ * On {@link VideoRemakeResource.describeStyle}:
402
+ * - `unauthorized` (401): no authenticated user;
403
+ * - `validation_error` (400), `unsafe_url` (400): the body, or an address that
404
+ * is not a public http(s) one;
405
+ * - `custom_style_not_available` (403): as above;
406
+ * - `image_unreadable` (400): the image could not be fetched, is larger than
407
+ * 10 MB, or is not a PNG, JPEG, WebP or GIF;
408
+ * - `describe_style_failed` (502): the image could not be described just now;
409
+ * try again;
410
+ * - `style_not_described` (422): no style could be described from this image;
411
+ * try another, or write the style yourself;
412
+ * - `rate_limit_exceeded` (429): too many calls in a minute for this account.
413
+ *
414
+ * Open-ended: a code not listed here may still arrive.
415
+ */
416
+ type VideoRemakeCustomStyleRefusalCode = "custom_style_with_art_style" | "custom_style_empty" | "custom_style_too_long" | "custom_style_not_available" | "raw_reference_token" | "art_style_needs_prism" | "art_style_needs_flex" | "unauthorized" | "validation_error" | "unsafe_url" | "image_unreadable" | "describe_style_failed" | "style_not_described" | "rate_limit_exceeded" | (string & {});
417
+ /** What {@link VideoRemakeResource.describeStyle} takes. */
418
+ interface VideoRemakeDescribeStyleParams {
419
+ /** A public http(s) image (PNG, JPEG, WebP or GIF, at most 10 MB) whose visual style is put into words. */
420
+ imageUrl: string;
421
+ /** A wish about the style, at most 600 characters ("like this, but darker"). */
422
+ note?: string;
423
+ }
424
+ /** The medium a described style reads as: drawn or painted, computer-rendered or modelled, or filmed. */
425
+ type VideoRemakeStyleMedium = "2d" | "3d" | "photo";
426
+ /** The tones a described style reads as. */
427
+ type VideoRemakeStyleTones = "colour" | "black-and-white" | "one-colour";
428
+ /** What {@link VideoRemakeResource.describeStyle} answers. */
429
+ interface VideoRemakeDescribedStyle {
430
+ /** The image's visual style in words (never its content), at most 600 characters: ready to edit and send as `direction.customStyle`. */
431
+ text: string;
432
+ /** How the description reads, a hint for an interface only: a run works out its style's medium itself, from the words it is sent. */
433
+ medium?: VideoRemakeStyleMedium;
434
+ /** As `medium`. */
435
+ tones?: VideoRemakeStyleTones;
436
+ }
356
437
  interface VideoRemakeEstimate {
357
438
  /**
358
439
  * The engine the run would use, by its public id (absent from an older
@@ -561,6 +642,43 @@ interface VideoRemakeStyleChoice {
561
642
  * missing from it: `false`.
562
643
  */
563
644
  preciseArtStyleAlone?: Partial<Record<VideoRemakeEngine, boolean>>;
645
+ /**
646
+ * Per engine, whether a direct run takes a custom style there: the style in
647
+ * your own words (`direction: { customStyle }`, see
648
+ * {@link VideoRemakeCustomStyleDirection}) in place of a catalog art style,
649
+ * and {@link VideoRemakeResource.describeStyle} with it. `true` only where
650
+ * the engine takes one and Nodaro offers it on this deployment. Nodaro
651
+ * Pulse is always `false` (it takes no art style). Absent from an older
652
+ * server, and an engine missing from it: `false` (offer the catalog's art
653
+ * styles alone; a custom style sent anyway is refused).
654
+ */
655
+ customStyle?: Partial<Record<VideoRemakeEngine, boolean>>;
656
+ }
657
+ /**
658
+ * What {@link VideoRemakeResource.advanced} answers: whether the Video Remake
659
+ * page shows its Advanced options.
660
+ */
661
+ interface VideoRemakeAdvanced {
662
+ /**
663
+ * Whether the Video Remake page shows `prepareReferences` and `prePrompt`
664
+ * under its Advanced options: `false` until Nodaro turns them on, one
665
+ * setting for the whole page, the same for every engine.
666
+ */
667
+ show: boolean;
668
+ }
669
+ /**
670
+ * One art style of {@link VideoRemakeResource.artStyles}: a style Video
671
+ * Remake's art style picker offers, with its preview.
672
+ */
673
+ interface VideoRemakeArtStyle {
674
+ /** The style's id: what a run takes as `direction.style` (an id of the `style` picker catalog). */
675
+ id: string;
676
+ /** The style's name in the language asked for; English where that language does not name it. */
677
+ label: string;
678
+ /** A short clip of real footage wiping into the style (an absolute https address). */
679
+ clipUrl: string;
680
+ /** A still frame cut from that clip (an absolute https address). */
681
+ stillUrl: string;
564
682
  }
565
683
  declare class VideoRemakeResource {
566
684
  private client;
@@ -589,10 +707,53 @@ declare class VideoRemakeResource {
589
707
  * art style alone is refused, and one with a pre or post prompt runs as any
590
708
  * other art-style run. Its `preciseArtStyle` says, per engine, whether a
591
709
  * Precise run takes an art style there too, and its `preciseArtStyleAlone`
592
- * whether that art style alone is the run's change.
710
+ * whether that art style alone is the run's change. Its `customStyle` says,
711
+ * per engine, whether a run takes the style in your own words there
712
+ * (`direction: { customStyle }`, and {@link describeStyle}).
593
713
  * Public (no sign-in needed); the answer may be up to a minute old.
594
714
  */
595
715
  styleChoice(): Promise<VideoRemakeStyleChoice>;
716
+ /**
717
+ * Whether the Video Remake page shows its Advanced options
718
+ * (`GET /v1/video-remake/advanced`): `show` is `true` where the page offers
719
+ * `prepareReferences` and `prePrompt`, and `false` until Nodaro turns them
720
+ * on. One answer for the whole page, whatever the engine, so an app built
721
+ * on the SDK can show or hide the same options. It describes the page only:
722
+ * {@link run} and {@link estimate} take both fields as sent, whatever it
723
+ * answers.
724
+ * Public (no sign-in needed); the answer may be up to a minute old.
725
+ */
726
+ advanced(): Promise<VideoRemakeAdvanced>;
727
+ /**
728
+ * Put an image's visual style into words
729
+ * (`POST /v1/video-remake/describe-style`): `text` describes how the image
730
+ * is made and how it looks (the medium, line, colour, lighting and
731
+ * texture), never who or what it shows, ready to show, edit and send as a
732
+ * run's `direction: { customStyle: text }`. With `note`, a wish about the
733
+ * style is folded in ("like this, but darker"). Free: it starts no job and
734
+ * charges nothing, and nothing of the image is kept. Needs a signed-in
735
+ * account, and is limited to 10 calls a minute per account. Only where
736
+ * {@link styleChoice} answers `customStyle` true (403
737
+ * `custom_style_not_available` elsewhere). Refusals:
738
+ * {@link VideoRemakeCustomStyleRefusalCode}.
739
+ */
740
+ describeStyle(params: VideoRemakeDescribeStyleParams): Promise<VideoRemakeDescribedStyle>;
741
+ /**
742
+ * The art styles Video Remake's art style picker offers
743
+ * (`GET /v1/video-remake/art-styles`), in the picker's order: each with its
744
+ * `id` (a run's `direction.style`), its name in `locale` (a Nodaro language
745
+ * id such as `"he"`, `"ja"`, `"ko"` or `"pt-BR"`; English when left out,
746
+ * for a language Nodaro does not have, and for a style the language does
747
+ * not name) and its preview, a clip and a still cut from it. The list is
748
+ * empty where there is nothing to offer: a deployment that does not show
749
+ * Nodaro's previews, or one without Video Remake or its art styles. It
750
+ * lists what the picker shows; whether a run takes an art style on an
751
+ * engine is {@link styleChoice}'s to say.
752
+ * Public (no sign-in needed); the answer may be up to five minutes old.
753
+ */
754
+ artStyles(params?: {
755
+ locale?: string;
756
+ }): Promise<VideoRemakeArtStyle[]>;
596
757
  /** Quote a run before starting it (`POST /v1/video-remake/estimate`); spends nothing. */
597
758
  estimate(params: VideoRemakeParams): Promise<VideoRemakeEstimate>;
598
759
  /**
@@ -673,4 +834,4 @@ type CastSwapStyleChoiceOption = VideoRemakeStyleChoiceOption;
673
834
  /** @deprecated use {@link VideoRemakeStyleChoice}. */
674
835
  type CastSwapStyleChoice = VideoRemakeStyleChoice;
675
836
 
676
- export { type VideoRemakeEstimate as A, type VideoRemakeFaceMasking as B, type CastSwapEngine as C, type VideoRemakeFaceMaskingZone as D, type VideoRemakeFullQualityEstimate as E, type VideoRemakeFullQualityKind as F, type VideoRemakeFullQualityParams as G, type VideoRemakeFullQualityRefusalCode as H, type VideoRemakeFullQualityResult as I, type VideoRemakeLocationRole as J, type VideoRemakeMotionLength as K, type VideoRemakeParams as L, type VideoRemakePersonRole as M, type VideoRemakePetRole as N, type VideoRemakeProductRole as O, type VideoRemakeReference as P, VideoRemakeResource as Q, type VideoRemakeRole as R, type VideoRemakeRolePreviewSettings as S, type VideoRemakeRunOptions as T, type VideoRemakeStyle as U, type VideoRemakeEngine as V, type VideoRemakeStyleChoice as W, type VideoRemakeStyleChoiceOption as X, type VideoRemakeTraitSource as Y, type CastSwapEngineLegacyId as a, type CastSwapEstimate as b, type CastSwapFaceMasking as c, type CastSwapFaceMaskingZone as d, type CastSwapFullQualityEstimate as e, type CastSwapFullQualityKind as f, type CastSwapFullQualityParams as g, type CastSwapFullQualityRefusalCode as h, type CastSwapFullQualityResult as i, type CastSwapKlingLength as j, type CastSwapLocationRole as k, type CastSwapMotionLength as l, type CastSwapParams as m, type CastSwapPersonRole as n, type CastSwapPetRole as o, type CastSwapProductRole as p, type CastSwapReference as q, CastSwapResource as r, type CastSwapRole as s, type CastSwapRolePreviewSettings as t, type CastSwapRunOptions as u, type CastSwapStyle as v, type CastSwapStyleChoice as w, type CastSwapStyleChoiceOption as x, type CastSwapTraitSource as y, type VideoRemakeEngineLegacyId as z };
837
+ export { type VideoRemakeRunOptions as $, type VideoRemakeArtStyleDirection as A, type VideoRemakeCustomStyleDirection as B, type CastSwapEngine as C, type VideoRemakeCustomStyleRefusalCode as D, type VideoRemakeDescribeStyleParams as E, type VideoRemakeDescribedStyle as F, type VideoRemakeEngine as G, type VideoRemakeEngineLegacyId as H, type VideoRemakeEstimate as I, type VideoRemakeFaceMasking as J, type VideoRemakeFaceMaskingZone as K, type VideoRemakeFullQualityEstimate as L, type VideoRemakeFullQualityKind as M, type VideoRemakeFullQualityParams as N, type VideoRemakeFullQualityRefusalCode as O, type VideoRemakeFullQualityResult as P, type VideoRemakeLocationRole as Q, type VideoRemakeMotionLength as R, type VideoRemakeParams as S, type VideoRemakePersonRole as T, type VideoRemakePetRole as U, type VideoRemakeAdvanced as V, type VideoRemakeProductRole as W, type VideoRemakeReference as X, VideoRemakeResource as Y, type VideoRemakeRole as Z, type VideoRemakeRolePreviewSettings as _, type CastSwapEngineLegacyId as a, type VideoRemakeStyle as a0, type VideoRemakeStyleChoice as a1, type VideoRemakeStyleChoiceOption as a2, type VideoRemakeStyleMedium as a3, type VideoRemakeStyleTones as a4, type VideoRemakeTraitSource as a5, type CastSwapEstimate as b, type CastSwapFaceMasking as c, type CastSwapFaceMaskingZone as d, type CastSwapFullQualityEstimate as e, type CastSwapFullQualityKind as f, type CastSwapFullQualityParams as g, type CastSwapFullQualityRefusalCode as h, type CastSwapFullQualityResult as i, type CastSwapKlingLength as j, type CastSwapLocationRole as k, type CastSwapMotionLength as l, type CastSwapParams as m, type CastSwapPersonRole as n, type CastSwapPetRole as o, type CastSwapProductRole as p, type CastSwapReference as q, CastSwapResource as r, type CastSwapRole as s, type CastSwapRolePreviewSettings as t, type CastSwapRunOptions as u, type CastSwapStyle as v, type CastSwapStyleChoice as w, type CastSwapStyleChoiceOption as x, type CastSwapTraitSource as y, type VideoRemakeArtStyle as z };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nodaro/sdk",
3
- "version": "2.76.0",
3
+ "version": "2.78.0",
4
4
  "description": "Typed REST client for the Nodaro API — workflows, jobs, executions, apps, characters, and more.",
5
5
  "type": "module",
6
6
  "license": "Apache-2.0",
@@ -347,8 +347,8 @@
347
347
  "test:watch": "vitest"
348
348
  },
349
349
  "dependencies": {
350
- "@nodaro/shared": "^3.70.0",
351
- "@nodaro/prompts": "^1.59.0"
350
+ "@nodaro/shared": "^3.72.0",
351
+ "@nodaro/prompts": "^1.60.0"
352
352
  },
353
353
  "peerDependencies": {
354
354
  "@fingerprintjs/fingerprintjs": "^5.2.0",