Properties
| Name | Type | Description |
|---|---|---|
| model | string | Model of generation. Retired ids are still accepted and map to the current model: `doubao-seedance-2.0` → `seedance-2.0`, `doubao-seedance-2.0-fast` → `seedance-2.0-fast`, `doubao-seedance-2.0-mini` → |
| input | object | Generation parameters (structure depends on the model) |
| webhook | string | Webhook for result |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/api-stock-com/json-schema/api-stock-com-create-generation-request-dto-schema.json",
"title": "CreateGenerationRequestDto",
"x-generated": "2026-10-30",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/api-stock-com-openapi.json#/components/schemas/CreateGenerationRequestDto",
"type": "object",
"properties": {
"model": {
"type": "string",
"description": "Model of generation. Retired ids are still accepted and map to the current model: `doubao-seedance-2.0` → `seedance-2.0`, `doubao-seedance-2.0-fast` → `seedance-2.0-fast`, `doubao-seedance-2.0-mini` → `seedance-2.0-mini`, `doubao-seedance-2.5` → `seedance-2.5`, `doubao-seedance-1-5-pro` → `seedance-1-5-pro`, `doubao-seedream-4-5` → `seedream-4-5`, `doubao-seedream-5-0-lite` → `seedream-5-0-lite`, `doubao-seedream-5-0-pro` → `seedream-5-0-pro`.",
"enum": [
"veo3.1-fast",
"veo3.1-quality",
"veo3.1-lite",
"nano-banana",
"nano-banana-pro",
"nano-banana-2",
"nano-banana-2.1",
"nano-banana-2-lite",
"grok-imagine-1.5-video",
"grok-imagine-1.5-image",
"grok-imagine-2.0-image",
"seedance-2.0",
"seedance-2.0-fast",
"seedance-2.0-mini",
"seedance-2.5",
"seedance-2.5-spicy",
"seedance-1-5-pro",
"gpt-image-2",
"gpt-image-2.5-sunburst",
"gpt-image-2.5-flare",
"kling-3.0-motion-control",
"kling-3.0",
"kling-4.0",
"pixverse-v6",
"seedream-5-0-lite",
"seedream-5-0-flash",
"seedream-5-0-pro",
"seedream-4-5",
"wan2.7-video",
"wan3.0-video",
"wan3.0-video-prime",
"wan3.0-video-pro",
"flux-3-video",
"flux-3-image",
"gemini-omni-1.1-flash",
"minimax-h3",
"agnes-video-2.5",
"z-image",
"wan2.7-image",
"wan2.7-image-pro",
"midjourney",
"midjourney-video",
"suno"
]
},
"input": {
"description": "Generation parameters (structure depends on the model)",
"anyOf": [
{
"$ref": "#/$defs/Veo3InputDto"
},
{
"$ref": "#/$defs/Veo3LiteInputDto"
},
{
"$ref": "#/$defs/NanoBananaInputDto"
},
{
"$ref": "#/$defs/NanoBanana21InputDto"
},
{
"$ref": "#/$defs/GrokImagineInputDto"
},
{
"$ref": "#/$defs/GrokImagineImageInputDto"
},
{
"$ref": "#/$defs/GrokImagine2ImageInputDto"
},
{
"$ref": "#/$defs/Flux3ImageInputDto"
},
{
"$ref": "#/$defs/SeedanceInputDto"
},
{
"$ref": "#/$defs/Seedance25InputDto"
},
{
"$ref": "#/$defs/Seedance25SpicyInputDto"
},
{
"$ref": "#/$defs/Seedance15ProInputDto"
},
{
"$ref": "#/$defs/GptImageInputDto"
},
{
"$ref": "#/$defs/KlingMotionControlInputDto"
},
{
"$ref": "#/$defs/Kling3InputDto"
},
{
"$ref": "#/$defs/Kling4InputDto"
},
{
"$ref": "#/$defs/PixverseInputDto"
},
{
"$ref": "#/$defs/SeedreamInputDto"
},
{
"$ref": "#/$defs/Seedream50FlashInputDto"
},
{
"$ref": "#/$defs/Wan27VideoInputDto"
},
{
"$ref": "#/$defs/Wan30VideoInputDto"
},
{
"$ref": "#/$defs/Wan30VideoProInputDto"
},
{
"$ref": "#/$defs/Flux3VideoInputDto"
},
{
"$ref": "#/$defs/GeminiOmni11InputDto"
},
{
"$ref": "#/$defs/MinimaxH3InputDto"
},
{
"$ref": "#/$defs/AgnesVideoInputDto"
},
{
"$ref": "#/$defs/ZImageInputDto"
},
{
"$ref": "#/$defs/Wan27ImageInputDto"
},
{
"$ref": "#/$defs/MidjourneyInputDto"
},
{
"$ref": "#/$defs/MidjourneyVideoInputDto"
},
{
"$ref": "#/$defs/SunoInputDto"
}
]
},
"webhook": {
"type": "string",
"description": "Webhook for result"
}
},
"required": [
"model",
"input"
],
"$defs": {
"AgnesVideoInputDto": {
"type": "object",
"properties": {
"prompt": {
"type": "string",
"description": "Describe the scene, motion and audio. Refer to supplied images and audio in the prompt."
},
"aspectRatio": {
"type": "string",
"description": "Video aspect ratio",
"enum": [
"16:9",
"9:16",
"21:9",
"4:3",
"1:1",
"3:4"
],
"default": "16:9"
},
"imageUrls": {
"description": "Reference image URLs (up to 9). Included in the per-second price.",
"maxItems": 9,
"type": "array",
"items": {
"type": "string"
}
},
"audioUrls": {
"description": "Reference audio URLs (up to 3), free of additional charge.",
"maxItems": 3,
"type": "array",
"items": {
"type": "string"
}
},
"resolution": {
"type": "string",
"description": "Output video resolution.",
"enum": [
"720p",
"1080p",
"2k"
],
"default": "720p"
},
"duration": {
"type": "number",
"description": "Output duration in seconds (1–12).",
"minimum": 1,
"maximum": 12,
"default": 5
},
"seed": {
"type": "number",
"description": "Random seed"
}
},
"required": [
"prompt"
]
},
"Flux3ImageInputDto": {
"type": "object",
"properties": {
"prompt": {
"type": "string",
"description": "Text description or image editing instructions. Layout and bounding-box instructions may be included in the prompt."
},
"urls": {
"description": "Reference image URLs for editing or multi-image guidance (up to 10 images). Omit for text-to-image generation.",
"maxItems": 10,
"type": "array",
"items": {
"type": "string"
}
},
"size": {
"type": "string",
"description": "Image aspect ratio. Auto follows the first reference image, or the prompt when generating from text.",
"enum": [
"auto",
"21:9",
"2:1",
"16:9",
"3:2",
"7:5",
"4:3",
"5:4",
"1:1",
"4:5",
"3:4",
"5:7",
"2:3",
"9:16",
"1:2",
"9:21"
],
"default": "auto"
},
"resolution": {
"type": "string",
"description": "Output resolution tier; determines the per-image price.",
"enum": [
"768SQ",
"1K",
"1.5K",
"2K",
"4K"
],
"default": "1K"
},
"grounding": {
"type": "boolean",
"description": "Allow web and image search before generation. Reference images and search do not add a separate charge.",
"default": true
}
},
"required": [
"prompt"
]
},
"Flux3VideoInputDto": {
"type": "object",
"properties": {
"prompt": {
"type": "string",
"description": "Scene description: subject, action, camera movement, dialogue and sound"
},
"resolution": {
"type": "string",
"description": "Video resolution (affects pricing). Draft mode supports 720p only",
"enum": [
"720p",
"1080p"
],
"default": "720p"
},
"duration": {
"type": "number",
"description": "Video duration in seconds (5-20). Billed per second",
"default": 5,
"minimum": 5,
"maximum": 20
},
"aspectRatio": {
"type": "string",
"description": "Video aspect ratio. `auto` lets the model choose from the prompt and input frames",
"enum": [
"auto",
"21:9",
"2:1",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
],
"default": "auto"
},
"imageUrls": {
"description": "Keyframes for image-to-video, in playback order. One image is the start frame, two are start + end, three or more are spread evenly across the clip",
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string"
}
},
"videoUrl": {
"type": "string",
"description": "Source video (mp4) to continue. Continuation is billed at a higher per-second rate and cannot be combined with imageUrls"
},
"draft": {
"type": "boolean",
"description": "Draft mode: a fast, low-quality 720p preview at about a third of the price",
"default": false
},
"safetyTolerance": {
"type": "number",
"description": "Moderation tolerance from 0 (strictest) to 4 (most permissive)",
"default": 2,
"minimum": 0,
"maximum": 4
}
},
"required": [
"prompt"
]
},
"GeminiOmni11InputDto": {
"type": "object",
"properties": {
"prompt": {
"type": "string",
"description": "Describe the scene, motion and sound.",
"maxLength": 4000
},
"imageUrls": {
"description": "First frame and optional last frame. Cannot be combined with reference inputs.",
"maxItems": 2,
"type": "array",
"items": {
"type": "string"
}
},
"referenceImageUrls": {
"description": "Reference images (up to 7; up to 5 with a reference video). Cannot be combined with imageUrls.",
"maxItems": 7,
"type": "array",
"items": {
"type": "string"
}
},
"referenceVideoUrls": {
"description": "One source video, 3–10 seconds. Output follows source duration and is billed per generation. Cannot be combined with imageUrls.",
"maxItems": 1,
"type": "array",
"items": {
"type": "string"
}
},
"aspectRatio": {
"type": "string",
"description": "Output aspect ratio",
"enum": [
"16:9",
"9:16"
],
"default": "16:9"
},
"duration": {
"type": "number",
"description": "Output duration. Ignored with a source video, which uses a flat per-generation price.",
"enum": [
4,
6,
8,
10
],
"default": 8
},
"resolution": {
"type": "string",
"description": "Output resolution; 1080p and 4K are upscaled outputs.",
"enum": [
"360p",
"720p",
"1080p",
"4k"
],
"default": "720p"
}
},
"required": [
"prompt"
]
},
"GptImageInputDto": {
"type": "object",
"properties": {
"prompt": {
"type": "string",
"description": "User's prompt"
},
"urls": {
"description": "Reference image URLs (URLs or base64 data URIs) for image-to-image mode",
"type": "array",
"items": {
"type": "string"
}
},
"size": {
"type": "string",
"description": "Output image aspect ratio. For GPT Image 2.5 models, 1:3 and 3:1 require 2k or 4k resolution.",
"enum": [
"auto",
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"3:2",
"2:3",
"5:4",
"4:5",
"2:1",
"1:2",
"3:1",
"1:3",
"21:9",
"9:21"
],
"default": "1:1"
},
"resolution": {
"type": "string",
"description": "Output image resolution",
"enum": [
"1k",
"2k",
"4k"
],
"default": "1k"
}
},
"required": [
"prompt"
]
},
"GrokImagine2ImageInputDto": {
"type": "object",
"properties": {
"prompt": {
"type": "string",
"description": "Text description for image generation"
},
"size": {
"type": "string",
"description": "Image aspect ratio",
"enum": [
"1:1",
"2:3",
"3:2",
"3:4",
"4:3",
"9:16",
"16:9"
],
"default": "1:1"
}
},
"required": [
"prompt"
]
},
"GrokImagineImageInputDto": {
"type": "object",
"properties": {
"prompt": {
"type": "string",
"description": "Text description for image generation"
},
"size": {
"type": "string",
"description": "Image aspect ratio",
"enum": [
"1:1",
"16:9",
"9:16",
"3:2",
"2:3"
],
"default": "1:1"
},
"urls": {
"description": "Reference image URLs for image-to-image mode",
"maxItems": 1,
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"prompt"
]
},
"GrokImagineInputDto": {
"type": "object",
"properties": {
"prompt": {
"type": "string",
"description": "Video content description"
},
"size": {
"type": "string",
"description": "Video aspect ratio / size",
"enum": [
"16:9",
"9:16",
"1:1",
"3:2",
"2:3"
],
"default": "16:9"
},
"duration": {
"type": "number",
"description": "Video duration in seconds",
"enum": [
6,
10,
15,
20,
25,
30
],
"default": 6
},
"resolution": {
"type": "string",
"description": "Video resolution",
"enum": [
"480p",
"720p"
],
"default": "480p"
},
"urls": {
"description": "Reference image URLs for image-to-video mode",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"prompt"
]
},
"Kling3InputDto": {
"type": "object",
"properties": {
"prompt": {
"type": "string",
"description": "Video content description",
"maxLength": 2500
},
"resolution": {
"type": "string",
"description": "Video resolution tier (affects pricing)",
"enum": [
"720p",
"1080p",
"4k"
],
"default": "720p"
},
"duration": {
"type": "number",
"description": "Video duration in seconds (3-15). Billed per second",
"default": 5,
"minimum": 3,
"maximum": 15
},
"aspectRatio": {
"type": "string",
"description": "Video aspect ratio. Ignored in image-to-video mode — the ratio is taken from the input frame",
"enum": [
"16:9",
"9:16",
"1:1"
],
"default": "16:9"
},
"generateAudio": {
"type": "boolean",
"description": "Whether to generate a native audio track (increases pricing on 720p and 1080p)",
"default": false
},
"imageUrls": {
"description": "Input frames for image-to-video. One URL is used as the first frame, two as first + last frame",
"maxItems": 2,
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"prompt"
]
},
"Kling4ElementDto": {
"type": "object",
"properties": {
"description": {
"type": "string",
"description": "Subject description (up to 100 characters)",
"maxLength": 100
},
"type": {
"type": "string",
"description": "Element media type",
"enum": [
"image",
"video"
],
"default": "image"
},
"imageUrls": {
"description": "Image element references (1–4 URLs)",
"minItems": 1,
"maxItems": 4,
"type": "array",
"items": {
"type": "string"
}
},
"videoUrl": {
"type": "string",
"description": "Video element source URL"
}
}
},
"Kling4InputDto": {
"type": "object",
"properties": {
"prompt": {
"type": "string",
"description": "Describe the scene. Use @Image1 / @Element1 for references. Required unless multiShots is supplied; mutually exclusive with multiShots."
},
"videoMode": {
"type": "string",
"description": "Omit for pure text-to-video. Use elements for references, start_end_frame for keyframes, transform or video_reference for a source video.",
"enum": [
"elements",
"start_end_frame",
"transform",
"video_reference"
]
},
"resolution": {
"type": "string",
"description": "Output resolution (4K is not available)",
"enum": [
"720p",
"1080p"
],
"default": "720p"
},
"duration": {
"type": "number",
"description": "Output seconds, 3–30. Ignored with source video (its probed duration is billed) or multiShots (shot durations are summed).",
"minimum": 3,
"maximum": 30,
"default": 3
},
"aspectRatio": {
"type": "string",
"description": "Aspect ratio; must be auto with a source video. Keyframes determine their own ratio.",
"enum": [
"auto",
"16:9",
"9:16",
"1:1",
"21:9"
]
},
"generateAudio": {
"type": "boolean",
"description": "Generate native stereo audio (included in the price)",
"default": true
},
"keepAudio": {
"type": "boolean",
"description": "Preserve source video audio",
"default": true
},
"imageUrls": {
"description": "Raw references (up to 10); address as @Image1, @Image2. Requires elements, transform or video_reference mode.",
"maxItems": 10,
"type": "array",
"items": {
"type": "string"
}
},
"startImageIndex": {
"type": "number",
"description": "1-based imageUrls index anchoring the first frame (elements mode)",
"minimum": 1,
"maximum": 10
},
"elements": {
"description": "Subject elements: { description?: string, type?: image | video, imageUrls?: string[1..4], videoUrl?: string }. Up to 7, at most 3 video elements. Images and elements together: at most 15, or 14 with source video.",
"minItems": 1,
"maxItems": 7,
"type": "array",
"items": {
"$ref": "#/$defs/Kling4ElementDto"
}
},
"startFrameUrl": {
"type": "string",
"description": "Required first frame in start_end_frame mode"
},
"keyframeUrls": {
"description": "Ordered middle frames (up to 8) in start_end_frame mode; at most 10 total frames",
"maxItems": 8,
"type": "array",
"items": {
"type": "string"
}
},
"endFrameUrl": {
"type": "string",
"description": "Optional last frame in start_end_frame mode"
},
"videoUrl": {
"type": "string",
"description": "Source video for transform / video_reference. Duration is probed before charging; 3–10 seconds for transform, 3–30 for video_reference. Transform needs a short side of at least 700px."
},
"multiShots": {
"description": "2–6 scenes totalling 3–30 seconds; replaces prompt and duration. Only text-to-video and elements modes.",
"minItems": 2,
"maxItems": 6,
"type": "array",
"items": {
"$ref": "#/$defs/Kling4ShotDto"
}
}
}
},
"Kling4ShotDto": {
"type": "object",
"properties": {
"prompt": {
"type": "string",
"description": "Scene description"
},
"duration": {
"type": "number",
"description": "Scene duration in seconds; all shots must total 3–30 seconds",
"minimum": 1,
"maximum": 30
}
},
"required": [
"prompt",
"duration"
]
},
"KlingMotionControlInputDto": {
"type": "object",
"properties": {
"prompt": {
"type": "string",
"description": "Optional scene prompt"
},
"imageUrls": {
"description": "Reference image URL (exactly one). Use one clearly visible person, with the head, shoulders, arms and torso in frame. JPG/JPEG/PNG, max 10MB. An image whose longer side exceeds 3850px is downscaled automatically",
"minItems": 1,
"maxItems": 1,
"type": "array",
"items": {
"type": "string"
}
},
"videoUrls": {
"description": "Reference video URL (exactly one). Keep one person's complete upper body visible, including the first frame; cropped or multiple people may be rejected. MP4/MOV, max 100MB",
"minItems": 1,
"maxItems": 1,
"type": "array",
"items": {
"type": "string"
}
},
"characterOrientation": {
"type": "string",
"description": "Character orientation mode. Determines whose orientation drives the motion transfer",
"enum": [
"image",
"video"
]
},
"resolution": {
"type": "string",
"description": "Output resolution",
"enum": [
"720p",
"1080p"
],
"default": "720p"
}
},
"required": [
"imageUrls",
"videoUrls",
"characterOrientation"
]
},
"MidjourneyInputDto": {
"type": "object",
"properties": {
"action": {
"type": "string",
"description": "Midjourney action / endpoint. Defaults to 'imagine' (text-to-image). Follow-up actions reference a previous generation via 'parentTaskId'.",
"enum": [
"imagine",
"edits",
"blend",
"describe",
"upscale",
"variation",
"high-variation",
"low-variation",
"reroll",
"zoom",
"pan",
"inpaint",
"modal",
"remix-strong",
"remix-subtle"
],
"default": "imagine"
},
"prompt": {
"type": "string",
"description": "Prompt; required for imagine/edits. Native MJ flags allowed (e.g. '--ar 16:9 --v 6.1'). Structured body fields override prompt flags."
},
"imageUrls": {
"description": "Image URLs or base64 data URIs. Used as: image-guided (imagine), source (edits), blend set (2–4), describe (1).",
"maxItems": 16,
"type": "array",
"items": {
"type": "string"
}
},
"parentTaskId": {
"type": "string",
"description": "Parent generation id (a previous 'midjourney' generation in our system) for follow-up actions (upscale/variation/reroll/zoom/pan/inpaint/modal/remix). The upstream task id is resolved from it."
},
"index": {
"type": "number",
"description": "Tile index (1–4) for upscale/variation/zoom/pan/inpaint/remix when 'customId' is not provided.",
"minimum": 1,
"maximum": 4
},
"customId": {
"type": "string",
"description": "Raw MJ button id for the action; when set, 'index'/'direction' matching is skipped."
},
"speed": {
"type": "string",
"description": "Speed mode. 'relax' (default) adds no billing suffix.",
"enum": [
"relax",
"fast",
"turbo"
],
"default": "relax"
},
"direction": {
"type": "string",
"description": "Pan direction (action=pan).",
"enum": [
"left",
"right",
"up",
"down"
]
},
"zoomRatio": {
"type": "number",
"description": "Zoom factor (action=zoom). < 2 → Zoom Out 1.5x; omitted or >= 2 → 2x."
},
"maskUrl": {
"type": "string",
"description": "Mask image URL or base64 (action=modal). White = repaint, transparent = keep."
},
"dimensions": {
"type": "string",
"description": "Aspect preset for blend (action=blend); overridden by 'size'.",
"enum": [
"SQUARE",
"PORTRAIT",
"LANDSCAPE"
],
"default": "SQUARE"
},
"size": {
"type": "string",
"description": "Aspect ratio 'w:h' (--ar), e.g. '16:9', '1:1', '21:9'."
},
"quality": {
"type": "string",
"description": "Quality (--q).",
"enum": [
"0.25",
"0.5",
"1",
"2"
]
},
"style": {
"type": "string",
"description": "Style (--style), e.g. 'raw'."
},
"version": {
"type": "string",
"description": "Main MJ version (--v). With 'niji: true' and '7'/'6' it normalizes to Niji.",
"enum": [
"8.1",
"7",
"6.1",
"5.2",
"5.1"
]
},
"seed": {
"type": "number",
"description": "Seed (--seed)."
},
"negativePrompt": {
"type": "string",
"description": "Negative prompt (--no), e.g. 'ugly, blurry'."
},
"stylize": {
"type": "number",
"description": "Stylize (--s), 0–1000."
},
"chaos": {
"type": "number",
"description": "Chaos (--c), 0–100."
},
"weird": {
"type": "number",
"description": "Weird (--w), 0–3000."
},
"tile": {
"type": "boolean",
"description": "Tile mode (--tile)."
},
"niji": {
"type": "boolean",
"description": "Niji switch (--niji). Use with version 7/6."
},
"iw": {
"type": "number",
"description": "Image weight (--iw), 0–3."
},
"cw": {
"type": "number",
"description": "Character weight (--cw), 0–100."
},
"sw": {
"type": "number",
"description": "Style weight (--sw), 0–1000."
},
"cref": {
"type": "string",
"description": "Character reference URL (--cref)."
},
"sref": {
"type": "string",
"description": "Style reference URL (--sref)."
},
"dref": {
"type": "string",
"description": "Depth reference URL (--dref)."
},
"dw": {
"type": "number",
"description": "Depth weight (--dw), 0–100."
},
"repeat": {
"type": "number",
"description": "Repeat (--repeat), 2–40."
},
"raw": {
"type": "boolean",
"description": "Raw style (--raw), v5.1+."
},
"draft": {
"type": "boolean",
"description": "Draft mode (--draft), v7+."
},
"hd": {
"type": "boolean",
"description": "HD mode (--hd), v8/v8.1 only."
},
"stop": {
"type": "number",
"description": "Early stop (--stop), 10–100; v5–6.1 / niji 5–6 only."
},
"extra": {
"type": "string",
"description": "Escape hatch appended to the prompt verbatim (any '--xxx')."
}
}
},
"MidjourneyVideoInputDto": {
"type": "object",
"properties": {
"prompt": {
"type": "string",
"description": "Video prompt; optional when reusing a parent task."
},
"imageUrls": {
"description": "First-frame image (1 image, URL or base64). One of imageUrls / parentTaskId.",
"maxItems": 1,
"type": "array",
"items": {
"type": "string"
}
},
"parentTaskId": {
"type": "string",
"description": "Parent generation id (a SUCCESS 'midjourney' imagine generation) to reuse as the source. One of imageUrls / parentTaskId."
},
"index": {
"type": "number",
"description": "Which tile of the parent imagine grid is the first frame (0–3).",
"minimum": 0,
"maximum": 3
},
"videoType": {
"type": "string",
"description": "Resolution / mode tier. 720 tiers bill at the 720p rate.",
"enum": [
"vid_1.1_i2v_480",
"vid_1.1_i2v_720",
"vid_1.1_i2v_start_end_480",
"vid_1.1_i2v_start_end_720"
],
"default": "vid_1.1_i2v_480"
},
"animateMode": {
"type": "string",
"description": "Animation mode. 'auto' requires parentTaskId + index.",
"enum": [
"manual",
"auto"
],
"default": "manual"
},
"motion": {
"type": "string",
"description": "Motion amount. No billing impact.",
"enum": [
"low",
"high"
],
"default": "high"
},
"batchSize": {
"type": "number",
"description": "Batch size (1 / 2 / 4). Billed × N.",
"enum": [
1,
2,
4
],
"default": 1
},
"endUrl": {
"type": "string",
"description": "End frame; when set, videoType auto-upgrades to a start/end tier."
}
}
},
"MinimaxH3InputDto": {
"type": "object",
"properties": {
"prompt": {
"type": "string",
"description": "Describe the scene, motion and audio. Refer to supplied images and audio in the prompt."
},
"aspectRatio": {
"type": "string",
"description": "Video aspect ratio",
"enum": [
"16:9",
"9:16"
],
"default": "16:9"
},
"imageUrls": {
"description": "Reference image URLs (up to 9). The first 5 are free; each additional image is billed separately per request.",
"maxItems": 9,
"type": "array",
"items": {
"type":
# --- truncated at 32 KB (80 KB total) ---
# Full source: https://artifacts.apis.io/api-stock-com/json-schema/api-stock-com-create-generation-request-dto-schema.json
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/api-stock-com-create-generation-request-dto"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.