@fungi.computer/darkroom 0.1.0 → 0.2.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 (21) hide show
  1. package/README.md +12 -3
  2. package/dist/app-media-contracts.d.ts +28 -0
  3. package/dist/app-media-contracts.js +2 -0
  4. package/dist/browser-failure.d.ts +7 -0
  5. package/dist/browser-failure.js +3 -0
  6. package/dist/cloudflare/provider.js +14 -15
  7. package/dist/execution-error.d.ts +10 -2
  8. package/dist/execution-error.js +7 -0
  9. package/dist/media-binding.d.ts +8 -2
  10. package/dist/media-binding.js +21 -2
  11. package/dist/media-operation-owner.d.ts +48 -11
  12. package/dist/media-operation-owner.js +28 -16
  13. package/dist/media-operation.js +17 -7
  14. package/dist/server.d.ts +1 -1
  15. package/dist/server.js +2 -0
  16. package/docs/api/app-media-contracts.md +100 -110
  17. package/docs/api/browser.md +34 -2
  18. package/docs/api/cloudflare.md +35 -26
  19. package/docs/api/index.md +285 -343
  20. package/docs/api/server.md +561 -89
  21. package/package.json +3 -3
package/docs/api/index.md CHANGED
@@ -444,6 +444,16 @@ Supported raw provider representations, decoded by mediaProviderWireSchema.
444
444
 
445
445
  ---
446
446
 
447
+ ### MediaAiResult
448
+
449
+ ```ts
450
+ type MediaAiResult = Awaited<ReturnType<Ai["run"]>> | MediaProviderWire;
451
+ ```
452
+
453
+ Native Workers AI output or an already decoded provider representation.
454
+
455
+ ---
456
+
447
457
  ### MediaProviderOutputOptions
448
458
 
449
459
  ```ts
@@ -618,7 +628,7 @@ Maximum long-edge size accepted by an image viewer, in pixels.
618
628
  ### viewDimensionSchema
619
629
 
620
630
  ```ts
621
- const viewDimensionSchema: ZodNumber;
631
+ const viewDimensionSchema: ZodLazy<ZodNumber>;
622
632
  ```
623
633
 
624
634
  Decode a viewer long-edge size within the supported pixel bounds.
@@ -680,6 +690,7 @@ const mediaGenerationSettingsSchema: ZodObject<
680
690
  ZodEnum<{
681
691
  p480: "480p";
682
692
  p720: "720p";
693
+ p768: "768p";
683
694
  p1080: "1080p";
684
695
  p4k: "4k";
685
696
  }>
@@ -738,6 +749,7 @@ const mediaGenerationSelectionSchema: ZodObject<
738
749
  ZodEnum<{
739
750
  p480: "480p";
740
751
  p720: "720p";
752
+ p768: "768p";
741
753
  p1080: "1080p";
742
754
  p4k: "4k";
743
755
  }>
@@ -783,16 +795,18 @@ App selections contain paths; the host supplies the admitted Computer.
783
795
  ### mediaVideoReferenceSchema
784
796
 
785
797
  ```ts
786
- const mediaVideoReferenceSchema: ZodObject<
787
- {
788
- path: ZodString;
789
- role: ZodEnum<{
790
- first: "first-frame";
791
- last: "last-frame";
792
- reference: "reference";
793
- }>;
794
- },
795
- $strict
798
+ const mediaVideoReferenceSchema: ZodLazy<
799
+ ZodObject<
800
+ {
801
+ path: ZodString;
802
+ role: ZodEnum<{
803
+ first: "first-frame";
804
+ last: "last-frame";
805
+ reference: "reference";
806
+ }>;
807
+ },
808
+ $strict
809
+ >
796
810
  >;
797
811
  ```
798
812
 
@@ -803,54 +817,60 @@ Path-only video reference; the host supplies authority and reads its bytes.
803
817
  ### mediaVideoSelectionSchema
804
818
 
805
819
  ```ts
806
- const mediaVideoSelectionSchema: ZodObject<
807
- {
808
- model: ZodEnum<{
809
- seedance: "bytedance/seedance-2.0";
810
- seedanceFast: "bytedance/seedance-2.0-fast";
811
- seedanceMini: "bytedance/seedance-2.0-mini";
812
- veo: "google/veo-3.1";
813
- veoFast: "google/veo-3.1-fast";
814
- }>;
815
- prompt: ZodString;
816
- resolution: ZodOptional<
817
- ZodEnum<{
818
- p480: "480p";
819
- p720: "720p";
820
- p1080: "1080p";
821
- p4k: "4k";
822
- }>
823
- >;
824
- aspectRatio: ZodOptional<
825
- ZodEnum<{
826
- wide: "16:9";
827
- landscape: "4:3";
828
- square: "1:1";
829
- portrait: "3:4";
830
- tall: "9:16";
831
- ultrawide: "21:9";
832
- ultratall: "9:21";
833
- }>
834
- >;
835
- durationSeconds: ZodOptional<ZodNumber>;
836
- generateAudio: ZodOptional<ZodBoolean>;
837
- references: ZodOptional<
838
- ZodArray<
839
- ZodObject<
840
- {
841
- path: ZodString;
842
- role: ZodEnum<{
843
- first: "first-frame";
844
- last: "last-frame";
845
- reference: "reference";
846
- }>;
847
- },
848
- $strict
820
+ const mediaVideoSelectionSchema: ZodLazy<
821
+ ZodObject<
822
+ {
823
+ model: ZodEnum<{
824
+ seedance: "bytedance/seedance-2.0";
825
+ seedanceFast: "bytedance/seedance-2.0-fast";
826
+ seedanceMini: "bytedance/seedance-2.0-mini";
827
+ veo: "google/veo-3.1";
828
+ veoFast: "google/veo-3.1-fast";
829
+ minimaxH3Max: "minimax/h3-max";
830
+ }>;
831
+ prompt: ZodString;
832
+ resolution: ZodOptional<
833
+ ZodEnum<{
834
+ p480: "480p";
835
+ p720: "720p";
836
+ p768: "768p";
837
+ p1080: "1080p";
838
+ p4k: "4k";
839
+ }>
840
+ >;
841
+ aspectRatio: ZodOptional<
842
+ ZodEnum<{
843
+ wide: "16:9";
844
+ landscape: "4:3";
845
+ square: "1:1";
846
+ portrait: "3:4";
847
+ tall: "9:16";
848
+ ultrawide: "21:9";
849
+ ultratall: "9:21";
850
+ }>
851
+ >;
852
+ durationSeconds: ZodOptional<ZodNumber>;
853
+ generateAudio: ZodOptional<ZodBoolean>;
854
+ references: ZodOptional<
855
+ ZodArray<
856
+ ZodLazy<
857
+ ZodObject<
858
+ {
859
+ path: ZodString;
860
+ role: ZodEnum<{
861
+ first: "first-frame";
862
+ last: "last-frame";
863
+ reference: "reference";
864
+ }>;
865
+ },
866
+ $strict
867
+ >
868
+ >
849
869
  >
850
- >
851
- >;
852
- },
853
- $strict
870
+ >;
871
+ },
872
+ $strict
873
+ >
854
874
  >;
855
875
  ```
856
876
 
@@ -862,56 +882,13 @@ validateMediaVideoSelection.
862
882
  ### mediaProviderWireSchema
863
883
 
864
884
  ```ts
865
- const mediaProviderWireSchema: ZodUnion<
866
- readonly [
867
- ZodUnion<
868
- readonly [
869
- ZodObject<
870
- {
871
- image: ZodString;
872
- },
873
- $strip
874
- >,
875
- ZodObject<
876
- {
877
- image: ZodArray<
878
- ZodObject<
879
- {
880
- base64: ZodOptional<ZodString>;
881
- data: ZodOptional<ZodString>;
882
- url: ZodOptional<ZodURL>;
883
- },
884
- $strict
885
- >
886
- >;
887
- },
888
- $strip
889
- >,
890
- ZodObject<
891
- {
892
- images: ZodArray<
893
- ZodObject<
894
- {
895
- base64: ZodOptional<ZodString>;
896
- data: ZodOptional<ZodString>;
897
- url: ZodOptional<ZodURL>;
898
- },
899
- $strict
900
- >
901
- >;
902
- },
903
- $strip
904
- >,
905
- ]
906
- >,
907
- ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>,
908
- ZodCustom<Response, Response>,
909
- ZodCustom<
910
- ReadableStream<Uint8Array<ArrayBufferLike>>,
911
- ReadableStream<Uint8Array<ArrayBufferLike>>
912
- >,
913
- ]
914
- >;
885
+ const mediaProviderWireSchema: ZodLazy<ZodUnion<readonly [ZodLazy<ZodUnion<readonly [ZodObject<{
886
+ image: ZodString;
887
+ }, $strip>, ZodObject<{
888
+ image: ZodArray<ZodLazy<ZodObject<..., ...>>>;
889
+ }, $strip>, ZodObject<{
890
+ images: ZodArray<ZodLazy<ZodObject<..., ...>>>;
891
+ }, $strip>]>>, ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>, ZodCustom<Response, Response>, ZodCustom<ReadableStream<Uint8Array<ArrayBufferLike>>, ReadableStream<Uint8Array<ArrayBufferLike>>>]>>;
915
892
  ```
916
893
 
917
894
  Decode the Workers AI binding's raw output at the provider boundary.
@@ -952,31 +929,33 @@ value per model; never a price.
952
929
  ### mediaModelInputSchema
953
930
 
954
931
  ```ts
955
- const mediaModelInputSchema: ZodReadonly<
956
- ZodObject<
957
- {
958
- transport: ZodEnum<{
959
- json: "json";
960
- multipart: "multipart";
961
- }>;
962
- dimensions: ZodEnum<{
963
- none: "none";
964
- own: "own";
965
- }>;
966
- maxDimension: ZodNullable<ZodNumber>;
967
- defaultWidth: ZodNumber;
968
- defaultHeight: ZodNumber;
969
- steps: ZodEnum<{
970
- steps: "steps";
971
- num_steps: "num_steps";
972
- fixed: "fixed";
973
- }>;
974
- maxSteps: ZodNullable<ZodNumber>;
975
- defaultSteps: ZodNullable<ZodNumber>;
976
- referenceField: ZodNullable<ZodString>;
977
- maxReferences: ZodNumber;
978
- },
979
- $strict
932
+ const mediaModelInputSchema: ZodLazy<
933
+ ZodReadonly<
934
+ ZodObject<
935
+ {
936
+ transport: ZodEnum<{
937
+ json: "json";
938
+ multipart: "multipart";
939
+ }>;
940
+ dimensions: ZodEnum<{
941
+ none: "none";
942
+ own: "own";
943
+ }>;
944
+ maxDimension: ZodNullable<ZodNumber>;
945
+ defaultWidth: ZodNumber;
946
+ defaultHeight: ZodNumber;
947
+ steps: ZodEnum<{
948
+ steps: "steps";
949
+ num_steps: "num_steps";
950
+ fixed: "fixed";
951
+ }>;
952
+ maxSteps: ZodNullable<ZodNumber>;
953
+ defaultSteps: ZodNullable<ZodNumber>;
954
+ referenceField: ZodNullable<ZodString>;
955
+ maxReferences: ZodNumber;
956
+ },
957
+ $strict
958
+ >
980
959
  >
981
960
  >;
982
961
  ```
@@ -994,6 +973,7 @@ const mediaVideoModelIdSchema: ZodEnum<{
994
973
  seedanceMini: "bytedance/seedance-2.0-mini";
995
974
  veo: "google/veo-3.1";
996
975
  veoFast: "google/veo-3.1-fast";
976
+ minimaxH3Max: "minimax/h3-max";
997
977
  }>;
998
978
  ```
999
979
 
@@ -1007,6 +987,7 @@ Verified Unified AI video identifiers; no inferred family aliases.
1007
987
  const mediaVideoResolutionSchema: ZodEnum<{
1008
988
  p480: "480p";
1009
989
  p720: "720p";
990
+ p768: "768p";
1010
991
  p1080: "1080p";
1011
992
  p4k: "4k";
1012
993
  }>;
@@ -1051,28 +1032,31 @@ Explicit reference meaning; frame mode and reference mode are exclusive.
1051
1032
  ### mediaVideoFormatSchema
1052
1033
 
1053
1034
  ```ts
1054
- const mediaVideoFormatSchema: ZodReadonly<
1055
- ZodObject<
1056
- {
1057
- resolution: ZodEnum<{
1058
- p480: "480p";
1059
- p720: "720p";
1060
- p1080: "1080p";
1061
- p4k: "4k";
1062
- }>;
1063
- aspectRatio: ZodEnum<{
1064
- wide: "16:9";
1065
- landscape: "4:3";
1066
- square: "1:1";
1067
- portrait: "3:4";
1068
- tall: "9:16";
1069
- ultrawide: "21:9";
1070
- ultratall: "9:21";
1071
- }>;
1072
- width: ZodNumber;
1073
- height: ZodNumber;
1074
- },
1075
- $strict
1035
+ const mediaVideoFormatSchema: ZodLazy<
1036
+ ZodReadonly<
1037
+ ZodObject<
1038
+ {
1039
+ resolution: ZodEnum<{
1040
+ p480: "480p";
1041
+ p720: "720p";
1042
+ p768: "768p";
1043
+ p1080: "1080p";
1044
+ p4k: "4k";
1045
+ }>;
1046
+ aspectRatio: ZodEnum<{
1047
+ wide: "16:9";
1048
+ landscape: "4:3";
1049
+ square: "1:1";
1050
+ portrait: "3:4";
1051
+ tall: "9:16";
1052
+ ultrawide: "21:9";
1053
+ ultratall: "9:21";
1054
+ }>;
1055
+ width: ZodNumber;
1056
+ height: ZodNumber;
1057
+ },
1058
+ $strict
1059
+ >
1076
1060
  >
1077
1061
  >;
1078
1062
  ```
@@ -1084,105 +1068,65 @@ One nominal size used to select provider resolution and aspect.
1084
1068
  ### mediaVideoSchema
1085
1069
 
1086
1070
  ```ts
1087
- const mediaVideoSchema: ZodReadonly<
1088
- ZodObject<
1089
- {
1090
- minSeconds: ZodNumber;
1091
- maxSeconds: ZodNumber;
1092
- defaultSeconds: ZodNumber;
1093
- durations: ZodReadonly<ZodArray<ZodNumber>>;
1094
- provider: ZodEnum<{
1095
- seedance: "seedance";
1096
- veo: "veo";
1097
- }>;
1098
- formats: ZodReadonly<
1099
- ZodArray<
1100
- ZodReadonly<
1101
- ZodObject<
1102
- {
1103
- resolution: ZodEnum<{
1104
- p480: "480p";
1105
- p720: "720p";
1106
- p1080: "1080p";
1107
- p4k: "4k";
1108
- }>;
1109
- aspectRatio: ZodEnum<{
1110
- wide: "16:9";
1111
- landscape: "4:3";
1112
- square: "1:1";
1113
- portrait: "3:4";
1114
- tall: "9:16";
1115
- ultrawide: "21:9";
1116
- ultratall: "9:21";
1117
- }>;
1118
- width: ZodNumber;
1119
- height: ZodNumber;
1120
- },
1121
- $strict
1122
- >
1123
- >
1124
- >
1125
- >;
1126
- defaultResolution: ZodEnum<{
1127
- p480: "480p";
1128
- p720: "720p";
1129
- p1080: "1080p";
1130
- p4k: "4k";
1131
- }>;
1132
- defaultAspectRatio: ZodEnum<{
1133
- wide: "16:9";
1134
- landscape: "4:3";
1135
- square: "1:1";
1136
- portrait: "3:4";
1137
- tall: "9:16";
1138
- ultrawide: "21:9";
1139
- ultratall: "9:21";
1140
- }>;
1141
- defaultGenerateAudio: ZodNullable<ZodBoolean>;
1142
- maxPromptLength: ZodNumber;
1143
- referenceRoles: ZodReadonly<
1144
- ZodArray<
1145
- ZodEnum<{
1146
- first: "first-frame";
1147
- last: "last-frame";
1148
- reference: "reference";
1149
- }>
1150
- >
1151
- >;
1152
- maxReferenceImages: ZodNumber;
1153
- referenceResolutions: ZodReadonly<
1154
- ZodArray<
1155
- ZodEnum<{
1156
- p480: "480p";
1157
- p720: "720p";
1158
- p1080: "1080p";
1159
- p4k: "4k";
1160
- }>
1161
- >
1162
- >;
1163
- prices: ZodReadonly<
1164
- ZodArray<
1165
- ZodReadonly<
1166
- ZodObject<
1167
- {
1168
- resolution: ZodEnum<{
1169
- p480: "480p";
1170
- p720: "720p";
1171
- p1080: "1080p";
1172
- p4k: "4k";
1173
- }>;
1174
- silentMilliunitsPerSecond: ZodNumber;
1175
- audioMilliunitsPerSecond: ZodNumber;
1176
- },
1177
- $strict
1178
- >
1179
- >
1180
- >
1181
- >;
1182
- },
1183
- $strict
1184
- >
1185
- >;
1071
+ const mediaVideoSchema: ZodLazy<ZodReadonly<ZodObject<{
1072
+ minSeconds: ZodNumber;
1073
+ maxSeconds: ZodNumber;
1074
+ defaultSeconds: ZodNumber;
1075
+ durations: ZodReadonly<ZodArray<ZodNumber>>;
1076
+ provider: ZodEnum<{
1077
+ seedance: "seedance";
1078
+ veo: "veo";
1079
+ minimax: "minimax";
1080
+ }>;
1081
+ formats: ZodReadonly<ZodArray<ZodLazy<ZodReadonly<ZodObject<{
1082
+ resolution: ZodEnum<...>;
1083
+ aspectRatio: ZodEnum<...>;
1084
+ width: ZodNumber;
1085
+ height: ZodNumber;
1086
+ }, $strict>>>>>;
1087
+ defaultResolution: ZodEnum<{
1088
+ p480: "480p";
1089
+ p720: "720p";
1090
+ p768: "768p";
1091
+ p1080: "1080p";
1092
+ p4k: "4k";
1093
+ }>;
1094
+ defaultAspectRatio: ZodEnum<{
1095
+ wide: "16:9";
1096
+ landscape: "4:3";
1097
+ square: "1:1";
1098
+ portrait: "3:4";
1099
+ tall: "9:16";
1100
+ ultrawide: "21:9";
1101
+ ultratall: "9:21";
1102
+ }>;
1103
+ defaultGenerateAudio: ZodNullable<ZodBoolean>;
1104
+ maxPromptLength: ZodNumber;
1105
+ referenceRoles: ZodReadonly<ZodArray<ZodEnum<{
1106
+ first: "first-frame";
1107
+ last: "last-frame";
1108
+ reference: "reference";
1109
+ }>>>;
1110
+ maxReferenceImages: ZodNumber;
1111
+ referenceResolutions: ZodReadonly<ZodArray<ZodEnum<{
1112
+ p480: "480p";
1113
+ p720: "720p";
1114
+ p768: "768p";
1115
+ p1080: "1080p";
1116
+ p4k: "4k";
1117
+ }>>>;
1118
+ prices: ZodReadonly<ZodArray<ZodReadonly<ZodObject<{
1119
+ resolution: ZodEnum<{
1120
+ p480: ...;
1121
+ p720: ...;
1122
+ p768: ...;
1123
+ p1080: ...;
1124
+ p4k: ...;
1125
+ }>;
1126
+ silentMilliunitsPerSecond: ZodNumber;
1127
+ audioMilliunitsPerSecond: ZodNumber;
1128
+ }, $strict>>>>;
1129
+ }, $strict>>>;
1186
1130
  ```
1187
1131
 
1188
1132
  Verified video parameters and provider costs, checked 2026-10-11.
@@ -1210,7 +1154,7 @@ const mediaModelSchema: ZodReadonly<ZodObject<{
1210
1154
  jpeg: "jpeg";
1211
1155
  webp: "webp";
1212
1156
  }>>>;
1213
- input: ZodReadonly<ZodObject<{
1157
+ input: ZodLazy<ZodReadonly<ZodObject<{
1214
1158
  transport: ZodEnum<{
1215
1159
  json: "json";
1216
1160
  multipart: "multipart";
@@ -1231,9 +1175,9 @@ const mediaModelSchema: ZodReadonly<ZodObject<{
1231
1175
  defaultSteps: ZodNullable<ZodNumber>;
1232
1176
  referenceField: ZodNullable<ZodString>;
1233
1177
  maxReferences: ZodNumber;
1234
- }, $strict>>;
1178
+ }, $strict>>>;
1235
1179
  sizes: ZodNullable<ZodReadonly<ZodArray<ZodString>>>;
1236
- video: ZodNullable<ZodReadonly<ZodObject<{
1180
+ video: ZodNullable<ZodLazy<ZodReadonly<ZodObject<{
1237
1181
  minSeconds: ZodNumber;
1238
1182
  maxSeconds: ZodNumber;
1239
1183
  defaultSeconds: ZodNumber;
@@ -1241,11 +1185,13 @@ const mediaModelSchema: ZodReadonly<ZodObject<{
1241
1185
  provider: ZodEnum<{
1242
1186
  seedance: "seedance";
1243
1187
  veo: "veo";
1188
+ minimax: "minimax";
1244
1189
  }>;
1245
- formats: ZodReadonly<ZodArray<ZodReadonly<ZodObject<..., ...>>>>;
1190
+ formats: ZodReadonly<ZodArray<ZodLazy<...>>>;
1246
1191
  defaultResolution: ZodEnum<{
1247
1192
  p480: "480p";
1248
1193
  p720: "720p";
1194
+ p768: "768p";
1249
1195
  p1080: "1080p";
1250
1196
  p4k: "4k";
1251
1197
  }>;
@@ -1260,20 +1206,11 @@ const mediaModelSchema: ZodReadonly<ZodObject<{
1260
1206
  }>;
1261
1207
  defaultGenerateAudio: ZodNullable<ZodBoolean>;
1262
1208
  maxPromptLength: ZodNumber;
1263
- referenceRoles: ZodReadonly<ZodArray<ZodEnum<{
1264
- first: ...;
1265
- last: ...;
1266
- reference: ...;
1267
- }>>>;
1209
+ referenceRoles: ZodReadonly<ZodArray<ZodEnum<...>>>;
1268
1210
  maxReferenceImages: ZodNumber;
1269
- referenceResolutions: ZodReadonly<ZodArray<ZodEnum<{
1270
- p480: ...;
1271
- p720: ...;
1272
- p1080: ...;
1273
- p4k: ...;
1274
- }>>>;
1275
- prices: ZodReadonly<ZodArray<ZodReadonly<ZodObject<..., ...>>>>;
1276
- }, $strict>>>;
1211
+ referenceResolutions: ZodReadonly<ZodArray<ZodEnum<...>>>;
1212
+ prices: ZodReadonly<ZodArray<ZodReadonly<...>>>;
1213
+ }, $strict>>>>;
1277
1214
  }, $strict>>;
1278
1215
  ```
1279
1216
 
@@ -1353,19 +1290,19 @@ Validate caller settings and apply retained model defaults.
1353
1290
 
1354
1291
  #### Parameters
1355
1292
 
1356
- | Parameter | Type | Description |
1357
- | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
1358
- | `raw` | \{ `model`: `string`; `prompt`: `string`; `width`: `number`; `height`: `number`; `steps?`: `number`; `durationSeconds?`: `number`; `resolution?`: `"480p"` \| `"720p"` \| `"1080p"` \| `"4k"`; `aspectRatio?`: `"16:9"` \| `"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"` \| `"9:21"`; `generateAudio?`: `boolean`; `references?`: `object`[]; \} | - |
1359
- | `raw.model` | `string` | Provider catalog model identifier. |
1360
- | `raw.prompt` | `string` | Generation prompt. |
1361
- | `raw.width` | `number` | Requested image width or nominal video selector, not decoded MP4 dimensions. |
1362
- | `raw.height` | `number` | Requested image height or nominal video selector, not decoded MP4 dimensions. |
1363
- | `raw.steps?` | `number` | Model-specific inference step count. |
1364
- | `raw.durationSeconds?` | `number` | Requested video length in whole seconds. |
1365
- | `raw.resolution?` | `"480p"` \| `"720p"` \| `"1080p"` \| `"4k"` | Video resolution; must match the nominal width/height selector. |
1366
- | `raw.aspectRatio?` | `"16:9"` \| `"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"` \| `"9:21"` | Video aspect; must match the nominal width/height selector. |
1367
- | `raw.generateAudio?` | `boolean` | Video audio selection. |
1368
- | `raw.references?` | `object`[] | Host-authorized reference images. |
1293
+ | Parameter | Type | Description |
1294
+ | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
1295
+ | `raw` | \{ `model`: `string`; `prompt`: `string`; `width`: `number`; `height`: `number`; `steps?`: `number`; `durationSeconds?`: `number`; `resolution?`: `"480p"` \| `"720p"` \| `"768p"` \| `"1080p"` \| `"4k"`; `aspectRatio?`: `"16:9"` \| `"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"` \| `"9:21"`; `generateAudio?`: `boolean`; `references?`: `object`[]; \} | - |
1296
+ | `raw.model` | `string` | Provider catalog model identifier. |
1297
+ | `raw.prompt` | `string` | Generation prompt. |
1298
+ | `raw.width` | `number` | Requested image width or nominal video selector, not decoded MP4 dimensions. |
1299
+ | `raw.height` | `number` | Requested image height or nominal video selector, not decoded MP4 dimensions. |
1300
+ | `raw.steps?` | `number` | Model-specific inference step count. |
1301
+ | `raw.durationSeconds?` | `number` | Requested video length in whole seconds. |
1302
+ | `raw.resolution?` | `"480p"` \| `"720p"` \| `"768p"` \| `"1080p"` \| `"4k"` | Video resolution; must match the nominal width/height selector. |
1303
+ | `raw.aspectRatio?` | `"16:9"` \| `"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"` \| `"9:21"` | Video aspect; must match the nominal width/height selector. |
1304
+ | `raw.generateAudio?` | `boolean` | Video audio selection. |
1305
+ | `raw.references?` | `object`[] | Host-authorized reference images. |
1369
1306
 
1370
1307
  #### Returns
1371
1308
 
@@ -1385,19 +1322,19 @@ Validate path-only selections without inventing a Computer identity.
1385
1322
 
1386
1323
  #### Parameters
1387
1324
 
1388
- | Parameter | Type | Description |
1389
- | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
1390
- | `raw` | \{ `model`: `string`; `prompt`: `string`; `width`: `number`; `height`: `number`; `steps?`: `number`; `durationSeconds?`: `number`; `resolution?`: `"480p"` \| `"720p"` \| `"1080p"` \| `"4k"`; `aspectRatio?`: `"16:9"` \| `"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"` \| `"9:21"`; `generateAudio?`: `boolean`; `references?`: `object`[]; \} | - |
1391
- | `raw.model` | `string` | Provider catalog model identifier. |
1392
- | `raw.prompt` | `string` | Generation prompt. |
1393
- | `raw.width` | `number` | Requested image width or nominal video selector, not decoded MP4 dimensions. |
1394
- | `raw.height` | `number` | Requested image height or nominal video selector, not decoded MP4 dimensions. |
1395
- | `raw.steps?` | `number` | Model-specific inference step count. |
1396
- | `raw.durationSeconds?` | `number` | Requested video length in whole seconds. |
1397
- | `raw.resolution?` | `"480p"` \| `"720p"` \| `"1080p"` \| `"4k"` | Video resolution; must match the nominal width/height selector. |
1398
- | `raw.aspectRatio?` | `"16:9"` \| `"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"` \| `"9:21"` | Video aspect; must match the nominal width/height selector. |
1399
- | `raw.generateAudio?` | `boolean` | Video audio selection. |
1400
- | `raw.references?` | `object`[] | Host-authorized reference images. |
1325
+ | Parameter | Type | Description |
1326
+ | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
1327
+ | `raw` | \{ `model`: `string`; `prompt`: `string`; `width`: `number`; `height`: `number`; `steps?`: `number`; `durationSeconds?`: `number`; `resolution?`: `"480p"` \| `"720p"` \| `"768p"` \| `"1080p"` \| `"4k"`; `aspectRatio?`: `"16:9"` \| `"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"` \| `"9:21"`; `generateAudio?`: `boolean`; `references?`: `object`[]; \} | - |
1328
+ | `raw.model` | `string` | Provider catalog model identifier. |
1329
+ | `raw.prompt` | `string` | Generation prompt. |
1330
+ | `raw.width` | `number` | Requested image width or nominal video selector, not decoded MP4 dimensions. |
1331
+ | `raw.height` | `number` | Requested image height or nominal video selector, not decoded MP4 dimensions. |
1332
+ | `raw.steps?` | `number` | Model-specific inference step count. |
1333
+ | `raw.durationSeconds?` | `number` | Requested video length in whole seconds. |
1334
+ | `raw.resolution?` | `"480p"` \| `"720p"` \| `"768p"` \| `"1080p"` \| `"4k"` | Video resolution; must match the nominal width/height selector. |
1335
+ | `raw.aspectRatio?` | `"16:9"` \| `"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"` \| `"9:21"` | Video aspect; must match the nominal width/height selector. |
1336
+ | `raw.generateAudio?` | `boolean` | Video audio selection. |
1337
+ | `raw.references?` | `object`[] | Host-authorized reference images. |
1401
1338
 
1402
1339
  #### Returns
1403
1340
 
@@ -1417,16 +1354,16 @@ or billing admission.
1417
1354
 
1418
1355
  #### Parameters
1419
1356
 
1420
- | Parameter | Type | Description |
1421
- | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
1422
- | `raw` | \{ `model`: \| `"bytedance/seedance-2.0"` \| `"bytedance/seedance-2.0-fast"` \| `"bytedance/seedance-2.0-mini"` \| `"google/veo-3.1"` \| `"google/veo-3.1-fast"`; `prompt`: `string`; `resolution?`: `"480p"` \| `"720p"` \| `"1080p"` \| `"4k"`; `aspectRatio?`: `"16:9"` \| `"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"` \| `"9:21"`; `durationSeconds?`: `number`; `generateAudio?`: `boolean`; `references?`: `object`[]; \} | - |
1423
- | `raw.model` | \| `"bytedance/seedance-2.0"` \| `"bytedance/seedance-2.0-fast"` \| `"bytedance/seedance-2.0-mini"` \| `"google/veo-3.1"` \| `"google/veo-3.1-fast"` | Verified catalog model identifier. |
1424
- | `raw.prompt` | `string` | Trimmed prompt; Seedance allows 2,000 characters, Veo uses the retained host cap of 2,048. |
1425
- | `raw.resolution?` | `"480p"` \| `"720p"` \| `"1080p"` \| `"4k"` | Model-specific resolution, default 720p. |
1426
- | `raw.aspectRatio?` | `"16:9"` \| `"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"` \| `"9:21"` | Model-specific aspect, default 16:9. |
1427
- | `raw.durationSeconds?` | `number` | Whole seconds; Seedance 4–12, Veo exactly 4/6/8. |
1428
- | `raw.generateAudio?` | `boolean` | Veo defaults true; Seedance omits the provider option when unset. |
1429
- | `raw.references?` | `object`[] | Up to four references, with provider-specific roles and mode limits. |
1357
+ | Parameter | Type | Description |
1358
+ | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
1359
+ | `raw` | \{ `model`: \| `"bytedance/seedance-2.0"` \| `"bytedance/seedance-2.0-fast"` \| `"bytedance/seedance-2.0-mini"` \| `"google/veo-3.1"` \| `"google/veo-3.1-fast"` \| `"minimax/h3-max"`; `prompt`: `string`; `resolution?`: `"480p"` \| `"720p"` \| `"768p"` \| `"1080p"` \| `"4k"`; `aspectRatio?`: `"16:9"` \| `"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"` \| `"9:21"`; `durationSeconds?`: `number`; `generateAudio?`: `boolean`; `references?`: `object`[]; \} | - |
1360
+ | `raw.model` | \| `"bytedance/seedance-2.0"` \| `"bytedance/seedance-2.0-fast"` \| `"bytedance/seedance-2.0-mini"` \| `"google/veo-3.1"` \| `"google/veo-3.1-fast"` \| `"minimax/h3-max"` | Verified catalog model identifier. |
1361
+ | `raw.prompt` | `string` | Trimmed prompt; Seedance allows 2,000 characters, Veo uses the retained host cap of 2,048. |
1362
+ | `raw.resolution?` | `"480p"` \| `"720p"` \| `"768p"` \| `"1080p"` \| `"4k"` | Model-specific resolution, default 720p. |
1363
+ | `raw.aspectRatio?` | `"16:9"` \| `"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"` \| `"9:21"` | Model-specific aspect, default 16:9. |
1364
+ | `raw.durationSeconds?` | `number` | Whole seconds; Seedance 4–12, Veo exactly 4/6/8, MiniMax H3 Max 5–15. |
1365
+ | `raw.generateAudio?` | `boolean` | Veo defaults true; Seedance omits the provider option when unset; MiniMax H3 Max has no audio field and refuses an explicit choice. |
1366
+ | `raw.references?` | `object`[] | Up to four references, with provider-specific roles and mode limits. |
1430
1367
 
1431
1368
  #### Returns
1432
1369
 
@@ -1612,23 +1549,25 @@ function listMediaModels(): readonly Readonly<{
1612
1549
  maxSeconds: number;
1613
1550
  defaultSeconds: number;
1614
1551
  durations: readonly number[];
1615
- provider: "seedance" | "veo";
1552
+ provider: "seedance" | "veo" | "minimax";
1616
1553
  formats: readonly Readonly<{
1617
- resolution: "480p" | "720p" | "1080p" | "4k";
1554
+ resolution: "480p" | "720p" | "768p" | "1080p" | "4k";
1618
1555
  aspectRatio: "16:9" | "4:3" | "1:1" | "3:4" | "9:16" | "21:9" | "9:21";
1619
1556
  width: number;
1620
1557
  height: number;
1621
1558
  }>[];
1622
- defaultResolution: "480p" | "720p" | "1080p" | "4k";
1559
+ defaultResolution: "480p" | "720p" | "768p" | "1080p" | "4k";
1623
1560
  defaultAspectRatio:
1624
1561
  "16:9" | "4:3" | "1:1" | "3:4" | "9:16" | "21:9" | "9:21";
1625
1562
  defaultGenerateAudio: boolean | null;
1626
1563
  maxPromptLength: number;
1627
1564
  referenceRoles: readonly ("first-frame" | "last-frame" | "reference")[];
1628
1565
  maxReferenceImages: number;
1629
- referenceResolutions: readonly ("480p" | "720p" | "1080p" | "4k")[];
1566
+ referenceResolutions: readonly (
1567
+ "480p" | "720p" | "768p" | "1080p" | "4k"
1568
+ )[];
1630
1569
  prices: readonly Readonly<{
1631
- resolution: "480p" | "720p" | "1080p" | "4k";
1570
+ resolution: "480p" | "720p" | "768p" | "1080p" | "4k";
1632
1571
  silentMilliunitsPerSecond: number;
1633
1572
  audioMilliunitsPerSecond: number;
1634
1573
  }>[];
@@ -1650,19 +1589,19 @@ readonly `Readonly`\<\{ `id`: `string`; `label`: `string`; `kind`: `"image"` \|
1650
1589
  `referenceField`: `string` \| `null`; `maxReferences`: `number`; \}\>; `sizes`:
1651
1590
  readonly `string`[] \| `null`; `video`: \| `Readonly`\<\{ `minSeconds`:
1652
1591
  `number`; `maxSeconds`: `number`; `defaultSeconds`: `number`; `durations`:
1653
- readonly `number`[]; `provider`: `"seedance"` \| `"veo"`; `formats`: readonly
1654
- `Readonly`\<\{ `resolution`: `"480p"` \| `"720p"` \| `"1080p"` \| `"4k"`;
1655
- `aspectRatio`: `"16:9"` \| `"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"`
1656
- \| `"9:21"`; `width`: `number`; `height`: `number`; \}\>[]; `defaultResolution`:
1657
- `"480p"` \| `"720p"` \| `"1080p"` \| `"4k"`; `defaultAspectRatio`: `"16:9"` \|
1658
- `"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"` \| `"9:21"`;
1659
- `defaultGenerateAudio`: `boolean` \| `null`; `maxPromptLength`: `number`;
1660
- `referenceRoles`: readonly (`"first-frame"` \| `"last-frame"` \|
1661
- `"reference"`)[]; `maxReferenceImages`: `number`; `referenceResolutions`:
1662
- readonly (`"480p"` \| `"720p"` \| `"1080p"` \| `"4k"`)[]; `prices`: readonly
1663
- `Readonly`\<\{ `resolution`: `"480p"` \| `"720p"` \| `"1080p"` \| `"4k"`;
1664
- `silentMilliunitsPerSecond`: `number`; `audioMilliunitsPerSecond`: `number`;
1665
- \}\>[]; \}\> \| `null`; \}\>[]
1592
+ readonly `number`[]; `provider`: `"seedance"` \| `"veo"` \| `"minimax"`;
1593
+ `formats`: readonly `Readonly`\<\{ `resolution`: `"480p"` \| `"720p"` \|
1594
+ `"768p"` \| `"1080p"` \| `"4k"`; `aspectRatio`: `"16:9"` \| `"4:3"` \| `"1:1"`
1595
+ \| `"3:4"` \| `"9:16"` \| `"21:9"` \| `"9:21"`; `width`: `number`; `height`:
1596
+ `number`; \}\>[]; `defaultResolution`: `"480p"` \| `"720p"` \| `"768p"` \|
1597
+ `"1080p"` \| `"4k"`; `defaultAspectRatio`: `"16:9"` \| `"4:3"` \| `"1:1"` \|
1598
+ `"3:4"` \| `"9:16"` \| `"21:9"` \| `"9:21"`; `defaultGenerateAudio`: `boolean`
1599
+ \| `null`; `maxPromptLength`: `number`; `referenceRoles`: readonly
1600
+ (`"first-frame"` \| `"last-frame"` \| `"reference"`)[]; `maxReferenceImages`:
1601
+ `number`; `referenceResolutions`: readonly (`"480p"` \| `"720p"` \| `"768p"` \|
1602
+ `"1080p"` \| `"4k"`)[]; `prices`: readonly `Readonly`\<\{ `resolution`: `"480p"`
1603
+ \| `"720p"` \| `"768p"` \| `"1080p"` \| `"4k"`; `silentMilliunitsPerSecond`:
1604
+ `number`; `audioMilliunitsPerSecond`: `number`; \}\>[]; \}\> \| `null`; \}\>[]
1666
1605
 
1667
1606
  ---
1668
1607
 
@@ -1694,24 +1633,26 @@ function getMediaModel(id):
1694
1633
  maxSeconds: number;
1695
1634
  defaultSeconds: number;
1696
1635
  durations: readonly number[];
1697
- provider: "seedance" | "veo";
1636
+ provider: "seedance" | "veo" | "minimax";
1698
1637
  formats: readonly Readonly<{
1699
- resolution: "480p" | "720p" | "1080p" | "4k";
1638
+ resolution: "480p" | "720p" | "768p" | "1080p" | "4k";
1700
1639
  aspectRatio:
1701
1640
  "16:9" | "4:3" | "1:1" | "3:4" | "9:16" | "21:9" | "9:21";
1702
1641
  width: number;
1703
1642
  height: number;
1704
1643
  }>[];
1705
- defaultResolution: "480p" | "720p" | "1080p" | "4k";
1644
+ defaultResolution: "480p" | "720p" | "768p" | "1080p" | "4k";
1706
1645
  defaultAspectRatio:
1707
1646
  "16:9" | "4:3" | "1:1" | "3:4" | "9:16" | "21:9" | "9:21";
1708
1647
  defaultGenerateAudio: boolean | null;
1709
1648
  maxPromptLength: number;
1710
1649
  referenceRoles: readonly ("first-frame" | "last-frame" | "reference")[];
1711
1650
  maxReferenceImages: number;
1712
- referenceResolutions: readonly ("480p" | "720p" | "1080p" | "4k")[];
1651
+ referenceResolutions: readonly (
1652
+ "480p" | "720p" | "768p" | "1080p" | "4k"
1653
+ )[];
1713
1654
  prices: readonly Readonly<{
1714
- resolution: "480p" | "720p" | "1080p" | "4k";
1655
+ resolution: "480p" | "720p" | "768p" | "1080p" | "4k";
1715
1656
  silentMilliunitsPerSecond: number;
1716
1657
  audioMilliunitsPerSecond: number;
1717
1658
  }>[];
@@ -1740,19 +1681,20 @@ Find a model by provider identifier, returning undefined when it is absent.
1740
1681
  `referenceField`: `string` \| `null`; `maxReferences`: `number`; \}\>; `sizes`:
1741
1682
  readonly `string`[] \| `null`; `video`: \| `Readonly`\<\{ `minSeconds`:
1742
1683
  `number`; `maxSeconds`: `number`; `defaultSeconds`: `number`; `durations`:
1743
- readonly `number`[]; `provider`: `"seedance"` \| `"veo"`; `formats`: readonly
1744
- `Readonly`\<\{ `resolution`: `"480p"` \| `"720p"` \| `"1080p"` \| `"4k"`;
1745
- `aspectRatio`: `"16:9"` \| `"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"`
1746
- \| `"9:21"`; `width`: `number`; `height`: `number`; \}\>[]; `defaultResolution`:
1747
- `"480p"` \| `"720p"` \| `"1080p"` \| `"4k"`; `defaultAspectRatio`: `"16:9"` \|
1748
- `"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"` \| `"9:21"`;
1749
- `defaultGenerateAudio`: `boolean` \| `null`; `maxPromptLength`: `number`;
1750
- `referenceRoles`: readonly (`"first-frame"` \| `"last-frame"` \|
1751
- `"reference"`)[]; `maxReferenceImages`: `number`; `referenceResolutions`:
1752
- readonly (`"480p"` \| `"720p"` \| `"1080p"` \| `"4k"`)[]; `prices`: readonly
1753
- `Readonly`\<\{ `resolution`: `"480p"` \| `"720p"` \| `"1080p"` \| `"4k"`;
1754
- `silentMilliunitsPerSecond`: `number`; `audioMilliunitsPerSecond`: `number`;
1755
- \}\>[]; \}\> \| `null`; \}\> \| `undefined`
1684
+ readonly `number`[]; `provider`: `"seedance"` \| `"veo"` \| `"minimax"`;
1685
+ `formats`: readonly `Readonly`\<\{ `resolution`: `"480p"` \| `"720p"` \|
1686
+ `"768p"` \| `"1080p"` \| `"4k"`; `aspectRatio`: `"16:9"` \| `"4:3"` \| `"1:1"`
1687
+ \| `"3:4"` \| `"9:16"` \| `"21:9"` \| `"9:21"`; `width`: `number`; `height`:
1688
+ `number`; \}\>[]; `defaultResolution`: `"480p"` \| `"720p"` \| `"768p"` \|
1689
+ `"1080p"` \| `"4k"`; `defaultAspectRatio`: `"16:9"` \| `"4:3"` \| `"1:1"` \|
1690
+ `"3:4"` \| `"9:16"` \| `"21:9"` \| `"9:21"`; `defaultGenerateAudio`: `boolean`
1691
+ \| `null`; `maxPromptLength`: `number`; `referenceRoles`: readonly
1692
+ (`"first-frame"` \| `"last-frame"` \| `"reference"`)[]; `maxReferenceImages`:
1693
+ `number`; `referenceResolutions`: readonly (`"480p"` \| `"720p"` \| `"768p"` \|
1694
+ `"1080p"` \| `"4k"`)[]; `prices`: readonly `Readonly`\<\{ `resolution`: `"480p"`
1695
+ \| `"720p"` \| `"768p"` \| `"1080p"` \| `"4k"`; `silentMilliunitsPerSecond`:
1696
+ `number`; `audioMilliunitsPerSecond`: `number`; \}\>[]; \}\> \| `null`; \}\> \|
1697
+ `undefined`
1756
1698
 
1757
1699
  ---
1758
1700