{ "openapi": "3.1.0", "info": { "title": "Killa Tamata AI", "version": "0.18.0", "description": "API-first prepaid $ credit gateway for Killa Tamata media generation and OpenAI-compatible multimodal inference. Purchase credits, manage keys, submit media jobs, and call Qwen 3.8 27B." }, "servers": [ { "url": "https://api.killatamata.com" } ], "tags": [ { "name": "auth" }, { "name": "affiliates" }, { "name": "health" }, { "name": "catalog" }, { "name": "checkout" }, { "name": "credits" }, { "name": "claim" }, { "name": "keys" }, { "name": "balance" }, { "name": "arcade" }, { "name": "studio" }, { "name": "media" }, { "name": "inference" }, { "name": "webhooks" } ], "components": { "securitySchemes": { "BearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "API key" } }, "schemas": { "OpenAiError": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "param", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": [ "string", "null" ] } }, "additionalProperties": true } }, "additionalProperties": false }, "QwenModelList": { "type": "object", "required": [ "object", "data" ], "properties": { "object": { "const": "list" }, "data": { "type": "array", "maxItems": 1, "items": { "type": "object", "required": [ "id", "object", "owned_by" ], "properties": { "id": { "const": "qwen3.8-27b-uncensored" }, "object": { "const": "model" }, "created": { "type": "integer" }, "owned_by": { "const": "furgen" } }, "additionalProperties": false } } }, "additionalProperties": false }, "QwenTextContentPart": { "type": "object", "required": [ "type", "text" ], "properties": { "type": { "const": "text" }, "text": { "type": "string" } }, "additionalProperties": false }, "QwenImageContentPart": { "type": "object", "required": [ "type", "image_url" ], "properties": { "type": { "const": "image_url" }, "image_url": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "pattern": "^data:image/(png|jpeg|webp|gif);base64,", "description": "Strict base64 PNG, JPEG, WebP, or GIF data URI. Remote URLs are rejected; decoded image size is limited to 10 MiB." } }, "additionalProperties": false } }, "additionalProperties": false }, "QwenToolCall": { "type": "object", "required": [ "id", "type", "function" ], "properties": { "id": { "type": "string" }, "type": { "const": "function" }, "function": { "type": "object", "required": [ "name", "arguments" ], "properties": { "name": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,64}$" }, "arguments": { "type": "string" } }, "additionalProperties": false } }, "additionalProperties": false }, "QwenMessage": { "oneOf": [ { "type": "object", "required": [ "role", "content" ], "properties": { "role": { "const": "system" }, "content": { "type": "string" } }, "additionalProperties": false }, { "type": "object", "required": [ "role", "content" ], "properties": { "role": { "const": "user" }, "content": { "oneOf": [ { "type": "string" }, { "type": "array", "minItems": 1, "items": { "oneOf": [ { "$ref": "#/components/schemas/QwenTextContentPart" }, { "$ref": "#/components/schemas/QwenImageContentPart" } ] } } ] } }, "additionalProperties": false }, { "type": "object", "required": [ "role" ], "properties": { "role": { "const": "assistant" }, "content": { "type": [ "string", "null" ] }, "reasoning_content": { "type": [ "string", "null" ] }, "tool_calls": { "type": "array", "minItems": 1, "maxItems": 128, "items": { "$ref": "#/components/schemas/QwenToolCall" } } }, "anyOf": [ { "required": [ "content" ] }, { "required": [ "reasoning_content" ] }, { "required": [ "tool_calls" ] } ], "additionalProperties": false }, { "type": "object", "required": [ "role", "tool_call_id", "content" ], "properties": { "role": { "const": "tool" }, "tool_call_id": { "type": "string" }, "content": { "type": "string" } }, "additionalProperties": false } ] }, "QwenFunctionTool": { "type": "object", "required": [ "type", "function" ], "properties": { "type": { "const": "function" }, "function": { "type": "object", "required": [ "name", "parameters" ], "properties": { "name": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,64}$" }, "description": { "type": "string" }, "parameters": { "type": "object", "additionalProperties": true }, "strict": { "type": "boolean" } }, "additionalProperties": false } }, "additionalProperties": false }, "QwenChatCompletionRequest": { "type": "object", "required": [ "model", "messages" ], "properties": { "model": { "const": "qwen3.8-27b-uncensored" }, "messages": { "type": "array", "minItems": 1, "items": { "$ref": "#/components/schemas/QwenMessage" } }, "prompt_cache_key": { "type": "string", "minLength": 1, "maxLength": 128, "description": "Stable identity hint for repeated requests with the same reusable input prefix. The gateway replaces it with an account-scoped opaque handle before forwarding and never persists either value. Do not include secrets or personal data." }, "reasoning_effort": { "type": "string", "enum": [ "none", "low", "medium", "high", "xhigh" ], "default": "medium" }, "max_tokens": { "type": "integer", "minimum": 1, "maximum": 131072 }, "max_completion_tokens": { "type": "integer", "minimum": 1, "maximum": 131072 }, "temperature": { "type": "number", "minimum": 0, "maximum": 2 }, "top_p": { "type": "number", "minimum": 0, "maximum": 1 }, "top_k": { "type": "integer", "minimum": 0 }, "min_p": { "type": "number", "minimum": 0, "maximum": 1 }, "presence_penalty": { "type": "number", "minimum": -2, "maximum": 2 }, "repeat_penalty": { "type": "number", "exclusiveMinimum": 0 }, "stream": { "type": "boolean", "default": false }, "stream_options": { "type": "object", "required": [ "include_usage" ], "properties": { "include_usage": { "type": "boolean" } }, "additionalProperties": false }, "tools": { "type": "array", "minItems": 1, "maxItems": 128, "items": { "$ref": "#/components/schemas/QwenFunctionTool" } }, "tool_choice": { "oneOf": [ { "type": "string", "enum": [ "auto", "none", "required" ] }, { "type": "object", "required": [ "type", "function" ], "properties": { "type": { "const": "function" }, "function": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string" } }, "additionalProperties": false } }, "additionalProperties": false } ] }, "parallel_tool_calls": { "type": "boolean" } }, "additionalProperties": false, "description": "OpenAI-compatible Qwen request. max_tokens and max_completion_tokens are mutually exclusive. At most 8 inline images are allowed. prompt_cache_key is optional caching identity, not cached content. The total gateway request and response limit is 20 MiB." }, "QwenChatCompletionResponse": { "type": "object", "description": "OpenAI-compatible completion response. reasoning_content and modern tool_calls may be present. Keyed requests may include best-effort usage.prompt_tokens_details.cached_tokens telemetry. Billing always uses the full prompt_tokens count, and reasoning tokens are included in completion_tokens.", "additionalProperties": true }, "QwenInferenceJob": { "type": "object", "required": [ "id", "object", "status" ], "properties": { "id": { "type": "string", "pattern": "^ij_[a-f0-9]{64}$" }, "object": { "const": "inference.job" }, "status": { "type": "string", "enum": [ "creating", "queued", "dispatching", "completed", "failed", "cancelled" ] }, "model": { "const": "qwen3.8-27b-uncensored" }, "request_id": { "type": "string" }, "queue_position": { "type": [ "integer", "null" ], "minimum": 0 }, "estimated_wait_ms": { "type": [ "integer", "null" ], "minimum": 0 }, "created_at": { "type": "integer" }, "updated_at": { "type": "integer" }, "expires_at": { "type": "integer" }, "dispatch_attempts": { "type": "integer", "minimum": 0 }, "next_attempt_at": { "type": [ "integer", "null" ] }, "last_retry": { "type": [ "object", "null" ], "additionalProperties": true }, "error": { "oneOf": [ { "$ref": "#/components/schemas/OpenAiError" }, { "type": "null" } ] } }, "additionalProperties": true }, "QwenQueueStatus": { "type": "object", "description": "Aggregate FIFO queue depth and estimated wait. This response contains no prompt content.", "properties": { "model": { "const": "qwen3.8-27b-uncensored" }, "depth": { "type": "integer", "minimum": 0 }, "estimated_wait_ms": { "type": "integer", "minimum": 0 } }, "additionalProperties": true }, "HealthSkillVersion": { "type": "object", "required": [ "name", "version", "compatibleApiVersion", "compatibilityPolicy", "autoUpdate", "manifestUrl", "metadataUrl", "rootUrl", "entrypointUrl" ], "properties": { "name": { "type": "string" }, "version": { "type": "string" }, "compatibleApiVersion": { "type": "string" }, "compatibilityPolicy": { "type": "string", "enum": [ "exact" ] }, "autoUpdate": { "type": "boolean" }, "manifestUrl": { "type": "string", "format": "uri" }, "metadataUrl": { "type": "string", "format": "uri" }, "rootUrl": { "type": "string", "format": "uri" }, "entrypointUrl": { "type": "string", "format": "uri" } }, "additionalProperties": false }, "HealthVersionInfo": { "type": "object", "required": [ "release", "api", "skill" ], "properties": { "release": { "type": "string" }, "api": { "type": "string" }, "skill": { "$ref": "#/components/schemas/HealthSkillVersion" } }, "additionalProperties": false }, "HealthResponse": { "type": "object", "required": [ "status", "service", "timestamp", "version" ], "properties": { "status": { "type": "string", "enum": [ "ok" ] }, "service": { "type": "string" }, "timestamp": { "type": "string", "format": "date-time" }, "version": { "$ref": "#/components/schemas/HealthVersionInfo" } }, "additionalProperties": false }, "MediaAspectRatio": { "type": "string", "enum": [ "1:1", "16:9", "9:16", "9:7", "7:9" ] }, "MediaImageOutputFormat": { "type": "string", "enum": [ "webp", "png", "jpg" ], "default": "webp", "description": "Optional output image format. Defaults to webp when omitted. Dot-prefixed aliases are also accepted at runtime (.webp, .png, .jpg)." }, "MediaInlineImageSource": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" }, "dataBase64": { "type": "string", "description": "Raw image bytes encoded as base64 (or data URI). Input is staged on CDN, with best-effort WebP conversion when encoder support is available." }, "mimeType": { "type": "string", "enum": [ "image/webp", "image/png", "image/jpeg", "image/jpg" ], "description": "Supported inline MIME types. image/jpg is accepted and normalized to image/jpeg at runtime." } }, "additionalProperties": false, "oneOf": [ { "required": [ "url" ] }, { "required": [ "dataBase64" ] } ] }, "MediaImageInput": { "oneOf": [ { "type": "string", "format": "uri" }, { "$ref": "#/components/schemas/MediaInlineImageSource" } ], "description": "Provide either a direct image URL string or an inline image object." }, "MediaVideoWatermark": { "type": "object", "required": [ "image", "x", "y", "width", "height" ], "properties": { "image": { "$ref": "#/components/schemas/MediaImageInput" }, "x": { "type": "integer", "minimum": 0, "description": "Horizontal pixel coordinate from the final delivered frame's top-left corner." }, "y": { "type": "integer", "minimum": 0, "description": "Vertical pixel coordinate from the final delivered frame's top-left corner." }, "width": { "type": "integer", "minimum": 1, "description": "Exact watermark width in final-frame pixels." }, "height": { "type": "integer", "minimum": 1, "description": "Exact watermark height in final-frame pixels." } }, "additionalProperties": false, "description": "Optional whole-clip watermark. The image is resized exactly to width x height and composited at x,y after final resizing, upscaling, and interpolation. The complete box must fit on the delivered frame. PNG/WebP alpha is preserved; JPEG is opaque." }, "MediaImageDesignBBox": { "type": "array", "prefixItems": [ { "type": "integer", "minimum": 0, "maximum": 1000 }, { "type": "integer", "minimum": 0, "maximum": 1000 }, { "type": "integer", "minimum": 0, "maximum": 1000 }, { "type": "integer", "minimum": 0, "maximum": 1000 } ], "minItems": 4, "maxItems": 4, "description": "Optional normalized bounding box [y_min, x_min, y_max, x_max] in 0-1000 coordinates." }, "MediaImageDesignStyleDescription": { "type": "object", "required": [ "aesthetics", "lighting", "medium" ], "properties": { "aesthetics": { "type": "string", "minLength": 1, "maxLength": 1000 }, "lighting": { "type": "string", "minLength": 1, "maxLength": 1000 }, "photo": { "type": "string", "minLength": 1, "maxLength": 1000 }, "medium": { "type": "string", "minLength": 1, "maxLength": 200 }, "art_style": { "type": "string", "minLength": 1, "maxLength": 1000 }, "color_palette": { "type": "array", "maxItems": 16, "items": { "type": "string", "pattern": "^#[0-9A-F]{6}$" } } }, "oneOf": [ { "required": [ "photo" ] }, { "required": [ "art_style" ] } ], "additionalProperties": false }, "MediaImageDesignElement": { "oneOf": [ { "type": "object", "required": [ "type", "desc" ], "properties": { "type": { "type": "string", "enum": [ "obj" ] }, "bbox": { "$ref": "#/components/schemas/MediaImageDesignBBox" }, "desc": { "type": "string", "minLength": 1, "maxLength": 2000 }, "color_palette": { "type": "array", "maxItems": 5, "items": { "type": "string", "pattern": "^#[0-9A-F]{6}$" } } }, "additionalProperties": false }, { "type": "object", "required": [ "type", "text", "desc" ], "properties": { "type": { "type": "string", "enum": [ "text" ] }, "bbox": { "$ref": "#/components/schemas/MediaImageDesignBBox" }, "text": { "type": "string", "minLength": 1, "maxLength": 240 }, "desc": { "type": "string", "minLength": 1, "maxLength": 2000 }, "color_palette": { "type": "array", "maxItems": 5, "items": { "type": "string", "pattern": "^#[0-9A-F]{6}$" } } }, "additionalProperties": false } ] }, "MediaImageDesignPrompt": { "oneOf": [ { "type": "string", "minLength": 1, "maxLength": 4000 }, { "type": "object", "required": [ "compositional_deconstruction" ], "properties": { "high_level_description": { "type": "string", "minLength": 1, "maxLength": 4000 }, "style_description": { "$ref": "#/components/schemas/MediaImageDesignStyleDescription" }, "compositional_deconstruction": { "type": "object", "required": [ "background", "elements" ], "properties": { "background": { "type": "string", "minLength": 1, "maxLength": 4000 }, "elements": { "type": "array", "minItems": 1, "maxItems": 64, "items": { "$ref": "#/components/schemas/MediaImageDesignElement" } } }, "additionalProperties": false } }, "additionalProperties": false } ], "description": "Plain text prompt or structured design-caption JSON object. Structured objects are serialized in caption order before generation." }, "MediaInlineAudioSource": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" }, "dataBase64": { "type": "string", "description": "Raw audio bytes encoded as base64 (or data URI). Input is staged on CDN before provider submission." }, "mimeType": { "type": "string", "enum": [ "audio/ogg", "audio/opus", "audio/wav", "audio/x-wav", "audio/wave", "audio/mpeg", "audio/mp3", "audio/flac", "audio/x-flac", "audio/aac", "audio/mp4", "audio/webm" ] } }, "additionalProperties": false, "oneOf": [ { "required": [ "url" ] }, { "required": [ "dataBase64" ] } ] }, "MediaAudioInput": { "oneOf": [ { "type": "string", "format": "uri" }, { "$ref": "#/components/schemas/MediaInlineAudioSource" } ], "description": "Provide either a direct audio URL string or an inline audio object." }, "MediaJobRequest": { "oneOf": [ { "type": "object", "required": [ "task", "input" ], "properties": { "task": { "type": "string", "enum": [ "image.generate" ] }, "input": { "type": "object", "required": [ "prompt" ], "properties": { "prompt": { "type": "string", "minLength": 1, "maxLength": 4000 }, "aspectRatio": { "$ref": "#/components/schemas/MediaAspectRatio" }, "outputFormat": { "$ref": "#/components/schemas/MediaImageOutputFormat" }, "highDetail": { "type": "boolean", "default": false, "description": "Optional higher-detail image mode. Defaults to false. Increases inference steps by 50% and billed cost by 50%." }, "upscale": { "type": "boolean", "description": "Optional built-in 1.5x upscale toggle. Defaults to false." }, "width": { "type": "integer", "minimum": 32, "multipleOf": 32, "description": "Optional explicit output width. Must be provided together with height. Max 4MP total." }, "height": { "type": "integer", "minimum": 32, "multipleOf": 32, "description": "Optional explicit output height. Must be provided together with width. Max 4MP total." }, "referenceImageUrls": { "type": "array", "maxItems": 5, "items": { "type": "string", "format": "uri" }, "description": "URL-only legacy alias for reference images." }, "referenceImages": { "type": "array", "maxItems": 5, "items": { "$ref": "#/components/schemas/MediaImageInput" }, "description": "Preferred reference image input (URL strings or inline objects)." } }, "additionalProperties": false }, "idempotencyKey": { "type": "string", "minLength": 1, "maxLength": 200 }, "completionCallbackUrl": { "type": "string", "format": "uri", "description": "Optional public HTTP(S) terminal callback URL. Receives one job-level POST when the job reaches a terminal state. URL credentials, redirects, and private, loopback, or internal targets are rejected." } }, "additionalProperties": false }, { "type": "object", "required": [ "task", "input" ], "properties": { "task": { "type": "string", "enum": [ "image.design" ] }, "input": { "type": "object", "required": [ "prompt" ], "properties": { "prompt": { "$ref": "#/components/schemas/MediaImageDesignPrompt" }, "preset": { "type": "string", "enum": [ "quality", "fast" ], "default": "quality", "description": "Prompt-only design preset. Defaults to quality." }, "outputFormat": { "$ref": "#/components/schemas/MediaImageOutputFormat" }, "width": { "type": "integer", "minimum": 32, "multipleOf": 32, "default": 1024, "description": "Optional explicit output width. Must be provided together with height. Max 4MP total." }, "height": { "type": "integer", "minimum": 32, "multipleOf": 32, "default": 1024, "description": "Optional explicit output height. Must be provided together with width. Max 4MP total." }, "seed": { "type": "integer", "minimum": 1, "maximum": 2147483647, "description": "Optional generation seed. When omitted, the API chooses a random seed and returns it in detailed status metadata." } }, "additionalProperties": false }, "idempotencyKey": { "type": "string", "minLength": 1, "maxLength": 200 }, "completionCallbackUrl": { "type": "string", "format": "uri", "description": "Optional public HTTP(S) terminal callback URL. Receives one job-level POST when the job reaches a terminal state. URL credentials, redirects, and private, loopback, or internal targets are rejected." } }, "additionalProperties": false }, { "type": "object", "required": [ "task", "input" ], "properties": { "task": { "type": "string", "enum": [ "image.edit" ] }, "input": { "type": "object", "required": [ "prompt" ], "anyOf": [ { "required": [ "sourceImageUrl" ] }, { "required": [ "sourceImage" ] } ], "properties": { "prompt": { "type": "string", "minLength": 1, "maxLength": 4000 }, "sourceImageUrl": { "type": "string", "format": "uri" }, "sourceImage": { "$ref": "#/components/schemas/MediaImageInput" }, "outputFormat": { "$ref": "#/components/schemas/MediaImageOutputFormat" }, "highDetail": { "type": "boolean", "default": false, "description": "Optional higher-detail image mode. Defaults to false. Increases inference steps by 50% and billed cost by 50%." }, "referenceImageUrls": { "type": "array", "maxItems": 5, "items": { "type": "string", "format": "uri" }, "description": "URL-only legacy alias for reference images." }, "referenceImages": { "type": "array", "maxItems": 5, "items": { "$ref": "#/components/schemas/MediaImageInput" }, "description": "Preferred reference image input (URL strings or inline objects)." } }, "additionalProperties": false }, "idempotencyKey": { "type": "string", "minLength": 1, "maxLength": 200 }, "completionCallbackUrl": { "type": "string", "format": "uri", "description": "Optional public HTTP(S) terminal callback URL. Receives one job-level POST when the job reaches a terminal state. URL credentials, redirects, and private, loopback, or internal targets are rejected." } }, "additionalProperties": false }, { "type": "object", "required": [ "task", "input" ], "properties": { "task": { "type": "string", "enum": [ "video.generate" ] }, "input": { "type": "object", "required": [ "prompt" ], "description": "Generates MiniMax H3 text-to-video, image-to-video, or deterministic trim continuation with native audio at 24 FPS. Continuation requires continuationSourceVideoUrl plus continuationSeedTimeSeconds; the service authoritatively probes the source, re-encodes and caches the immediate 56-frame (7/3-second) tail ending at the seed, extracts its terminal anchor PNG, cuts the terminal anchor PNG from the source at the seed, locks generated frame zero to that anchor, grades the boundary and then the whole clip against the chain grade anchor (bounded RGB gain, adaptive exposure, YCbCr mean/std transfer, luma percentile levels, temporal unsharp), conditions H3 Ref2VA on the tail plus its embedded audio, and re-encodes the output at CRF 16. A continuation asking for quality=fast is promoted to the 8-step 768p balanced profile and priced 1.25x the fast tier. Continuation cannot be combined with frame, overlap, or reference-audio inputs. quality=fast uses the latest 4-step Turbo LoRA, quality=balanced (default) uses the latest 8-step Turbo LoRA, and quality=quality uses base H3 at 20 steps with a 50% surcharge. Legacy low and regular map to balanced; high maps to quality. Delivery uses RTXVideoSuperResolution when needed and RIFE interpolation to 60 FPS by default. Stitch the returned continuation after its source with video.combine overlapFrames=1 and frameRate=60 to remove the duplicated boundary frame and matching audio head; the job response also reports seamFinish, and a structured combine should trim (headTrimFrames - 0.5) / frameRate seconds off the continuation head and use a hard cut, never a crossfade.", "properties": { "prompt": { "type": "string", "minLength": 1, "maxLength": 4000, "description": "MiniMax H3 audiovisual prompt. For image-to-video, use the documented I2VA alignment sentence first, then integrated_multimodal_description, overall_soundscape, and non_diegetic_music. In Shot 1, explicitly preserve the start image's subject identity, appearance, colors, markings or clothing, composition, key objects, and spatial relationships before describing motion. The gateway completes missing I2V structure, but passes already-complete documented prompts through unchanged." }, "startFrameImageUrl": { "type": "string", "format": "uri", "description": "Optional start-frame image URL. Omit for text-to-video mode. Equivalent to sourceImageUrl." }, "startFrameImage": { "allOf": [ { "$ref": "#/components/schemas/MediaImageInput" } ], "description": "Optional start-frame image as URL string or inline object. Equivalent to sourceImage." }, "sourceImageUrl": { "type": "string", "format": "uri", "description": "Legacy alias for startFrameImageUrl." }, "sourceImage": { "allOf": [ { "$ref": "#/components/schemas/MediaImageInput" } ], "description": "Legacy alias for startFrameImage." }, "finalFrameImageUrl": { "type": "string", "format": "uri", "description": "Optional final-frame steering URL. Can be used with or without referenceAudioUrl/referenceAudio." }, "finalFrameImage": { "$ref": "#/components/schemas/MediaImageInput", "description": "Optional final-frame steering (URL string or inline object). Can be used with or without referenceAudioUrl/referenceAudio." }, "continuationSourceVideoUrl": { "type": "string", "format": "uri", "description": "Public trusted source MP4 to continue. Must be supplied with continuationSeedTimeSeconds." }, "continuationSeedTimeSeconds": { "type": "number", "minimum": 2.5, "maximum": 600, "description": "Exclusive trim endpoint in the source timeline. Legacy requests quantize to milliseconds; boundary version 2 preserves precision and selects the final source presentation timestamp before this endpoint." }, "continuationBoundaryVersion": { "type": "integer", "enum": [ 2 ], "description": "Opt into frame-exact exclusive-cut anchoring, including variable frame rate sources. Result seamFinish adds headTrimSeconds and continuationBoundary metadata; omitted preserves legacy preparation and trim semantics." }, "continuationGradeAnchorVideoUrl": { "type": "string", "format": "uri", "description": "Optional chain grade anchor: the ROOT clip of a multi-part chain. Its first frame becomes the fixed grading setpoint for the exposure, color-transfer, and levels passes, so a long chain does not accumulate per-part drift. Omit it for a plain 2-part continuation: those passes then use the terminal anchor and agree with the boundary node, which matches the seam. Requires the continuation fields." }, "durationSeconds": { "type": "integer", "minimum": 5, "maximum": 15, "description": "Optional whole-second H3 duration. Defaults to 5 and aligns upward to H3's n % 17 = 5 frame grid." }, "durationFrames": { "type": "integer", "minimum": 124, "maximum": 362, "description": "Optional native H3 frame count. Requires 124-362 frames with n % 17 = 5 (for example 124, 243, or 362)." }, "aspectRatio": { "$ref": "#/components/schemas/MediaAspectRatio" }, "sampledFps": { "type": "integer", "minimum": 24, "maximum": 24, "description": "Optional explicit native FPS. MiniMax H3 is fixed at 24 FPS, so omit this field or set it to 24." }, "width": { "type": "integer", "minimum": 32, "multipleOf": 32, "description": "Optional final output width. Must be provided together with height. The workflow keeps this as the delivered canvas." }, "height": { "type": "integer", "minimum": 32, "multipleOf": 32, "description": "Optional final output height. Must be provided together with width. The workflow keeps this as the delivered canvas." }, "interpolationFps": { "description": "Optional RIFE output FPS target. Omit for 60 FPS. Use 0 to disable interpolation and keep native 24 FPS. Allowed values: 0 or 30..60.", "default": 60, "anyOf": [ { "type": "integer", "const": 0 }, { "type": "integer", "minimum": 30, "maximum": 60 } ] }, "seed": { "type": "integer", "minimum": 1, "maximum": 2147483647, "description": "Optional deterministic seed. Keep this fixed across clip-B continuation variants when comparing seam quality, color continuity, or overlap strategies." }, "quality": { "type": "string", "enum": [ "fast", "balanced", "quality", "low", "regular", "high" ], "default": "balanced", "description": "MiniMax H3 quality tier. fast uses FL2VA Turbo 4-step v1.1; balanced uses FL2VA Turbo 8-step v1.0 and is the default; quality uses base H3 at 20 steps with the existing 50% surcharge. Deprecated aliases: low and regular map to balanced, high maps to quality." }, "extremeQuality": { "type": "boolean", "default": false, "deprecated": true, "description": "Deprecated compatibility alias. true is equivalent to quality=quality; false is equivalent to quality=balanced." }, "watermark": { "$ref": "#/components/schemas/MediaVideoWatermark" } }, "additionalProperties": false }, "idempotencyKey": { "type": "string", "minLength": 1, "maxLength": 200 }, "completionCallbackUrl": { "type": "string", "format": "uri", "description": "Optional public HTTP(S) terminal callback URL. Receives one job-level POST when the job reaches a terminal state. URL credentials, redirects, and private, loopback, or internal targets are rejected." } }, "additionalProperties": false }, { "type": "object", "required": [ "task", "input" ], "properties": { "task": { "type": "string", "enum": [ "video.generate.reference" ] }, "input": { "x-capabilities": { "independentStartFrame": true, "independentFinalFrame": true, "continuationFinalFrame": true, "maxReferenceImages": 9, "maxReferenceVideos": 3, "continuationReservedImages": 1, "continuationReservedVideos": 1 }, "type": "object", "required": [ "prompt" ], "description": "Generates a MiniMax H3 video from one or more multimodal references, optionally continuing a source clip. Provide at least one image, video, audio reference, or independent frame guide (a continuation satisfies this on its own); an optional watermark does not satisfy this requirement or affect positional prompt tags. quality=fast uses Ref2VA Turbo 4-step v0.1 with video/audio shifts 12/3 on its 544p profile; quality=balanced uses Ref2VA Turbo 8-step v1.0 with shifts 12/3 on its 768p profile; quality=quality (the backward-compatible default) uses base H3 at 20 steps on the 768p profile. Legacy low and regular map to fast; high maps to quality. Prompt tags are positional: .. follow image order,