{"openapi":"3.1.0","info":{"title":"MiniMax-H3 Studio API","description":"Text-to-video and (multi-)image-to-video on a local MiniMax-H3. Authenticate with `Authorization: Bearer <token>` (or `x-token` header / `?token=`).","version":"1.0"},"paths":{"/api/config":{"get":{"summary":"Api Config","operationId":"api_config_api_config_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/jobs":{"get":{"summary":"Api Jobs","operationId":"api_jobs_api_jobs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Create a video job (multipart form, used by the web UI)","operationId":"api_create_api_jobs_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_api_create_api_jobs_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/generate":{"post":{"summary":"Create a video job (JSON)","operationId":"api_generate_api_v1_generate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/jobs/{job_id}":{"get":{"summary":"Get one job","operationId":"api_get_api_jobs__job_id__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"wait","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Wait"}},{"name":"timeout","in":"query","required":false,"schema":{"type":"integer","default":600,"title":"Timeout"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"Api Delete","operationId":"api_delete_api_jobs__job_id__delete","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/jobs/{job_id}/video":{"get":{"summary":"Download the finished mp4","operationId":"api_video_api_jobs__job_id__video_get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/status":{"get":{"summary":"Api Status","operationId":"api_status_api_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/":{"get":{"summary":"Index","operationId":"index__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"Body_api_create_api_jobs_post":{"properties":{"prompt":{"type":"string","title":"Prompt"},"profile":{"type":"string","title":"Profile","default":"fasth3_fast"},"aspect":{"type":"string","title":"Aspect","default":"16:9"},"res":{"type":"string","title":"Res","default":"480p"},"seconds":{"type":"number","title":"Seconds","default":5},"seed":{"type":"integer","title":"Seed","default":-1},"steps":{"type":"integer","title":"Steps","default":0},"images":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Images","default":[]}},"type":"object","required":["prompt"],"title":"Body_api_create_api_jobs_post"},"GenerateRequest":{"properties":{"prompt":{"type":"string","title":"Prompt","description":"Scene, camera and audio description (Chinese or English)"},"profile":{"type":"string","title":"Profile","description":"fasth3_fast (default) | fasth3 | fasth3_max | fasth3_4step_int8 | turbo_int8","default":"fasth3_fast"},"aspect":{"type":"string","title":"Aspect","description":"16:9 | 9:16 | 1:1","default":"16:9"},"res":{"type":"string","title":"Res","description":"352p | 480p | 768p","default":"480p"},"seconds":{"type":"number","title":"Seconds","description":"clip length 1..15 s, snapped to the 17k+5 frame grid at 24 fps","default":5},"seed":{"type":"integer","title":"Seed","description":"-1 = random","default":-1},"steps":{"type":"integer","title":"Steps","description":"0 = profile default","default":0},"images":{"items":{"type":"string"},"type":"array","title":"Images","description":"0..6 images as http(s) URLs or data:image/...;base64 strings. 1 = first frame, 2 = first + last, more = evenly anchored keyframes"},"wait":{"type":"boolean","title":"Wait","description":"block until the job finishes (or `timeout`) and return the final job","default":false},"timeout":{"type":"integer","title":"Timeout","description":"max seconds to wait when wait=true (<= 1800)","default":600},"callback_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Callback Url","description":"POST the finished job JSON here"}},"type":"object","required":["prompt"],"title":"GenerateRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}