{"openapi":"3.1.0","info":{"title":"公开素材导入","description":"解析能力取决于已安装的 yt-dlp extractor、网络和可选 cookies。不绕过登录、验证码、付费、DRM 或访问控制。媒体通过不可猜测的 token 读取，不提供任意 URL 代理。","version":"1.1.0"},"servers":[{"url":"/link-video"}],"paths":{"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health Health Get"}}}}}}},"/api/v1/platforms":{"get":{"summary":"Platforms","operationId":"platforms_api_v1_platforms_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Platforms Api V1 Platforms Get"}}}}},"security":[{"ServiceBearer":[]}]}},"/api/v1/imports/resolve":{"post":{"summary":"Resolve","operationId":"resolve_api_v1_imports_resolve_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Resolve Api V1 Imports Resolve Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ServiceBearer":[]}]}},"/api/v1/imports":{"post":{"summary":"Create Import","operationId":"create_import_api_v1_imports_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateIn"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Import Api V1 Imports Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ServiceBearer":[]}]},"get":{"summary":"List Imports","operationId":"list_imports_api_v1_imports_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Imports Api V1 Imports Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ServiceBearer":[]}]}},"/api/v1/imports/{import_id}":{"get":{"summary":"Get Import","operationId":"get_import_api_v1_imports__import_id__get","parameters":[{"name":"import_id","in":"path","required":true,"schema":{"type":"string","title":"Import Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Import Api V1 Imports  Import Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ServiceBearer":[]}]},"delete":{"summary":"Delete Import","operationId":"delete_import_api_v1_imports__import_id__delete","parameters":[{"name":"import_id","in":"path","required":true,"schema":{"type":"string","title":"Import Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ServiceBearer":[]}]}},"/api/v1/media/{token}":{"get":{"summary":"Read Media","operationId":"read_media_api_v1_media__token__get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}},{"name":"download","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Download"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"任务或媒体不存在，或已到期清理。"}}}},"/":{"get":{"summary":"Index","operationId":"index__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/guide":{"get":{"summary":"Guide","operationId":"guide_guide_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/assets/{name}":{"get":{"summary":"Asset","operationId":"asset_assets__name__get","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/video-analysis":{"post":{"tags":["视频下载与拆解"],"summary":"Create","operationId":"create_api_v1_video_analysis_post","parameters":[{"name":"idempotency-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisIn"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcceptedTask"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ServiceBearer":[]}]}},"/api/v1/video-analysis/{ident}":{"get":{"tags":["视频下载与拆解"],"summary":"Status","operationId":"status_api_v1_video_analysis__ident__get","parameters":[{"name":"ident","in":"path","required":true,"schema":{"type":"string","title":"Ident"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskState"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"任务或媒体不存在，或已到期清理。"},"410":{"description":"任务到期且尚未物理清理时返回；清理后返回404。"}},"security":[{"ServiceBearer":[]}]},"delete":{"tags":["视频下载与拆解"],"summary":"Cancel","operationId":"cancel_api_v1_video_analysis__ident__delete","parameters":[{"name":"ident","in":"path","required":true,"schema":{"type":"string","title":"Ident"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"任务或媒体不存在，或已到期清理。"},"410":{"description":"任务到期且尚未物理清理时返回；清理后返回404。"}},"security":[{"ServiceBearer":[]}]}},"/api/v1/video-analysis/{ident}/script":{"get":{"tags":["视频下载与拆解"],"summary":"Script","operationId":"script_api_v1_video_analysis__ident__script_get","parameters":[{"name":"ident","in":"path","required":true,"schema":{"type":"string","title":"Ident"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScriptResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"任务或媒体不存在，或已到期清理。"},"410":{"description":"任务到期且尚未物理清理时返回；清理后返回404。"}},"security":[{"ServiceBearer":[]}]}},"/api/v1/video-analysis/{ident}/video":{"get":{"tags":["视频下载与拆解"],"summary":"Video","operationId":"video_api_v1_video_analysis__ident__video_get","parameters":[{"name":"ident","in":"path","required":true,"schema":{"type":"string","title":"Ident"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoMetadata"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"任务或媒体不存在，或已到期清理。"},"410":{"description":"任务到期且尚未物理清理时返回；清理后返回404。"}},"security":[{"ServiceBearer":[]}]}}},"components":{"schemas":{"AcceptedTask":{"properties":{"id":{"type":"string","title":"Id"},"status":{"type":"string","title":"Status"},"expires_at":{"type":"string","title":"Expires At"}},"type":"object","required":["id","status","expires_at"],"title":"AcceptedTask"},"AnalysisIn":{"properties":{"url":{"type":"string","maxLength":8192,"minLength":1,"title":"Url"},"outputs":{"items":{"type":"string"},"type":"array","maxItems":2,"minItems":1,"title":"Outputs"},"brief":{"type":"string","maxLength":4000,"title":"Brief","default":""},"target_duration_seconds":{"type":"integer","maximum":60.0,"minimum":5.0,"title":"Target Duration Seconds","default":30},"aspect_ratio":{"type":"string","pattern":"^(9:16|16:9|1:1)$","title":"Aspect Ratio","default":"9:16"}},"additionalProperties":false,"type":"object","required":["url"],"title":"AnalysisIn"},"CreateIn":{"properties":{"url":{"type":"string","maxLength":2048,"minLength":1,"title":"Url"},"format_id":{"type":"string","maxLength":160,"minLength":1,"title":"Format Id"}},"type":"object","required":["url","format_id"],"title":"CreateIn"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ResolveIn":{"properties":{"url":{"type":"string","maxLength":2048,"minLength":1,"title":"Url"}},"type":"object","required":["url"],"title":"ResolveIn"},"ScriptResult":{"properties":{"text":{"type":"string","title":"Text"},"structured":{"additionalProperties":true,"type":"object","title":"Structured"}},"type":"object","required":["text","structured"],"title":"ScriptResult"},"TaskResult":{"properties":{"script":{"anyOf":[{"$ref":"#/components/schemas/ScriptResult"},{"type":"null"}]},"video":{"anyOf":[{"$ref":"#/components/schemas/VideoMetadata"},{"type":"null"}]}},"type":"object","title":"TaskResult"},"TaskState":{"properties":{"id":{"type":"string","title":"Id"},"status":{"type":"string","title":"Status"},"stage":{"type":"string","title":"Stage"},"source":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Source"},"result":{"$ref":"#/components/schemas/TaskResult"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"},"error":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Error"},"created_at":{"type":"string","title":"Created At"},"finished_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Finished At"},"expires_at":{"type":"string","title":"Expires At"}},"type":"object","required":["id","status","stage","result","warnings","created_at","finished_at","expires_at"],"title":"TaskState"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VideoMetadata":{"properties":{"url":{"type":"string","title":"Url"},"mime":{"type":"string","title":"Mime"},"size_bytes":{"type":"integer","title":"Size Bytes"},"sha256":{"type":"string","title":"Sha256"},"width":{"type":"integer","title":"Width"},"height":{"type":"integer","title":"Height"},"duration_seconds":{"type":"number","title":"Duration Seconds"},"has_audio":{"type":"boolean","title":"Has Audio"},"expires_at":{"type":"string","title":"Expires At"}},"type":"object","required":["url","mime","size_bytes","sha256","width","height","duration_seconds","has_audio","expires_at"],"title":"VideoMetadata"}},"securitySchemes":{"ServiceBearer":{"type":"http","scheme":"bearer","description":"下载拆解服务专用令牌；与模型密钥不同。"}}}}