{"openapi":"3.1.0","info":{"title":"MiniMax H3 Fast API — CheaperGen","version":"1.0.0","description":"MiniMax H3 Fast is an inference-accelerated build of MiniMax H3's open weights: the same text, frame and reference inputs and a synchronized soundtrack, at 480P or 768P, returned many times faster and for a fraction of H3's price."},"servers":[{"url":"https://cheapergen.com/api/v1"}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"}},"schemas":{"Generation":{"type":"object","properties":{"id":{"type":"string"},"object":{"const":"generation"},"model":{"type":"string"},"endpoint":{"type":"string"},"status":{"enum":["queued","running","succeeded","failed","canceled"]},"output":{"type":["object","null"]},"error":{"type":["object","null"]},"cost":{"type":"object","properties":{"amount_usd":{"type":"number"},"official_usd":{"type":["number","null"],"description":"The list price for the same request: see list_price_source."},"list_price_source":{"enum":["official","reference"],"description":"official: the developer's own list price; reference: another price we compare with, named by list_price_label (e.g. fal API)."},"list_price_label":{"type":"string"},"saved_usd":{"type":["number","null"]},"estimated":{"type":"boolean"}}},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":["string","null"],"format":"date-time"}}}}},"paths":{"/run/minimax/h3-fast/text-to-video":{"post":{"summary":"MiniMax H3 Fast — Text to Video","operationId":"minimax_h3_fast_text_to_video","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"prompt":{"title":"Prompt","description":"Describe the shot: subject, action, camera movement, lighting and style.","type":"string","maxLength":5000},"aspect_ratio":{"title":"Aspect ratio","description":"Output frame shape.","type":"string","enum":["16:9","9:16","1:1","4:3","3:4","21:9"],"default":"16:9"},"resolution":{"title":"Resolution","description":"Output resolution. Higher resolutions cost more per second.","type":"string","enum":["480P","768P"],"default":"768P"},"duration":{"title":"Duration","description":"Length of the generated clip in seconds (4–15s). You pay per second.","type":"integer","minimum":4,"maximum":15,"default":6},"seed":{"title":"Seed","description":"Use the same seed and settings to reproduce a result. Leave empty for random.","type":"integer","minimum":0,"maximum":2147483647},"enable_safety_checker":{"title":"Enable Safety Checker","description":"If set to true, the safety checker will be enabled. Content our Acceptable Use Policy prohibits stays blocked either way.","type":"boolean","default":true},"webhook_url":{"type":"string","format":"uri","title":"Webhook URL","description":"Optional. We POST the finished generation here (signed)."}},"additionalProperties":false}}}},"responses":{"202":{"description":"Queued","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Generation"}}}},"400":{"description":"Invalid request"},"402":{"description":"Insufficient balance"}}}},"/run/minimax/h3-fast/image-to-video":{"post":{"summary":"MiniMax H3 Fast — Image to Video","operationId":"minimax_h3_fast_image_to_video","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt","image_url"],"properties":{"prompt":{"title":"Prompt","description":"Describe the shot: subject, action, camera movement, lighting and style.","type":"string","maxLength":5000},"image_url":{"title":"First frame","description":"Image used as the opening frame. JPG/PNG/WebP, URL or upload.","type":"string","format":"uri"},"end_image_url":{"title":"Last frame","description":"Optional closing frame — the model animates between the two.","type":"string","format":"uri"},"aspect_ratio":{"title":"Aspect ratio","description":"Output frame shape. Pick the one closest to your first frame.","type":"string","enum":["16:9","9:16","1:1","4:3","3:4","21:9"],"default":"16:9"},"resolution":{"title":"Resolution","description":"Output resolution. Higher resolutions cost more per second.","type":"string","enum":["480P","768P"],"default":"768P"},"duration":{"title":"Duration","description":"Length of the generated clip in seconds (4–15s). You pay per second.","type":"integer","minimum":4,"maximum":15,"default":6},"seed":{"title":"Seed","description":"Use the same seed and settings to reproduce a result. Leave empty for random.","type":"integer","minimum":0,"maximum":2147483647},"enable_safety_checker":{"title":"Enable Safety Checker","description":"If set to true, the safety checker will be enabled. Content our Acceptable Use Policy prohibits stays blocked either way.","type":"boolean","default":true},"webhook_url":{"type":"string","format":"uri","title":"Webhook URL","description":"Optional. We POST the finished generation here (signed)."}},"additionalProperties":false}}}},"responses":{"202":{"description":"Queued","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Generation"}}}},"400":{"description":"Invalid request"},"402":{"description":"Insufficient balance"}}}},"/run/minimax/h3-fast/reference-to-video":{"post":{"summary":"MiniMax H3 Fast — Reference to Video","operationId":"minimax_h3_fast_reference_to_video","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"prompt":{"title":"Prompt","description":"Describe the shot: subject, action, camera movement, lighting and style.","type":"string","maxLength":5000},"reference_image_urls":{"title":"Reference images","description":"Up to 9 images for characters, products, style or scene. Refer to them as @Image1, @Image2… The first 5 are included; each extra image adds a small fee.","type":"array","items":{"type":"string","format":"uri"},"maxItems":9},"reference_video_urls":{"title":"Reference videos","description":"Up to 3 MP4/MOV clips for motion, camera moves or effects (2–15 s each, 15 s in total, ≤ 50 MB each). Refer to them as @Video1, @Video2… Reference-video seconds are billed like output seconds.","type":"array","items":{"type":"string","format":"uri"},"maxItems":3,"x-media-limits":{"formats":["mp4","mov"],"min_seconds":2,"max_seconds":15,"max_total_seconds":15,"max_bytes":52428800,"min_side_px":256,"max_side_px":5760,"min_aspect":0.4,"max_aspect":2.5,"min_fps":23.9,"max_fps":60}},"reference_audio_urls":{"title":"Reference audio","description":"Up to 3 MP3/WAV clips for voice, music or sound (2–15 s each, 15 s in total, ≤ 15 MB each). Refer to them as @Audio1, @Audio2… Needs at least one reference image or video.","type":"array","items":{"type":"string","format":"uri"},"maxItems":3,"x-media-limits":{"formats":["mp3","wav"],"min_seconds":2,"max_seconds":15,"max_total_seconds":15,"max_bytes":15728640}},"aspect_ratio":{"title":"Aspect ratio","description":"Output frame shape.","type":"string","enum":["16:9","9:16","1:1","4:3","3:4","21:9"],"default":"16:9"},"resolution":{"title":"Resolution","description":"Output resolution. Higher resolutions cost more per second.","type":"string","enum":["480P","768P"],"default":"768P"},"duration":{"title":"Duration","description":"Length of the generated clip in seconds (4–15s). You pay per second.","type":"integer","minimum":4,"maximum":15,"default":6},"seed":{"title":"Seed","description":"Use the same seed and settings to reproduce a result. Leave empty for random.","type":"integer","minimum":0,"maximum":2147483647},"enable_safety_checker":{"title":"Enable Safety Checker","description":"If set to true, the safety checker will be enabled. Content our Acceptable Use Policy prohibits stays blocked either way.","type":"boolean","default":true},"webhook_url":{"type":"string","format":"uri","title":"Webhook URL","description":"Optional. We POST the finished generation here (signed)."}},"additionalProperties":false}}}},"responses":{"202":{"description":"Queued","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Generation"}}}},"400":{"description":"Invalid request"},"402":{"description":"Insufficient balance"}}}},"/generations/{id}":{"get":{"summary":"Get a generation","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Generation"}}}}}}}}}