{"openapi":"3.1.0","info":{"title":"都成就 · 图像与视频生成 API","version":"2026-09-10.1"},"paths":{"/v1/images/generations":{"post":{"summary":"Images","operationId":"images_v1_images_generations_post","parameters":[{"name":"idempotency-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/videos/generations":{"post":{"summary":"Videos","operationId":"videos_v1_videos_generations_post","parameters":[{"name":"idempotency-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/models":{"get":{"summary":"Models","operationId":"models_v1_models_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/healthz":{"get":{"summary":"Health","operationId":"health_healthz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/status":{"get":{"summary":"Status","operationId":"status_v1_status_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tasks":{"get":{"summary":"List Tasks","operationId":"list_tasks_v1_tasks_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tasks/{tid}":{"get":{"summary":"Get Task","operationId":"get_task_v1_tasks__tid__get","parameters":[{"name":"tid","in":"path","required":true,"schema":{"type":"string","title":"Tid"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tasks/{tid}/cancel":{"post":{"summary":"Cancel","operationId":"cancel_v1_tasks__tid__cancel_post","parameters":[{"name":"tid","in":"path","required":true,"schema":{"type":"string","title":"Tid"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files":{"post":{"summary":"Upload","operationId":"upload_v1_files_post","parameters":[{"name":"filename","in":"query","required":true,"schema":{"type":"string","title":"Filename"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files/{fid}/content":{"get":{"summary":"Content","operationId":"content_v1_files__fid__content_get","parameters":[{"name":"fid","in":"path","required":true,"schema":{"type":"string","title":"Fid"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/heartbeat":{"post":{"summary":"Heartbeat","operationId":"heartbeat_internal_heartbeat_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Heartbeat"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/claim":{"post":{"summary":"Claim","operationId":"claim_internal_claim_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Claim"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/tasks/{tid}":{"post":{"summary":"Update Task","operationId":"update_task_internal_tasks__tid__post","parameters":[{"name":"tid","in":"path","required":true,"schema":{"type":"string","title":"Tid"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Update"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/files/{fid}":{"get":{"summary":"Internal File","operationId":"internal_file_internal_files__fid__get","parameters":[{"name":"fid","in":"path","required":true,"schema":{"type":"string","title":"Fid"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/tasks/{tid}/output":{"post":{"summary":"Output","operationId":"output_internal_tasks__tid__output_post","parameters":[{"name":"tid","in":"path","required":true,"schema":{"type":"string","title":"Tid"}},{"name":"filename","in":"query","required":true,"schema":{"type":"string","title":"Filename"}},{"name":"artifact","in":"query","required":true,"schema":{"type":"string","title":"Artifact"}},{"name":"worker_id","in":"query","required":true,"schema":{"type":"string","title":"Worker Id"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/keys":{"post":{"summary":"New Key","operationId":"new_key_admin_keys_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeyRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"summary":"Key List","operationId":"key_list_admin_keys_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/keys/{kid}/disable":{"post":{"summary":"Disable","operationId":"disable_admin_keys__kid__disable_post","parameters":[{"name":"kid","in":"path","required":true,"schema":{"type":"string","title":"Kid"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/tasks":{"get":{"summary":"All Tasks","operationId":"all_tasks_admin_tasks_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin":{"get":{"summary":"Page","operationId":"page_admin_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/":{"get":{"summary":"Page","operationId":"page__get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/docs":{"get":{"summary":"Docs","operationId":"docs_docs_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}}},"components":{"schemas":{"Claim":{"properties":{"worker_id":{"type":"string","pattern":"^[a-z0-9_-]{1,64}$","title":"Worker Id"},"ready":{"type":"boolean","title":"Ready","default":false}},"additionalProperties":false,"type":"object","required":["worker_id"],"title":"Claim"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"Heartbeat":{"properties":{"worker_id":{"type":"string","pattern":"^[a-z0-9_-]{1,64}$","title":"Worker Id"},"backend_online":{"type":"boolean","title":"Backend Online"},"backend_busy":{"type":"boolean","title":"Backend Busy","default":false},"task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Id"}},"additionalProperties":false,"type":"object","required":["worker_id","backend_online"],"title":"Heartbeat"},"ImageRequest":{"properties":{"model":{"type":"string","const":"qwen-image-2512-bf16","title":"Model","default":"qwen-image-2512-bf16"},"prompt":{"type":"string","maxLength":16000,"minLength":1,"title":"Prompt"},"negative_prompt":{"type":"string","maxLength":4000,"title":"Negative Prompt","default":""},"width":{"type":"integer","multipleOf":32.0,"maximum":2048.0,"minimum":256.0,"title":"Width","default":1024},"height":{"type":"integer","multipleOf":32.0,"maximum":2048.0,"minimum":256.0,"title":"Height","default":1024},"steps":{"type":"integer","maximum":60.0,"minimum":1.0,"title":"Steps","default":50},"cfg":{"type":"number","maximum":10.0,"minimum":0.0,"title":"Cfg","default":4.0},"seed":{"anyOf":[{"type":"integer","maximum":9007199254740991.0,"minimum":0.0},{"type":"null"}],"title":"Seed"}},"additionalProperties":false,"type":"object","required":["prompt"],"title":"ImageRequest"},"KeyRequest":{"properties":{"name":{"type":"string","maxLength":80,"minLength":1,"title":"Name"}},"additionalProperties":false,"type":"object","required":["name"],"title":"KeyRequest"},"Update":{"properties":{"worker_id":{"type":"string","title":"Worker Id"},"status":{"type":"string","enum":["preparing","submitting","running","uploading","succeeded","failed","needs_attention"],"title":"Status"},"prompt_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt Id"},"progress":{"additionalProperties":true,"type":"object","title":"Progress"},"error":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Error"}},"additionalProperties":false,"type":"object","required":["worker_id","status"],"title":"Update"},"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"},"VideoRequest":{"properties":{"model":{"type":"string","enum":["minimax-h3-t2v","minimax-h3-ref2va-bf16"],"title":"Model","default":"minimax-h3-t2v"},"prompt":{"type":"string","maxLength":24000,"minLength":1,"title":"Prompt"},"width":{"type":"integer","multipleOf":32.0,"maximum":1536.0,"minimum":256.0,"title":"Width","default":768},"height":{"type":"integer","multipleOf":32.0,"maximum":1536.0,"minimum":256.0,"title":"Height","default":512},"duration":{"type":"number","maximum":30.0,"minimum":1.0,"title":"Duration","default":5},"steps":{"type":"integer","maximum":40.0,"minimum":1.0,"title":"Steps","default":20},"seed":{"anyOf":[{"type":"integer","maximum":9007199254740991.0,"minimum":0.0},{"type":"null"}],"title":"Seed"},"sage_attention":{"type":"string","enum":["auto","disabled"],"title":"Sage Attention","default":"auto"},"ref_image_size":{"type":"string","enum":["match","max"],"title":"Ref Image Size","default":"max"},"reference_images":{"items":{"type":"string"},"type":"array","maxItems":9,"title":"Reference Images"},"reference_videos":{"items":{"type":"string"},"type":"array","maxItems":3,"title":"Reference Videos"},"reference_audios":{"items":{"type":"string"},"type":"array","maxItems":3,"title":"Reference Audios"},"include_reference_video_audio":{"type":"boolean","title":"Include Reference Video Audio","default":false}},"additionalProperties":false,"type":"object","required":["prompt"],"title":"VideoRequest"}}}}