{"openapi":"3.1.0","info":{"title":"GUMY 私有生成 API","version":"3.0.2","description":"单用户私有算力服务。HTTPS + Bearer，异步 FIFO 队列，最多 20 个活跃任务。Windows 必须开机联网，无云端降级。"},"servers":[{"url":"https://gumy.jiangyinliang.com"}],"security":[{"BearerAuth":[]}],"paths":{"/v1/videos/h3/windows/plan":{"post":{"summary":"CPU窗口规划；不提交生成，不代表history/Guide运行时已可用","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/H3WindowPlanRequest"}}}},"responses":{"200":{"description":"源区间、历史、补齐与交付区间（半开区间）","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/images":{"post":{"operationId":"create_images","tags":["生成"],"summary":"图片","description":"Z-Image。异步提交，同一 GPU 串行执行。","x-available":true,"parameters":[{"name":"Idempotency-Key","in":"header","schema":{"type":"string","minLength":1,"maxLength":128},"description":"同键同参数返回原任务；不同参数返回 409。数据库保留期间持久有效，过期产物不会重新生成。每次新生成使用新键。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/imagesRequest"}}}},"responses":{"202":{"description":"任务已接受，包含 Location、Retry-After、Idempotency-Replayed 响应头","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Submission"}}},"headers":{"Location":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer"}},"Idempotency-Replayed":{"schema":{"type":"boolean"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/speech":{"post":{"operationId":"create_speech","tags":["生成"],"summary":"语音","description":"Qwen-Audio 3.0 Plus · 阿里云百炼。默认外部 API，独立于本地 GPU 队列。","x-available":true,"parameters":[{"name":"Idempotency-Key","in":"header","schema":{"type":"string","minLength":1,"maxLength":128},"description":"同键同参数返回原任务；不同参数返回 409。数据库保留期间持久有效，过期产物不会重新生成。每次新生成使用新键。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/speechRequest"}}}},"responses":{"202":{"description":"任务已接受，包含 Location、Retry-After、Idempotency-Replayed 响应头","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Submission"}}},"headers":{"Location":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer"}},"Idempotency-Replayed":{"schema":{"type":"boolean"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/music":{"post":{"operationId":"create_music","tags":["生成"],"summary":"音乐","description":"ACE-Step 1.5XL Turbo + Qwen 4B。异步提交，同一 GPU 串行执行。","x-available":true,"parameters":[{"name":"Idempotency-Key","in":"header","schema":{"type":"string","minLength":1,"maxLength":128},"description":"同键同参数返回原任务；不同参数返回 409。数据库保留期间持久有效，过期产物不会重新生成。每次新生成使用新键。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/musicRequest"}}}},"responses":{"202":{"description":"任务已接受，包含 Location、Retry-After、Idempotency-Replayed 响应头","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Submission"}}},"headers":{"Location":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer"}},"Idempotency-Replayed":{"schema":{"type":"boolean"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/videos":{"post":{"operationId":"create_videos","tags":["生成"],"summary":"视频","description":"Wan 2.1 Bernini。异步提交，同一 GPU 串行执行。","x-available":true,"parameters":[{"name":"Idempotency-Key","in":"header","schema":{"type":"string","minLength":1,"maxLength":128},"description":"同键同参数返回原任务；不同参数返回 409。数据库保留期间持久有效，过期产物不会重新生成。每次新生成使用新键。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/videosRequest"}}}},"responses":{"202":{"description":"任务已接受，包含 Location、Retry-After、Idempotency-Replayed 响应头","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Submission"}}},"headers":{"Location":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer"}},"Idempotency-Replayed":{"schema":{"type":"boolean"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/videos/h3":{"post":{"operationId":"create_video_h3","tags":["生成"],"summary":"H3 视频","description":"MiniMax H3 (T2VA / FL2VA / Ref2VA)。异步提交，同一 GPU 串行执行。","x-available":true,"parameters":[{"name":"Idempotency-Key","in":"header","schema":{"type":"string","minLength":1,"maxLength":128},"description":"同键同参数返回原任务；不同参数返回 409。数据库保留期间持久有效，过期产物不会重新生成。每次新生成使用新键。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/video_h3Request"}}}},"responses":{"202":{"description":"任务已接受，包含 Location、Retry-After、Idempotency-Replayed 响应头","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Submission"}}},"headers":{"Location":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer"}},"Idempotency-Replayed":{"schema":{"type":"boolean"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/speech/long":{"post":{"operationId":"create_speech_long","tags":["生成"],"summary":"分段口播","description":"Qwen-Audio 3.0 Plus · 阿里云百炼。默认外部 API，独立于本地 GPU 队列。","x-available":true,"parameters":[{"name":"Idempotency-Key","in":"header","schema":{"type":"string","minLength":1,"maxLength":128},"description":"同键同参数返回原任务；不同参数返回 409。数据库保留期间持久有效，过期产物不会重新生成。每次新生成使用新键。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/speech_longRequest"}}}},"responses":{"202":{"description":"任务已接受，包含 Location、Retry-After、Idempotency-Replayed 响应头","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Submission"}}},"headers":{"Location":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer"}},"Idempotency-Replayed":{"schema":{"type":"boolean"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/transcribe":{"post":{"operationId":"create_transcribe","tags":["生成"],"summary":"音频转写","description":"Qwen3-ASR 1.7B + ForcedAligner 0.6B。异步提交，同一 GPU 串行执行。","x-available":true,"parameters":[{"name":"Idempotency-Key","in":"header","schema":{"type":"string","minLength":1,"maxLength":128},"description":"同键同参数返回原任务；不同参数返回 409。数据库保留期间持久有效，过期产物不会重新生成。每次新生成使用新键。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/transcribeRequest"}}}},"responses":{"202":{"description":"任务已接受，包含 Location、Retry-After、Idempotency-Replayed 响应头","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Submission"}}},"headers":{"Location":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer"}},"Idempotency-Replayed":{"schema":{"type":"boolean"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/align":{"post":{"operationId":"create_align","tags":["生成"],"summary":"文案对齐","description":"独立转写对照 + Qwen3 ForcedAligner。异步提交，同一 GPU 串行执行。","x-available":true,"parameters":[{"name":"Idempotency-Key","in":"header","schema":{"type":"string","minLength":1,"maxLength":128},"description":"同键同参数返回原任务；不同参数返回 409。数据库保留期间持久有效，过期产物不会重新生成。每次新生成使用新键。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/alignRequest"}}}},"responses":{"202":{"description":"任务已接受，包含 Location、Retry-After、Idempotency-Replayed 响应头","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Submission"}}},"headers":{"Location":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer"}},"Idempotency-Replayed":{"schema":{"type":"boolean"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/images/edit":{"post":{"operationId":"create_image_edit","tags":["生成"],"summary":"参考图编辑","description":"FLUX.2 Klein 4B FP8 · 单参考图 · 4 步。异步提交，同一 GPU 串行执行。","x-available":true,"parameters":[{"name":"Idempotency-Key","in":"header","schema":{"type":"string","minLength":1,"maxLength":128},"description":"同键同参数返回原任务；不同参数返回 409。数据库保留期间持久有效，过期产物不会重新生成。每次新生成使用新键。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/image_editRequest"}}}},"responses":{"202":{"description":"任务已接受，包含 Location、Retry-After、Idempotency-Replayed 响应头","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Submission"}}},"headers":{"Location":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer"}},"Idempotency-Replayed":{"schema":{"type":"boolean"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/postprocess":{"post":{"operationId":"create_postprocess","tags":["生成"],"summary":"素材加工","description":"FFmpeg · 原素材保持不变。异步提交，同一 GPU 串行执行。","x-available":true,"parameters":[{"name":"Idempotency-Key","in":"header","schema":{"type":"string","minLength":1,"maxLength":128},"description":"同键同参数返回原任务；不同参数返回 409。数据库保留期间持久有效，过期产物不会重新生成。每次新生成使用新键。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/postprocessRequest"}}}},"responses":{"202":{"description":"任务已接受，包含 Location、Retry-After、Idempotency-Replayed 响应头","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Submission"}}},"headers":{"Location":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer"}},"Idempotency-Replayed":{"schema":{"type":"boolean"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/tasks":{"get":{"summary":"任务列表；无参数时保持 v2 兼容响应（200 条倒序）","description":"查询参数全部可选：capability/status(逗号多值)/group_id/since(revision 游标)/limit(1-200,默认50)/offset/fields(full|summary)。since 模式返回 next_cursor，变更集含状态变化。","parameters":[{"name":"capability","in":"query","schema":{"type":"string"},"description":"单能力过滤"},{"name":"status","in":"query","schema":{"type":"string"},"description":"逗号分隔多状态"},{"name":"group_id","in":"query","schema":{"type":"string"},"description":"变体组过滤"},{"name":"since","in":"query","schema":{"type":"integer"},"description":"增量游标（revision）"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}},{"name":"fields","in":"query","schema":{"type":"string","enum":["full","summary"],"default":"full"}}],"responses":{"200":{"description":"任务列表","content":{"application/json":{"schema":{"type":"object","properties":{"tasks":{"type":"array","items":{"$ref":"#/components/schemas/Task"}},"current_task":{"type":["string","null"]},"next_cursor":{"type":"integer","description":"since 模式下返回，作为下次 since"}}}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/tasks/{task_id}":{"parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"查询任务；过期任务保留元数据","responses":{"200":{"description":"任务详情","content":{"application/json":{"schema":{"type":"object","properties":{"task":{"$ref":"#/components/schemas/Task"}}}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"summary":"取消任务；执行中尽力中断，终态任务返回 409","responses":{"200":{"description":"取消已接受","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"status":{"type":"string"}}}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/tasks/{task_id}/events":{"parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"任务进度 SSE 流（status/progress 事件，≤15s 心跳，终态发 done/error 后关闭）","description":"text/event-stream；重连即全量快照，不回放 Last-Event-ID。需 nginx proxy_buffering off。","responses":{"200":{"description":"SSE 事件流","content":{"text/event-stream":{"schema":{"type":"string"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/tasks/{task_id}/archive":{"parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"任务全部产物 + manifest 打包 zip 下载","responses":{"200":{"description":"zip 归档","content":{"application/zip":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/tasks/{task_id}/previews/retry":{"parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string"}}],"post":{"summary":"重试失败的视频预览派生，不重新生成原素材","responses":{"202":{"description":"失败项已排队","content":{"application/json":{"schema":{"type":"object","properties":{"queued":{"type":"integer"}}}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/files/uploads-audio":{"get":{"summary":"已上传参考音前30秒试听；需认证及Windows在线","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"MP3试听","content":{"audio/mpeg":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/uploads":{"post":{"summary":"上传图片、音频或视频（最多 200 MiB）；speech.voice_upload 仅接受 ≤10 MiB 的 WAV/MP3/FLAC","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"string","format":"binary"}}}}}},"responses":{"200":{"description":"上传文件名","content":{"application/json":{"schema":{"type":"object","properties":{"filename":{"type":"string"},"bytes":{"type":"integer"}}}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"get":{"summary":"列出已上传文件（含媒体规格与活跃任务引用）","responses":{"200":{"description":"上传列表","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/uploads/{filename}":{"parameters":[{"name":"filename","in":"path","required":true,"schema":{"type":"string"}}],"delete":{"summary":"删除未被活跃任务引用的上传文件；被引用返回 409","responses":{"200":{"description":"已删除","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/files/uploads-thumb":{"get":{"summary":"已上传图片的只读 JPEG 缩略图（最长边 320px）；需认证","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"JPEG 缩略图；Cache-Control: no-store","content":{"image/jpeg":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/maintenance":{"get":{"summary":"管理 Key 查询调度维护租约","responses":{"200":{"description":"维护状态","content":{"application/json":{"schema":{"type":"object","properties":{"paused":{"type":"boolean"},"idle":{"type":"boolean","description":"当前任务及实例恢复均已结束"},"expires_in":{"type":"number"},"current_task":{"type":["string","null"]}}}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"管理 Key 暂停领取新任务；已接收任务与当前执行不受中断，租约到期自动恢复","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["paused"],"properties":{"paused":{"type":"boolean"},"seconds":{"type":"number","minimum":1,"maximum":300,"default":120}}}}}},"responses":{"200":{"description":"维护状态","content":{"application/json":{"schema":{"type":"object","properties":{"paused":{"type":"boolean"},"idle":{"type":"boolean","description":"当前任务及实例恢复均已结束"},"expires_in":{"type":"number"},"current_task":{"type":["string","null"]}}}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/usage":{"get":{"summary":"用量统计：按能力/日期/Key 聚合的生成量、成功率、时长与队列等待","parameters":[{"name":"from","in":"query","schema":{"type":"number","description":"unix 秒，默认近 30 天"}},{"name":"to","in":"query","schema":{"type":"number"}},{"name":"by","in":"query","schema":{"type":"string","enum":["capability","day","key","capability_day"],"default":"capability"}}],"responses":{"200":{"description":"聚合结果（UTC 日界）","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/keys":{"get":{"summary":"列出子 API Key（不回显完整 key）","responses":{"200":{"description":"Key 列表","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"创建子 Key（名称 + 能力白名单 + 可选过期）；完整 key 仅此响应出现一次","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","minLength":1,"maxLength":64},"capabilities":{"type":"array","items":{"type":"string"},"description":"空数组 = 全部能力"},"expires_at":{"type":"number","description":"unix 秒，可空"}}}}}},"responses":{"201":{"description":"创建成功","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/keys/{key_id}":{"parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"integer"}}],"delete":{"summary":"吊销子 Key（立即挡新请求，进行中任务不受影响）","responses":{"200":{"description":"已吊销","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/webhooks":{"get":{"summary":"列出 webhook 目标","responses":{"200":{"description":"目标列表","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"注册 webhook（仅 https 公网；HMAC-SHA256 签名，退避重试 1s/10s/60s）","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string"},"secret":{"type":"string","description":"缺省自动生成，仅返回一次"},"events":{"type":"string","enum":["done","failed","all"],"default":"all"},"capabilities":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"201":{"description":"已注册","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/webhooks/{webhook_id}":{"parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"integer"}}],"delete":{"summary":"删除 webhook 目标","responses":{"200":{"description":"已删除","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/webhooks/{webhook_id}/test":{"parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"integer"}}],"post":{"summary":"发送一条测试事件并返回投递结果","responses":{"200":{"description":"测试投递","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/webhooks/{webhook_id}/deliveries":{"parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"integer"}}],"get":{"summary":"查询投递记录（状态、HTTP 码、重试时间）","responses":{"200":{"description":"投递记录","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/presets":{"get":{"summary":"列出自定义制作预设","responses":{"200":{"description":"预设列表","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"保存自定义预设（保存时校验参数合法性，同能力内名称唯一，上限 50 个）","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","capability","params"],"properties":{"name":{"type":"string","minLength":1,"maxLength":64},"capability":{"type":"string"},"params":{"type":"object"},"note":{"type":"string","maxLength":500}}}}}},"responses":{"201":{"description":"已保存","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/presets/{preset_id}":{"parameters":[{"name":"preset_id","in":"path","required":true,"schema":{"type":"string"}}],"delete":{"summary":"删除自定义预设；内置预设 403","responses":{"200":{"description":"已删除","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/models":{"get":{"summary":"OpenAI 兼容模型列表","tags":["OpenAI 兼容"],"responses":{"200":{"description":"object=list 的 OpenAI 模型列表","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"请求无效","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"403":{"description":"子 key 能力白名单拒绝","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"404":{"description":"模型不存在","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"409":{"description":"冲突/取消","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"502":{"description":"生成失败","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"503":{"description":"节点不可用","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"504":{"description":"同步等待超时（附 task_id 可转轮询）","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}}}}},"/v1/models/{model_id}":{"parameters":[{"name":"model_id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"OpenAI 兼容单模型详情","tags":["OpenAI 兼容"],"responses":{"200":{"description":"模型对象","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"请求无效","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"403":{"description":"子 key 能力白名单拒绝","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"404":{"description":"模型不存在","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"409":{"description":"冲突/取消","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"502":{"description":"生成失败","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"503":{"description":"节点不可用","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"504":{"description":"同步等待超时（附 task_id 可转轮询）","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}}}}},"/v1/audio/speech":{"post":{"summary":"OpenAI 兼容同步语音合成（阻塞至完成，最长 120s）","tags":["OpenAI 兼容"],"description":"默认 qwen-audio-3.0-tts-plus；voice=longanlingxin（默认女声）/longanlufeng（男声）。云端生成及格式转换均在网关完成，不依赖 Windows。显式 model=index-tts-2 保留本地能力及 audio.<上传文件名> 克隆。云端不支持非默认 speed/instructions。","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"model":{"type":"string","enum":["qwen-audio-3.0-tts-plus","index-tts-2"],"default":"qwen-audio-3.0-tts-plus"},"input":{"type":"string","maxLength":8000},"voice":{"type":"string"},"response_format":{"type":"string","enum":["mp3","opus","aac","flac","wav","pcm"]},"speed":{"type":"number","description":"云端仅接受默认 1"},"instructions":{"type":"string","description":"云端当前仅接受空值"}}}}}},"responses":{"200":{"description":"音频字节（Content-Type 与 response_format 匹配）","content":{"audio/mpeg":{"schema":{"type":"string","format":"binary"}},"audio/flac":{"schema":{"type":"string","format":"binary"}},"audio/wav":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"请求无效","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"403":{"description":"子 key 能力白名单拒绝","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"404":{"description":"模型不存在","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"409":{"description":"冲突/取消","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"502":{"description":"生成失败","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"503":{"description":"节点不可用","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"504":{"description":"同步等待超时（附 task_id 可转轮询）","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}}}}},"/v1/images/generations":{"post":{"summary":"OpenAI 兼容同步图片生成（阻塞至完成，最长 180s）","tags":["OpenAI 兼容"],"description":"model=z-image；n 1-4 映射 batch；size 自动夹取到 16 倍数与 1MP 面积上限（宽容策略，生效尺寸体现在响应）；response_format url|b64_json（url 为需认证的下载地址，非公开预签名）。","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","prompt"],"properties":{"model":{"type":"string","enum":["z-image"]},"prompt":{"type":"string"},"n":{"type":"integer","minimum":1,"maximum":4},"size":{"type":"string","description":"WxH 或 auto"},"response_format":{"type":"string","enum":["url","b64_json"]},"quality":{"type":"string","description":"忽略"},"style":{"type":"string","description":"忽略"}}}}}},"responses":{"200":{"description":"OpenAI images 格式","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"请求无效","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"403":{"description":"子 key 能力白名单拒绝","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"404":{"description":"模型不存在","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"409":{"description":"冲突/取消","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"502":{"description":"生成失败","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"503":{"description":"节点不可用","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"504":{"description":"同步等待超时（附 task_id 可转轮询）","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}}}}},"/v1/audio/transcriptions":{"post":{"summary":"OpenAI 兼容同步转写（阻塞至完成，最长 600s）","tags":["OpenAI 兼容"],"description":"model=qwen3-asr；language zh/en；response_format json/text/verbose_json/srt（句级时间轴来自强制对齐）；上传上限 200 MiB（比 OpenAI 25MB 宽）。","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"string","format":"binary"},"model":{"type":"string","enum":["qwen3-asr"]},"language":{"type":"string","enum":["zh","en"]},"response_format":{"type":"string","enum":["json","text","verbose_json","srt"]},"prompt":{"type":"string","description":"忽略"}}}}}},"responses":{"200":{"description":"按 response_format 返回","content":{"application/json":{"schema":{"type":"object"}},"text/plain":{"schema":{"type":"string"}},"application/x-subrip":{"schema":{"type":"string"}}}},"400":{"description":"请求无效","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"403":{"description":"子 key 能力白名单拒绝","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"404":{"description":"模型不存在","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"409":{"description":"冲突/取消","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"502":{"description":"生成失败","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"503":{"description":"节点不可用","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}},"504":{"description":"同步等待超时（附 task_id 可转轮询）","content":{"application/json":{"schema":{"type":"object","description":"OpenAI 风格错误体 {error:{message,type,param,code}}"}}}}}}},"/files/{task_id}/{filename}":{"get":{"summary":"带认证下载；产物保留 7 天","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"filename","in":"path","required":true,"schema":{"type":"string"}},{"name":"Range","in":"header","schema":{"type":"string"}},{"name":"If-Range","in":"header","schema":{"type":"string"}}],"responses":{"200":{"description":"二进制产物","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"206":{"description":"部分字节；Content-Range/Content-Length/Accept-Ranges"},"416":{"description":"字节范围不可满足；Content-Range: bytes */size"}},"description":"原片、封面和流畅预览均需认证，支持 Range/If-Range；流式读取网关本地产物。"}},"/v1/capabilities":{"get":{"summary":"能力与参数目录","responses":{"200":{"description":"能力与参数目录","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/healthz":{"get":{"summary":"网关存活，不代表 GPU 就绪","responses":{"200":{"description":"网关存活，不代表 GPU 就绪","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[]}},"/healthz/agent":{"get":{"summary":"Windows 节点及各实例就绪状态","responses":{"200":{"description":"Windows 节点及各实例就绪状态","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"JSON 或幂等键无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"认证失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"能力白名单或管理权限拒绝","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"冲突","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"产物过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"请求过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"媒体类型错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"参数校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"队列已满","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"节点请求失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"节点或能力不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"网关超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"Error":{"type":"object","required":["error","code","request_id"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"request_id":{"type":"string"}}},"Submission":{"type":"object","required":["task_id","status","detail_url"],"properties":{"task_id":{"type":"string"},"status":{"type":"string"},"detail_url":{"type":"string"}}},"File":{"type":"object","properties":{"filename":{"type":"string"},"url":{"type":"string"},"bytes":{"type":"integer"},"sha256":{"type":"string"},"preview":{"type":"object","properties":{"state":{"type":"string","enum":["pending","processing","ready","original","failed"]},"thumbnail_url":{"type":"string"},"preview_url":{"type":"string"},"error":{"type":"string"},"bytes":{"type":"integer"}}}}},"Task":{"type":"object","properties":{"id":{"type":"string"},"capability":{"type":"string"},"status":{"type":"string","enum":["queued","running","uploading","done","failed","canceled","expired"]},"exclusive":{"type":"boolean"},"progress":{"type":"number","description":"阶段估计值 0–1，并非采样步数百分比"},"phase":{"type":["string","null"]},"error":{"type":["string","null"]},"history":{"type":"array","description":"持久状态变化记录；旧任务可能没有历史","items":{"type":"object","properties":{"status":{"type":"string"},"phase":{"type":["string","null"]},"at":{"type":"number"}}}},"group_id":{"type":"string"},"params":{"type":"object"},"result":{"type":["object","null"],"properties":{"files":{"type":"array","items":{"$ref":"#/components/schemas/File"}},"info":{"type":"object"}}},"created_at":{"type":["number","null"],"description":"Unix 秒时间戳"},"started_at":{"type":["number","null"],"description":"Unix 秒时间戳"},"finished_at":{"type":["number","null"],"description":"Unix 秒时间戳"}}},"H3WindowPlanRequest":{"type":"object","additionalProperties":false,"required":["source_frames"],"properties":{"source_frames":{"type":"integer","minimum":1,"maximum":216000},"source_fps":{"type":"string","default":"24","maxLength":30},"window_frames":{"type":"integer","enum":[22,39,56,73,90,107,124,141,158,175,192,209,226,243,260,277,294,311,328,345,362],"default":124},"history_frames":{"type":"integer","enum":[0,1,18,35,52,69,86,103,120,137,154,171,188,205,222,239,256,273,290,307,324,341],"default":18},"policy":{"type":"string","enum":["relay-adaptive-target-v1"],"default":"relay-adaptive-target-v1"}}},"imagesRequest":{"type":"object","additionalProperties":false,"properties":{"prompt":{"type":"string","description":"正向提示词","maxLength":8000,"minLength":1},"negative_prompt":{"type":"string","description":"实验性负向 conditioning；空串等价未提供，非空时 CFG 升到 2；Turbo 的排除效果有限","default":"","maxLength":8000},"model":{"type":"string","description":"模型族","default":"z-image","enum":["z-image"],"maxLength":8000},"width":{"type":"integer","description":"width","default":1024,"minimum":256,"maximum":2048,"multipleOf":16},"height":{"type":"integer","description":"height","default":1024,"minimum":256,"maximum":2048,"multipleOf":16},"batch":{"type":"integer","description":"batch","default":1,"minimum":1,"maximum":4},"steps":{"type":"integer","description":"steps","default":9,"minimum":1,"maximum":60},"seed":{"type":"integer","description":"-1 随机","default":-1},"preset":{"type":"string","description":"版本化制作预设；与显式参数冲突则拒绝"},"parent_task_id":{"type":"string","description":"来源素材任务；重做创建新版本"},"group_id":{"type":"string","maxLength":8000,"description":"安全变体组标识；同组同能力，图片/音乐最多 8 个，视频最多 3 个"}},"required":["prompt"]},"speechRequest":{"type":"object","additionalProperties":false,"properties":{"model":{"type":"string","description":"默认云端生成，无需本地显卡；本地模型需 Windows 在线","default":"qwen-audio-3.0-tts-plus","enum":["qwen-audio-3.0-tts-plus","index-tts-2"],"maxLength":8000},"text":{"type":"string","description":"要朗读的文本","maxLength":8000,"minLength":1},"voice_upload":{"type":"string","description":"仅本地 IndexTTS 支持参考音克隆；云端预设无需上传","default":"","maxLength":8000,"pattern":"^$|^[^/\\\\:\\x00]+\\.[wW][aA][vV]$|^[^/\\\\:\\x00]+\\.[mM][pP]3$|^[^/\\\\:\\x00]+\\.[fF][lL][aA][cC]$"},"voice":{"type":"string","description":"云端预设声线，无需上传参考录音；默认龙安灵心","default":"longanlingxin","maxLength":8000},"preset":{"type":"string","description":"版本化制作预设；与显式参数冲突则拒绝"},"parent_task_id":{"type":"string","description":"来源素材任务；重做创建新版本"}},"required":["text"],"allOf":[{"if":{"properties":{"voice_upload":{"minLength":1}},"required":["voice_upload"]},"then":{},"else":{"properties":{"voice":{"enum":["longanlingxin","longanlufeng","gumy_default_voice.wav"]}}}},{"if":{"properties":{"model":{"const":"index-tts-2"}},"required":["model"]},"then":{"properties":{}},"else":{"properties":{"voice":{"enum":["longanlingxin","longanlufeng"]},"voice_upload":{"const":""}}}},{"if":{"properties":{"model":{"const":"index-tts-2"}},"required":["model"],"not":{"properties":{"voice_upload":{"minLength":1}},"required":["voice_upload"]}},"then":{"properties":{"voice":{"enum":["gumy_default_voice.wav"]}}}}]},"musicRequest":{"type":"object","additionalProperties":false,"properties":{"prompt":{"type":"string","description":"风格、情绪、乐器；歌曲可描述原创人声与唱/说唱方式，不保证特定人物声线","maxLength":8000,"minLength":1},"instrumental":{"type":"boolean","description":"默认纯音乐；取消勾选生成歌曲，须填写歌词","default":true},"lyrics":{"type":"string","description":"歌曲必填，可多行及使用 [Verse]/[Chorus]；纯音乐必须留空","default":"","maxLength":8000},"language":{"type":"string","description":"歌词语言：中文 zh、粤语 yue、英文 en；unknown 自动，纯音乐只接受 unknown","default":"unknown","enum":["ar","az","bg","bn","ca","cs","da","de","el","en","es","fa","fi","fr","he","hi","hr","ht","hu","id","is","it","ja","ko","la","lt","ms","ne","nl","no","pa","pl","pt","ro","ru","sa","sk","sr","sv","sw","ta","te","th","tl","tr","uk","ur","vi","yue","zh","unknown"],"maxLength":8000},"duration":{"type":"number","description":"目标时长，实际时长以音频为准（FLAC / 48kHz / 立体声）","default":30.0,"minimum":10.0,"maximum":120.0},"bpm":{"type":"integer","description":"期望节奏（每分钟拍数），模型控制不保证精确","default":120,"minimum":30,"maximum":250},"timesignature":{"type":"string","description":"拍号（分子）","default":"4","enum":["2","3","4","6"],"maxLength":8000},"keyscale":{"type":"string","description":"期望调性，模型控制不保证精确","default":"C major","enum":["C major","C# major","D major","D# major","E major","F major","F# major","G major","G# major","A major","A# major","B major","C minor","C# minor","D minor","D# minor","E minor","F minor","F# minor","G minor","G# minor","A minor","A# minor","B minor"],"maxLength":8000},"seed":{"type":"integer","description":"-1 随机；固定值用于生成变体对照","default":-1,"minimum":-1,"maximum":4294967295},"preset":{"type":"string","description":"版本化制作预设；与显式参数冲突则拒绝"},"parent_task_id":{"type":"string","description":"来源素材任务；重做创建新版本"},"group_id":{"type":"string","maxLength":8000,"description":"安全变体组标识；同组同能力，图片/音乐最多 8 个，视频最多 3 个"}},"required":["prompt"],"allOf":[{"if":{"properties":{"instrumental":{"const":false}},"required":["instrumental"]},"then":{"required":["lyrics"],"properties":{"lyrics":{"pattern":"\\S","not":{"pattern":"^\\s*\\[[Ii][Nn][Ss][Tt][Rr][Uu][Mm][Ee][Nn][Tt][Aa][Ll]\\]\\s*$"}}}},"else":{"properties":{"lyrics":{"pattern":"^\\s*$"},"language":{"const":"unknown"}}}}]},"videosRequest":{"type":"object","additionalProperties":false,"properties":{"prompt":{"type":"string","description":"正向提示词","maxLength":8000,"minLength":1},"model":{"type":"string","description":"视频模型","default":"wan-bernini","enum":["wan-bernini"],"maxLength":8000},"duration":{"type":"number","description":"duration","default":5.0,"minimum":2.0,"maximum":12.0},"width":{"type":"integer","description":"width","default":832,"minimum":256,"maximum":1280,"multipleOf":16},"height":{"type":"integer","description":"height","default":480,"minimum":256,"maximum":1280,"multipleOf":16},"fps":{"type":"integer","description":"fps","default":16,"minimum":16,"maximum":16},"steps":{"type":"integer","description":"steps","default":20,"minimum":4,"maximum":60},"seed":{"type":"integer","description":"seed","default":-1},"preset":{"type":"string","description":"版本化制作预设；与显式参数冲突则拒绝"},"parent_task_id":{"type":"string","description":"来源素材任务；重做创建新版本"},"group_id":{"type":"string","maxLength":8000,"description":"安全变体组标识；同组同能力，图片/音乐最多 8 个，视频最多 3 个"}},"required":["prompt"]},"video_h3Request":{"type":"object","additionalProperties":false,"properties":{"prompt":{"type":"string","description":"正向提示词","maxLength":8000,"minLength":1},"mode":{"type":"string","description":"fl2va=文生视频；ref2va=图片/视频参考（需 image，可加 reference_video）；t2va=基础文生","default":"fl2va","enum":["fl2va","t2va","ref2va"],"maxLength":8000},"image":{"type":"string","description":"ref2va 模式的参考图（上传的文件名）","default":"","maxLength":8000},"reference_video":{"type":"string","description":"ref2va 参考视频；与人物图一起输入，按起点截取 duration 秒，尚不保证逐帧一致","default":"","maxLength":8000},"reference_start":{"type":"number","description":"参考片段起点（秒）；须有 reference_video","default":0.0,"minimum":0.0,"maximum":86400.0},"preserve_source_audio":{"type":"boolean","description":"参考视频成片保留源片段声音（AAC 重编码）；无音轨则保持无声。关闭则用模型生成声音","default":true},"first_frame":{"type":"string","description":"首帧控制（上传的文件名）；仅 fl2va/t2va 支持，与 last_frame 可单用或同用","default":"","maxLength":8000},"last_frame":{"type":"string","description":"尾帧控制（上传的文件名）；仅 fl2va/t2va 支持","default":"","maxLength":8000},"duration":{"type":"number","description":"目标秒数；1秒实际推理39帧(1.625秒)，短于3秒裁到目标；短片质量待实测，3–12秒保持原帧格行为","default":5.0,"minimum":1.0,"maximum":12.0},"width":{"type":"integer","description":"width","default":768,"minimum":480,"maximum":1280,"multipleOf":16},"height":{"type":"integer","description":"宽高须为16倍数；使用首帧或尾帧时须为32倍数（如768×448），不自动拉伸或补边","default":448,"minimum":270,"maximum":1280,"multipleOf":16},"turbo":{"type":"boolean","description":"turbo LoRA 加速","default":true},"seed":{"type":"integer","description":"seed","default":-1},"guides":{"type":"array","description":"可选时间Guide：kind/filename/frame_index及媒体区间；需已验收的新节点，普通reference不等于Guide","maxItems":8,"items":{"type":"object","required":["kind","filename","frame_index"],"additionalProperties":false,"properties":{"kind":{"type":"string","enum":["image","video","audio"]},"filename":{"type":"string","maxLength":255},"start":{"type":"number","minimum":0},"duration":{"type":"number","minimum":1,"maximum":12},"use_audio":{"type":"boolean"},"frame_index":{"type":"integer","minimum":0}}},"default":[]},"control_type":{"type":"string","description":"候选ControlNet V2；调用者提供控制视频，不自动提取Pose/Depth，需单独验收启用","default":"none","enum":["none","canny","depth","pose","hed","mlsd","inpaint"],"maxLength":8000},"control_video":{"type":"string","description":"已准备的控制视频MP4；从control_start取与输出等长区间","default":"","maxLength":8000},"control_source":{"type":"string","description":"局部重绘源视频MP4，必须同时提供mask","default":"","maxLength":8000},"control_mask":{"type":"string","description":"PNG/JPG/WEBP或MP4：红通道>0.5重绘；图片mask重复全段","default":"","maxLength":8000},"control_start":{"type":"number","description":"control_start","default":0,"minimum":0},"control_strength":{"type":"number","description":"control_strength","default":1,"minimum":0.01,"maximum":2},"control_start_percent":{"type":"number","description":"control_start_percent","default":0,"minimum":0,"maximum":1},"control_end_percent":{"type":"number","description":"control_end_percent","default":1,"minimum":0,"maximum":1},"references":{"type":"array","description":"有序参考组：图片、视频、独立音频；可标注人物与用途。与旧单参考字段互斥","maxItems":12,"items":{"type":"object","required":["kind","filename"],"additionalProperties":false,"properties":{"kind":{"type":"string","enum":["image","video","audio"]},"filename":{"type":"string","maxLength":255},"start":{"type":"number","minimum":0},"duration":{"type":"number","minimum":1,"maximum":12},"use_audio":{"type":"boolean"},"subject":{"type":"string","maxLength":120},"role":{"type":"string","maxLength":120}}},"default":[]},"recipe":{"type":"string","description":"legacy 保持原行为；新配方为候选：Ref Turbo4 / FL Turbo8 / 无Turbo 25步。质量与耗时待实测","default":"legacy-v1","enum":["legacy-v1","ref-turbo4-v1","fl-turbo8-v1","base-quality-v1"],"maxLength":8000},"ref_image_size":{"type":"string","description":"match 匹配画布；max 保留更多参考细节但可能显著增加内存和耗时；蒸馏配方仅允许 match","default":"match","enum":["match","max"],"maxLength":8000},"preset":{"type":"string","description":"版本化制作预设；与显式参数冲突则拒绝"},"parent_task_id":{"type":"string","description":"来源素材任务；重做创建新版本"},"group_id":{"type":"string","maxLength":8000,"description":"安全变体组标识；同组同能力，图片/音乐最多 8 个，视频最多 3 个"}},"required":["prompt"],"allOf":[{"if":{"properties":{"mode":{"const":"ref2va"}},"required":["mode"]},"then":{"required":["image"],"properties":{"image":{"minLength":1},"first_frame":{"const":""},"last_frame":{"const":""}}},"else":{"properties":{"image":{"const":""},"reference_video":{"const":""}}}},{"if":{"properties":{"reference_start":{"exclusiveMinimum":0}},"required":["reference_start"]},"then":{"required":["reference_video"],"properties":{"reference_video":{"minLength":1}}}},{"if":{"anyOf":[{"required":["first_frame"],"properties":{"first_frame":{"minLength":1}}},{"required":["last_frame"],"properties":{"last_frame":{"minLength":1}}}]},"then":{"properties":{"width":{"multipleOf":32},"height":{"multipleOf":32}}}}],"x-mode-matrix":{"fl2va":{"image":false,"reference_video":false,"first_frame":true,"last_frame":true},"t2va":{"image":false,"reference_video":false,"first_frame":true,"last_frame":true},"ref2va":{"image":"required","reference_video":true,"first_frame":false,"last_frame":false}},"x-constraints":{"dimension_multiple":16,"frame_condition_dimension_multiple":32,"fps":24,"frame_grid":{"step":17,"offset":5,"rounding":"ceil"},"short_duration":{"min_seconds":1,"native_frames_at_min":39,"delivery":"trim_to_target_below_3_seconds","validation":"static_node_contract_and_cpu_export","quality_review":"pending"},"max_reference_images":9,"max_reference_videos":3,"max_reference_audios":3,"max_reference_assets":12,"verified_reference_images":1,"multi_reference_validation":"candidate","joint_video_and_frame_conditions":false,"reference_semantics":"soft_reference_not_frame_exact","canvas_policy":"explicit_dimensions_no_gateway_resize_or_padding"}},"speech_longRequest":{"type":"object","additionalProperties":false,"properties":{"model":{"type":"string","description":"默认云端生成，无需本地显卡；本地模型需 Windows 在线","default":"qwen-audio-3.0-tts-plus","enum":["qwen-audio-3.0-tts-plus","index-tts-2"],"maxLength":8000},"text":{"type":"string","description":"完整原稿；按语义分段，逐段交付与复用","maxLength":8000,"minLength":1},"voice_upload":{"type":"string","description":"仅本地 IndexTTS 支持参考音克隆；云端预设无需上传","default":"","maxLength":8000,"pattern":"^$|^[^/\\\\:\\x00]+\\.(?:[wW][aA][vV]|[mM][pP]3|[fF][lL][aA][cC])$"},"voice_id":{"type":"string","description":"云端预设声线，无需上传参考录音；默认龙安灵心","default":"longanlingxin","enum":["longanlingxin","longanlufeng","gumy-zh-default-v1"],"maxLength":8000},"source_windows":{"type":"string","description":"仅本地 IndexTTS 支持对白源时窗；可选对白时窗JSON数组：[{\"text\":\"你好\",\"source_in\":0,\"source_out\":2}]；text拼接须与原稿一致。按源起点放置并补静音，超窗保留原音并报告，不裁字或变速","default":"[]","maxLength":8000},"corrections":{"type":"string","description":"纠音 JSON，如 {\"GPU\":\"图形处理器\",\"20%\":\"百分之二十\"}；记录替换，不承诺节点原生拼音控制","default":"{}","maxLength":8000},"segment_chars":{"type":"integer","description":"segment_chars","default":150,"minimum":30,"maximum":250},"normalize_numbers":{"type":"boolean","description":"归一化日期、小数、百分比及常用单位；保留原稿","default":true},"gap_seconds":{"type":"number","description":"gap_seconds","default":0.25,"minimum":0,"maximum":3},"reuse_task_id":{"type":"string","description":"已完成分段口播的任务号；只重做发生变化的段落","default":"","maxLength":8000},"preset":{"type":"string","description":"版本化制作预设；与显式参数冲突则拒绝"},"parent_task_id":{"type":"string","description":"来源素材任务；重做创建新版本"}},"required":["text"],"allOf":[{"if":{"properties":{"model":{"const":"index-tts-2"}},"required":["model"]},"then":{"properties":{"voice_id":{"enum":["gumy-zh-default-v1"]}}},"else":{"properties":{"voice_id":{"enum":["longanlingxin","longanlufeng"]},"voice_upload":{"const":""},"source_windows":{"pattern":"^\\s*\\[\\s*\\]\\s*$"}}}}]},"transcribeRequest":{"type":"object","additionalProperties":false,"properties":{"input":{"type":"string","description":"上传音频或带音轨视频，最长 15 分钟","maxLength":8000,"minLength":1},"language":{"type":"string","description":"language","default":"Chinese","enum":["Chinese","English"],"maxLength":8000},"preset":{"type":"string","description":"版本化制作预设；与显式参数冲突则拒绝"},"parent_task_id":{"type":"string","description":"来源素材任务；重做创建新版本"}},"required":["input"]},"alignRequest":{"type":"object","additionalProperties":false,"properties":{"input":{"type":"string","description":"input","maxLength":8000,"minLength":1},"text":{"type":"string","description":"原始文案；识别差异与强制对齐分别交付","maxLength":8000,"minLength":1},"language":{"type":"string","description":"language","default":"Chinese","enum":["Chinese","English"],"maxLength":8000},"preset":{"type":"string","description":"版本化制作预设；与显式参数冲突则拒绝"},"parent_task_id":{"type":"string","description":"来源素材任务；重做创建新版本"}},"required":["input","text"]},"image_editRequest":{"type":"object","additionalProperties":false,"properties":{"image":{"type":"string","description":"image","maxLength":8000,"minLength":1},"prompt":{"type":"string","description":"prompt","maxLength":8000,"minLength":1},"width":{"type":"integer","description":"width","default":1024,"minimum":256,"maximum":1024,"multipleOf":16},"height":{"type":"integer","description":"height","default":1024,"minimum":256,"maximum":1024,"multipleOf":16},"seed":{"type":"integer","description":"seed","default":-1},"preset":{"type":"string","description":"版本化制作预设；与显式参数冲突则拒绝"},"parent_task_id":{"type":"string","description":"来源素材任务；重做创建新版本"},"group_id":{"type":"string","maxLength":8000,"description":"安全变体组标识；同组同能力，图片/音乐最多 8 个，视频最多 3 个"}},"required":["image","prompt"]},"postprocessRequest":{"type":"object","additionalProperties":false,"properties":{"input":{"type":"string","description":"input","maxLength":8000,"minLength":1},"operation":{"type":"string","description":"operation","enum":["resize","crop","audio_convert","audio_trim","loudness","mix"],"maxLength":8000,"minLength":1},"format":{"type":"string","description":"audio_convert 输出容器；pcm 为 raw s16le","default":"flac","enum":["flac","wav","mp3","opus","aac","pcm"],"maxLength":8000},"width":{"type":"integer","description":"width","default":1024,"minimum":16,"maximum":3840},"height":{"type":"integer","description":"height","default":1024,"minimum":16,"maximum":2160},"x":{"type":"integer","description":"x","default":0,"minimum":0,"maximum":16384},"y":{"type":"integer","description":"y","default":0,"minimum":0,"maximum":16384},"start":{"type":"number","description":"start","default":0,"minimum":0,"maximum":900},"end":{"type":"number","description":"end","default":10,"minimum":0.01,"maximum":900},"sample_rate":{"type":"integer","description":"sample_rate","default":48000,"minimum":8000,"maximum":96000},"channels":{"type":"integer","description":"channels","default":2,"minimum":1,"maximum":2},"lufs":{"type":"number","description":"lufs","default":-16,"minimum":-30,"maximum":-10},"background":{"type":"string","description":"mix 的独立底乐","default":"","maxLength":8000},"background_gain":{"type":"number","description":"background_gain","default":0.12,"minimum":0,"maximum":1},"preset":{"type":"string","description":"版本化制作预设；与显式参数冲突则拒绝"},"parent_task_id":{"type":"string","description":"来源素材任务；重做创建新版本"}},"required":["input","operation"]}}}}