{"openapi":"3.1.0","info":{"title":"Potseo API","version":"0.1.0","description":"多平台分享链接解析；会员每日额度与独立点数计费，成功消耗 1 点。Web 文档：/docs/watermark"},"servers":[{"url":"/"}],"paths":{"/api/v1/watermark/parse":{"post":{"summary":"同步解析平台分享链接；成功消耗 1 点，失败不扣","security":[{"ApiKey":[]}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Envelope"},{"properties":{"data":{"$ref":"#/components/schemas/ParsedMedia"}}}]}}},"headers":{"X-Parse-Request-ID":{"schema":{"type":"string"},"description":"原始解析请求 ID，重放时保持一致"},"X-Billing-Source":{"schema":{"type":"string","enum":["member","points"]}},"X-Billed-Points":{"schema":{"type":"string"},"description":"原请求消耗 1 点；幂等重放不再次扣点"}}},"400":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"402":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"403":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"409":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"410":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"429":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"500":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"503":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"415":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"502":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParseInput"}}}},"parameters":[{"in":"header","name":"Idempotency-Key","required":false,"description":"账号内唯一，1–128 位可见 ASCII；相同参数复用原结果，24 小时后返回 410，旧键不会重新计费","schema":{"type":"string","minLength":1,"maxLength":128}}]}},"/api/v1/usage":{"get":{"summary":"查询当前密钥最近 50 条调用记录","security":[{"ApiKey":[]}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"402":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"403":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"409":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"410":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"429":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"500":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"503":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}}}},"/api/v1/billing":{"get":{"summary":"查询本人会员每日额度和点数余额","security":[{"ApiKey":[]}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"402":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"403":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"409":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"410":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"429":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"500":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"503":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}}}},"/api/v1/requests/{request_id}":{"get":{"summary":"查询本人原始请求状态和结果，保留 24 小时","security":[{"ApiKey":[]}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"402":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"403":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"409":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"410":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"429":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"500":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"503":{"description":"请求失败；message 为可读说明，request_id 用于排查","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}},"parameters":[{"in":"path","name":"request_id","required":true,"schema":{"type":"string"}}]}}},"components":{"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer"}},"schemas":{"ParseInput":{"additionalProperties":false,"properties":{"text":{"maxLength":4096,"minLength":1,"title":"Text","type":"string"}},"required":["text"],"title":"ParseInput","type":"object"},"Envelope":{"type":"object","required":["code","message","request_id","data"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"},"data":{}}},"ParsedMedia":{"type":"object","properties":{"video_id":{"type":"string"},"platform":{"type":"string"},"title":{"type":"string"},"video_url":{"type":["string","null"]},"cover_url":{"type":["string","null"]},"audio_url":{"type":["string","null"]},"author":{"type":"object"},"images":{"type":"array","items":{"oneOf":[{"type":"string"},{"type":"object","properties":{"url":{"type":"string"},"live_photo_url":{"type":"string"}}}]}},"video_list":{"type":"array","items":{"type":"string"}},"subtitles":{},"subtitle_status":{"type":"integer"}}}}}}