@apicity/kie 0.5.4 → 0.6.1

package/dist/src/model-schemas.js

@@ -1,3 +1,22 @@
+import { HAPPYHORSE_DURATION_MAX_SECONDS, HAPPYHORSE_DURATION_MIN_SECONDS, Wan27VideoEditDurationValues, } from "./zod.js";
+const happyHorseDurationField = {
+    type: "integer",
+    minimum: HAPPYHORSE_DURATION_MIN_SECONDS,
+    maximum: HAPPYHORSE_DURATION_MAX_SECONDS,
+    default: 5,
+    description: `Duration in seconds, ${HAPPYHORSE_DURATION_MIN_SECONDS}-${HAPPYHORSE_DURATION_MAX_SECONDS} (default 5)`,
+};
+const happyHorse11AspectRatios = [
+    "16:9",
+    "9:16",
+    "3:4",
+    "4:3",
+    "4:5",
+    "5:4",
+    "1:1",
+    "9:21",
+    "21:9",
+];
 export const modelInputSchemas = {
     "kling-3.0/video": {
         type: "video",
@@ -169,6 +188,8 @@ export const modelInputSchemas = {
             prompt: {
                 type: "string",
                 required: true,
+                minLength: 1,
+                maxLength: 5000,
                 description: "Image generation prompt (max 5000 chars)",
             },
             aspect_ratio: {
@@ -191,11 +212,14 @@ export const modelInputSchemas = {
         fields: {
             prompt: {
                 type: "string",
+                maxLength: 390000,
                 description: "Modification prompt (max 390000 chars)",
             },
             image_urls: {
                 type: "array",
                 required: true,
+                minItems: 1,
+                maxItems: 1,
                 description: "Input image URL (exactly 1)",
                 items: { type: "string" },
             },
@@ -213,6 +237,8 @@ export const modelInputSchemas = {
             prompt: {
                 type: "string",
                 required: true,
+                minLength: 1,
+                maxLength: 5000,
                 description: "Video generation prompt (max 5000 chars)",
             },
             aspect_ratio: {
@@ -226,7 +252,10 @@ export const modelInputSchemas = {
                 description: "Generation mode (default normal)",
             },
             duration: {
-                type: "number",
+                type: "integer",
+                minimum: 6,
+                maximum: 30,
+                default: 6,
                 description: "Duration in seconds (6-30, default 6)",
             },
             resolution: {
@@ -245,10 +274,13 @@ export const modelInputSchemas = {
         fields: {
             prompt: {
                 type: "string",
-                description: "Video generation prompt (max 5000 chars)",
+                maxLength: 4096,
+                description: "Video generation prompt (max 4096 chars)",
             },
             image_urls: {
                 type: "array",
+                minItems: 1,
+                maxItems: 7,
                 description: "External JPEG/PNG/WEBP image URLs (max 7, 10MB each); mutually exclusive with task_id",
                 items: { type: "string" },
             },
@@ -256,15 +288,24 @@ export const modelInputSchemas = {
                 type: "string",
                 description: "Grok-generated image task ID; use with index and without image_urls",
             },
-            index: { type: "number", description: "Image index (0-5, default 0)" },
+            index: {
+                type: "integer",
+                minimum: 0,
+                maximum: 5,
+                default: 0,
+                description: "Image index (0-5, default 0)",
+            },
             mode: {
                 type: "string",
                 enum: ["fun", "normal", "spicy"],
-                description: "Generation mode (default normal; spicy is unavailable with external image_urls)",
+                description: "Generation mode (default normal; spicy requires task_id and is unavailable with external image_urls)",
             },
             duration: {
-                type: "number",
-                description: "Duration in seconds (6-30, default 6)",
+                type: "integer",
+                minimum: 6,
+                maximum: 30,
+                default: 6,
+                description: "Duration in whole seconds (6-30, default 6)",
             },
             resolution: {
                 type: "string",
@@ -289,11 +330,13 @@ export const modelInputSchemas = {
         fields: {
             prompt: {
                 type: "string",
+                maxLength: 4096,
                 description: "Video generation prompt (max 4096 chars)",
             },
             image_urls: {
                 type: "array",
                 required: true,
+                minItems: 1,
                 description: "Input image URLs (jpeg/png/webp, max 20MB each)",
                 items: { type: "string" },
             },
@@ -308,7 +351,10 @@ export const modelInputSchemas = {
                 description: "Output resolution (default 480p)",
             },
             duration: {
-                type: "number",
+                type: "integer",
+                minimum: 1,
+                maximum: 15,
+                default: 8,
                 description: "Duration in seconds (1-15, default 8)",
             },
             nsfw_checker: {
@@ -323,11 +369,14 @@ export const modelInputSchemas = {
             task_id: {
                 type: "string",
                 required: true,
+                maxLength: 100,
                 description: "Video task ID to extend (max 100 chars)",
             },
             prompt: {
                 type: "string",
                 required: true,
+                minLength: 1,
+                maxLength: 5000,
                 description: "Extension prompt",
             },
             extend_at: {
@@ -349,6 +398,7 @@ export const modelInputSchemas = {
             task_id: {
                 type: "string",
                 required: true,
+                maxLength: 100,
                 description: "Video task ID to upscale (max 100 chars)",
             },
         },
@@ -523,6 +573,70 @@ export const modelInputSchemas = {
             },
         },
     },
+    "bytedance/seedance-2-mini": {
+        type: "video",
+        fields: {
+            prompt: {
+                type: "string",
+                maxLength: 20000,
+                description: "Text prompt or description for the generated video",
+            },
+            reference_image_urls: {
+                type: "array",
+                default: [],
+                description: "Reference image URLs (JPEG, PNG, WEBP, JPG, or GIF; max 30 MB each)",
+                items: { type: "string" },
+            },
+            reference_video_urls: {
+                type: "array",
+                maxItems: 3,
+                default: [],
+                description: "Reference video URLs (MP4, MOV, or MKV; up to 3 videos, 15 seconds total)",
+                items: { type: "string" },
+            },
+            reference_audio_urls: {
+                type: "array",
+                maxItems: 3,
+                default: [],
+                description: "Reference audio URLs (MP3 or WAV; up to 3 clips, 15 seconds total)",
+                items: { type: "string" },
+            },
+            generate_audio: {
+                type: "boolean",
+                default: true,
+                description: "Generate accompanying audio (default true)",
+            },
+            resolution: {
+                type: "string",
+                enum: ["480p", "720p"],
+                default: "720p",
+                description: "Output resolution (default 720p)",
+            },
+            aspect_ratio: {
+                type: "string",
+                enum: ["16:9", "4:3", "1:1", "3:4", "9:16", "21:9", "adaptive"],
+                default: "16:9",
+                description: "Output aspect ratio (default 16:9)",
+            },
+            duration: {
+                type: "integer",
+                minimum: 4,
+                maximum: 15,
+                default: 15,
+                description: "Duration in seconds, 4-15 (default 15)",
+            },
+            web_search: {
+                type: "boolean",
+                default: false,
+                description: "Use online search (default false)",
+            },
+            nsfw_checker: {
+                type: "boolean",
+                default: true,
+                description: "Content safety filter (default true)",
+            },
+        },
+    },
     "nano-banana-2": {
         type: "image",
         fields: {
@@ -823,10 +937,13 @@ export const modelInputSchemas = {
             prompt: {
                 type: "string",
                 required: true,
+                minLength: 1,
+                maxLength: 5000,
                 description: "Positive prompt (max 5000 chars)",
             },
             negative_prompt: {
                 type: "string",
+                maxLength: 500,
                 description: "Negative prompt (max 500 chars)",
             },
             first_frame_url: {
@@ -851,7 +968,10 @@ export const modelInputSchemas = {
                 description: "Video resolution (default 1080p)",
             },
             duration: {
-                type: "number",
+                type: "integer",
+                minimum: 2,
+                maximum: 15,
+                default: 5,
                 description: "Duration in seconds, 2-15 (default 5)",
             },
             prompt_extend: {
@@ -863,7 +983,9 @@ export const modelInputSchemas = {
                 description: "AI-generated watermark (default false)",
             },
             seed: {
-                type: "number",
+                type: "integer",
+                minimum: 0,
+                maximum: 2147483647,
                 description: "Random seed (0-2147483647)",
             },
             nsfw_checker: {
@@ -878,10 +1000,13 @@ export const modelInputSchemas = {
             prompt: {
                 type: "string",
                 required: true,
+                minLength: 1,
+                maxLength: 5000,
                 description: "Positive prompt (max 5000 chars)",
             },
             negative_prompt: {
                 type: "string",
+                maxLength: 500,
                 description: "Negative prompt (max 500 chars)",
             },
             audio_url: {
@@ -899,7 +1024,10 @@ export const modelInputSchemas = {
                 description: "Video aspect ratio (default 16:9)",
             },
             duration: {
-                type: "number",
+                type: "integer",
+                minimum: 2,
+                maximum: 15,
+                default: 5,
                 description: "Duration in seconds, 2-15 (default 5)",
             },
             prompt_extend: {
@@ -911,7 +1039,9 @@ export const modelInputSchemas = {
                 description: "AI-generated watermark (default false)",
             },
             seed: {
-                type: "number",
+                type: "integer",
+                minimum: 0,
+                maximum: 2147483647,
                 description: "Random seed (0-2147483647)",
             },
             nsfw_checker: {
@@ -926,18 +1056,23 @@ export const modelInputSchemas = {
             prompt: {
                 type: "string",
                 required: true,
+                minLength: 1,
+                maxLength: 5000,
                 description: "Positive prompt (max 5000 chars)",
             },
             negative_prompt: {
                 type: "string",
+                maxLength: 500,
                 description: "Negative prompt (max 500 chars)",
             },
             reference_image: {
                 type: "array",
+                maxItems: 5,
                 description: "Array of reference image URLs (max 5 total with videos)",
             },
             reference_video: {
                 type: "array",
+                maxItems: 5,
                 description: "Array of reference video URLs (max 5 total with images)",
             },
             first_frame: {
@@ -959,7 +1094,10 @@ export const modelInputSchemas = {
                 description: "Video aspect ratio (default 16:9, ignored if first_frame set)",
             },
             duration: {
-                type: "number",
+                type: "integer",
+                minimum: 2,
+                maximum: 10,
+                default: 5,
                 description: "Duration in seconds, 2-10 (default 5)",
             },
             prompt_extend: {
@@ -971,7 +1109,9 @@ export const modelInputSchemas = {
                 description: "AI-generated watermark (default false)",
             },
             seed: {
-                type: "number",
+                type: "integer",
+                minimum: 0,
+                maximum: 2147483647,
                 description: "Random seed (0-2147483647)",
             },
             nsfw_checker: {
@@ -985,10 +1125,12 @@ export const modelInputSchemas = {
         fields: {
             prompt: {
                 type: "string",
+                maxLength: 5000,
                 description: "Positive prompt (max 5000 chars)",
             },
             negative_prompt: {
                 type: "string",
+                maxLength: 500,
                 description: "Negative prompt (max 500 chars)",
             },
             video_url: {
@@ -1011,7 +1153,11 @@ export const modelInputSchemas = {
                 description: "Output aspect ratio (default matches input video)",
             },
             duration: {
-                type: "number",
+                type: "integer",
+                enum: Wan27VideoEditDurationValues,
+                minimum: 0,
+                maximum: 10,
+                default: 0,
                 description: "Duration in seconds, 0 or 2-10 (default 0 = full input duration)",
             },
             audio_setting: {
@@ -1028,7 +1174,9 @@ export const modelInputSchemas = {
                 description: "AI-generated watermark (default false)",
             },
             seed: {
-                type: "number",
+                type: "integer",
+                minimum: 0,
+                maximum: 2147483647,
                 description: "Random seed (0-2147483647)",
             },
             nsfw_checker: {
@@ -1043,10 +1191,13 @@ export const modelInputSchemas = {
             prompt: {
                 type: "string",
                 required: true,
+                minLength: 1,
+                maxLength: 5000,
                 description: "Prompt for image generation or editing (max 5000 chars)",
             },
             input_urls: {
                 type: "array",
+                maxItems: 9,
                 description: "Array of input image URLs (max 9)",
             },
             aspect_ratio: {
@@ -1059,7 +1210,9 @@ export const modelInputSchemas = {
                 description: "Enable sequential/group image mode (default false)",
             },
             n: {
-                type: "number",
+                type: "integer",
+                minimum: 1,
+                maximum: 12,
                 description: "Number of images to generate: 1-4 when sequential=false (default 4), 1-12 when sequential=true (default 12)",
             },
             resolution: {
@@ -1073,6 +1226,8 @@ export const modelInputSchemas = {
             },
             color_palette: {
                 type: "array",
+                minItems: 3,
+                maxItems: 10,
                 description: "Custom color theme with 3-10 {hex, ratio} entries (only when sequential=false)",
             },
             bbox_list: {
@@ -1084,7 +1239,9 @@ export const modelInputSchemas = {
                 description: "Add watermark (default false)",
             },
             seed: {
-                type: "number",
+                type: "integer",
+                minimum: 0,
+                maximum: 2147483647,
                 description: "Random seed (0-2147483647)",
             },
             nsfw_checker: {
@@ -1099,10 +1256,13 @@ export const modelInputSchemas = {
             prompt: {
                 type: "string",
                 required: true,
+                minLength: 1,
+                maxLength: 5000,
                 description: "Prompt for image generation or editing (max 5000 chars)",
             },
             input_urls: {
                 type: "array",
+                maxItems: 9,
                 description: "Array of input image URLs (max 9)",
             },
             aspect_ratio: {
@@ -1115,7 +1275,9 @@ export const modelInputSchemas = {
                 description: "Enable sequential/group image mode (default false)",
             },
             n: {
-                type: "number",
+                type: "integer",
+                minimum: 1,
+                maximum: 12,
                 description: "Number of images to generate: 1-4 when sequential=false (default 4), 1-12 when sequential=true (default 12)",
             },
             resolution: {
@@ -1129,6 +1291,8 @@ export const modelInputSchemas = {
             },
             color_palette: {
                 type: "array",
+                minItems: 3,
+                maxItems: 10,
                 description: "Custom color theme with 3-10 {hex, ratio} entries (only when sequential=false)",
             },
             bbox_list: {
@@ -1140,7 +1304,9 @@ export const modelInputSchemas = {
                 description: "Add watermark (default false)",
             },
             seed: {
-                type: "number",
+                type: "integer",
+                minimum: 0,
+                maximum: 2147483647,
                 description: "Random seed (0-2147483647)",
             },
             nsfw_checker: {
@@ -1317,6 +1483,8 @@ export const modelInputSchemas = {
             prompt: {
                 type: "string",
                 required: true,
+                minLength: 1,
+                maxLength: 5000,
                 description: "Video generation prompt (max 5000 non-Chinese / 2500 Chinese chars)",
             },
             resolution: {
@@ -1329,12 +1497,11 @@ export const modelInputSchemas = {
                 enum: ["16:9", "9:16", "1:1", "4:3", "3:4"],
                 description: "Output aspect ratio (default 16:9)",
             },
-            duration: {
-                type: "number",
-                description: "Duration in seconds, 3-15 (default 5)",
-            },
+            duration: happyHorseDurationField,
             seed: {
-                type: "number",
+                type: "integer",
+                minimum: 0,
+                maximum: 2147483647,
                 description: "Random seed (0-2147483647)",
             },
         },
@@ -1344,11 +1511,14 @@ export const modelInputSchemas = {
         fields: {
             prompt: {
                 type: "string",
+                maxLength: 5000,
                 description: "Video generation prompt (max 5000 non-Chinese / 2500 Chinese chars)",
             },
             image_urls: {
                 type: "array",
                 required: true,
+                minItems: 1,
+                maxItems: 1,
                 description: "First-frame image URL list (exactly 1 image required)",
                 items: { type: "string" },
             },
@@ -1357,12 +1527,11 @@ export const modelInputSchemas = {
                 enum: ["720p", "1080p"],
                 description: "Output resolution (default 1080p)",
             },
-            duration: {
-                type: "number",
-                description: "Duration in seconds, 3-15 (default 5)",
-            },
+            duration: happyHorseDurationField,
             seed: {
-                type: "number",
+                type: "integer",
+                minimum: 0,
+                maximum: 2147483647,
                 description: "Random seed (0-2147483647)",
             },
         },
@@ -1373,11 +1542,15 @@ export const modelInputSchemas = {
             prompt: {
                 type: "string",
                 required: true,
+                minLength: 1,
+                maxLength: 5000,
                 description: "Video generation prompt (max 5000 non-Chinese / 2500 Chinese chars)",
             },
             reference_image: {
                 type: "array",
                 required: true,
+                minItems: 1,
+                maxItems: 9,
                 description: "Reference image URLs (1-9 images; order defines character1, character2, ...)",
                 items: { type: "string" },
             },
@@ -1391,12 +1564,11 @@ export const modelInputSchemas = {
                 enum: ["16:9", "9:16", "1:1", "4:3", "3:4"],
                 description: "Output aspect ratio (default 16:9)",
             },
-            duration: {
-                type: "number",
-                description: "Duration in seconds, 3-15 (default 5)",
-            },
+            duration: happyHorseDurationField,
             seed: {
-                type: "number",
+                type: "integer",
+                minimum: 0,
+                maximum: 2147483647,
                 description: "Random seed (0-2147483647)",
             },
         },
@@ -1407,6 +1579,8 @@ export const modelInputSchemas = {
             prompt: {
                 type: "string",
                 required: true,
+                minLength: 1,
+                maxLength: 5000,
                 description: "Edit instruction (max 5000 non-Chinese / 2500 Chinese chars)",
             },
             video_url: {
@@ -1416,6 +1590,7 @@ export const modelInputSchemas = {
             },
             reference_image: {
                 type: "array",
+                maxItems: 5,
                 description: "Optional reference image URLs (0-5)",
                 items: { type: "string" },
             },
@@ -1430,11 +1605,102 @@ export const modelInputSchemas = {
                 description: "Audio handling: auto (model decides) or origin (keep original) (default auto)",
             },
             seed: {
-                type: "number",
+                type: "integer",
+                minimum: 0,
+                maximum: 2147483647,
                 description: "Random seed (0-2147483647)",
             },
         },
     },
+    // Sources:
+    // - https://docs.kie.ai/market/happyhorse-1-1/image-to-video
+    // - https://docs.kie.ai/market/happyhorse-1-1/text-to-video
+    // - https://docs.kie.ai/market/happyhorse-1-1/reference-to-video
+    // - https://kie.ai/happyhorse-1-1
+    "happyhorse-1-1/text-to-video": {
+        type: "video",
+        fields: {
+            prompt: {
+                type: "string",
+                required: true,
+                minLength: 1,
+                maxLength: 5000,
+                description: "Video generation prompt (max 5000 non-Chinese / 2500 Chinese chars)",
+            },
+            resolution: {
+                type: "string",
+                enum: ["720p", "1080p"],
+                default: "1080p",
+                description: "Output resolution (default 1080p)",
+            },
+            aspect_ratio: {
+                type: "string",
+                enum: happyHorse11AspectRatios,
+                default: "16:9",
+                description: "Output aspect ratio (default 16:9)",
+            },
+            duration: happyHorseDurationField,
+        },
+    },
+    "happyhorse-1-1/image-to-video": {
+        type: "video",
+        fields: {
+            prompt: {
+                type: "string",
+                maxLength: 5000,
+                default: "",
+                description: "Video generation prompt (max 5000 non-Chinese / 2500 Chinese chars)",
+            },
+            image_urls: {
+                type: "array",
+                required: true,
+                minItems: 1,
+                maxItems: 1,
+                description: "First-frame image URL list (exactly 1 JPEG/JPG/PNG/WEBP image, max 20 MB)",
+                items: { type: "string" },
+            },
+            resolution: {
+                type: "string",
+                enum: ["720p", "1080p"],
+                default: "1080p",
+                description: "Output resolution (default 1080p)",
+            },
+            duration: happyHorseDurationField,
+        },
+    },
+    "happyhorse-1-1/reference-to-video": {
+        type: "video",
+        fields: {
+            prompt: {
+                type: "string",
+                required: true,
+                minLength: 1,
+                maxLength: 5000,
+                description: "Video generation prompt (max 5000 non-Chinese / 2500 Chinese chars)",
+            },
+            reference_image: {
+                type: "array",
+                required: true,
+                minItems: 1,
+                maxItems: 9,
+                description: "Reference image URLs (1-9 JPEG/JPG/PNG/WEBP images, max 20 MB each)",
+                items: { type: "string" },
+            },
+            resolution: {
+                type: "string",
+                enum: ["720p", "1080p"],
+                default: "1080p",
+                description: "Output resolution (default 1080p)",
+            },
+            aspect_ratio: {
+                type: "string",
+                enum: happyHorse11AspectRatios,
+                default: "16:9",
+                description: "Output aspect ratio (default 16:9)",
+            },
+            duration: happyHorseDurationField,
+        },
+    },
     "omnihuman-1-5": {
         type: "video",
         fields: {
@@ -1445,6 +1711,7 @@ export const modelInputSchemas = {
             },
             mask_url: {
                 type: "array",
+                maxItems: 5,
                 description: "Optional subject mask image URLs (jpeg/png/webp, max 5, max 10MB each)",
                 items: { type: "string" },
             },
@@ -1455,6 +1722,7 @@ export const modelInputSchemas = {
             },
             prompt: {
                 type: "string",
+                maxLength: 1000,
                 description: "Optional motion prompt (max 1000 chars; Chinese, English, Japanese, Korean, Spanish, or Indonesian)",
             },
             output_resolution: {
@@ -1467,7 +1735,9 @@ export const modelInputSchemas = {
                 description: "Fast mode trades quality for speed (default false)",
             },
             seed: {
-                type: "number",
+                type: "integer",
+                minimum: -1,
+                default: -1,
                 description: "Random seed (-1 for random, default -1)",
             },
         },
@@ -1513,5 +1783,85 @@ export const modelInputSchemas = {
             },
         },
     },
+    "gemini-omni-video": {
+        type: "video",
+        fields: {
+            prompt: {
+                type: "string",
+                required: true,
+                minLength: 1,
+                maxLength: 20000,
+                description: "Multimodal video generation prompt (max 20000 chars)",
+            },
+            image_urls: {
+                type: "array",
+                maxItems: 7,
+                description: "Reference image URLs (max 7, each image up to 20MB; each counts as 1 quota unit)",
+                items: { type: "string" },
+            },
+            audio_ids: {
+                type: "array",
+                maxItems: 3,
+                description: "Audio IDs created by gemini-omni-audio (max 3; does not count toward visual quota)",
+                items: { type: "string" },
+            },
+            video_list: {
+                type: "array",
+                maxItems: 1,
+                description: "Reference video clip list (max 1; source video under 100MB and 30s; each clip counts as 2 quota units)",
+                items: {
+                    type: "object",
+                    properties: {
+                        url: {
+                            type: "string",
+                            required: true,
+                            description: "Reference video URL",
+                        },
+                        start: {
+                            type: "number",
+                            required: true,
+                            minimum: 0,
+                            description: "Clip start time in seconds",
+                        },
+                        ends: {
+                            type: "number",
+                            required: true,
+                            minimum: 0,
+                            description: "Clip end time in seconds; must be greater than start and less than 10 seconds after start",
+                        },
+                    },
+                },
+            },
+            character_ids: {
+                type: "array",
+                maxItems: 3,
+                description: "Character IDs created by gemini-omni-character (max 3; each counts as 1 quota unit)",
+                items: { type: "string" },
+            },
+            duration: {
+                type: "string",
+                required: true,
+                enum: ["4", "6", "8", "10"],
+                description: "Output duration in seconds; ignored by Kie when video input is provided",
+            },
+            aspect_ratio: {
+                type: "string",
+                enum: ["16:9", "9:16"],
+                description: "Output aspect ratio",
+            },
+            seed: {
+                type: "integer",
+                minimum: 0,
+                maximum: 2147483647,
+                description: "Random seed",
+            },
+            resolution: {
+                type: "string",
+                enum: ["720p", "1080p", "4k"],
+                default: "720p",
+                description: "Output resolution (default 720p)",
+            },
+        },
+    },
 };
 //# sourceMappingURL=model-schemas.js.map