{"openapi":"3.1.0","info":{"title":"BibiGPT OpenAPI 规范","description":"音视频 AI 学习助理的开放 API，加速音视频内容的信息提取，借助 AI 直接采取行动。","version":"1.1.0"},"servers":[{"url":"https://api.bibigpt.co/api"}],"externalDocs":{"url":"https://docs.bibigpt.co/api"},"paths":{"/version":{"get":{"operationId":"version","summary":"Get the version of the API","tags":["open"],"security":[{"Authorization":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"string"}},"required":["version"],"additionalProperties":false}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/v1/expandUrl":{"get":{"operationId":"expandUrl","summary":"Expand shortened video or audio URLs","tags":["open"],"security":[{"Authorization":[]}],"parameters":[{"in":"query","name":"url","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"costDuration":{"type":"number"},"remainingTime":{"type":"number"}},"required":["url"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/v1/summarize":{"get":{"operationId":"summarize","summary":"Generate video or audio summary from url","tags":["open"],"security":[{"Authorization":[]}],"parameters":[{"in":"query","name":"url","schema":{"type":"string","description":"The URL to the video (e.g., ?url=https://www.bilibili.com/video/BV1Sk4y1x7r2)"},"required":true,"description":"The URL to the video (e.g., ?url=https://www.bilibili.com/video/BV1Sk4y1x7r2)"},{"in":"query","name":"includeDetail","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"id":{"type":"string"},"service":{"type":"string"},"sourceUrl":{"type":"string"},"htmlUrl":{"type":"string"},"summary":{"type":"string"},"costDuration":{"type":"number"},"remainingTime":{"type":"number"},"billingNote":{"type":"string"},"detail":{"anyOf":[{"type":"object","properties":{"summary":{"type":"string"},"dbId":{"type":"string"},"id":{"type":"string"},"embedId":{"type":"string"},"pageId":{"type":"string"},"url":{"type":"string"},"rawLang":{"type":"string"},"translationUrls":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"url":{"type":"string"}},"required":["code","url"],"additionalProperties":false}},"audioUrl":{"type":"string"},"playUrl":{"type":"string"},"type":{"type":"string","enum":["bilibili","youtube","podcast","douyin","tiktok","online-media","url-media","import-file","local-video","local-audio","record-audio","local-subtitle","webpage","meeting"]},"title":{"type":"string"},"cover":{"type":"string"},"author":{"type":"string"},"authorId":{"type":"string"},"duration":{"type":"number"},"publishedDate":{},"subtitlesArray":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"number","description":"The start time of the subtitle item in seconds, e.g. 53.58"},"end":{"type":"number","description":"The end time of the subtitle item in seconds, e.g. 65.08"},"text":{"type":"string","description":"The text of the subtitle item"},"index":{"type":"number","description":"The index of the subtitle item"},"words":{"description":"The words of the subtitle item","type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"text":{"type":"string"},"punctuation":{"type":"string"}},"required":["start","end","text"],"additionalProperties":false}},"speaker_id":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"The speaker id of the subtitle item"},"_isGrouped":{"description":"Whether this subtitle is a grouped subtitle","type":"boolean"},"_originalSubtitles":{"description":"Original subtitles that were grouped together","type":"array","items":{}}},"required":["startTime","end","text","index"],"additionalProperties":false}},{"type":"null"}]},"descriptionText":{"type":"string"},"contentText":{"type":"string"},"aiImages":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"number"},"endTime":{"type":"number"},"image":{"type":"string"},"prompt":{"type":"string"}},"required":["startTime","endTime","prompt"],"additionalProperties":false}},"chapters":{"type":"array","items":{"type":"object","properties":{"from":{"type":"number"},"to":{"type":"number"},"content":{"type":"string"},"type":{"type":"number"},"imgUrl":{"type":"string"}},"required":["from","to","content"],"additionalProperties":false}},"local_path":{"type":"string"},"status":{"type":"string"}},"required":["id","url","type","title","duration"],"additionalProperties":false},{"type":"object","properties":{"dbId":{"type":"string"},"audioUrl":{"type":"string"},"playUrl":{"type":"string"},"videoUrl":{"type":"string"},"title":{"type":"string"},"cover":{"type":"string"},"duration":{"type":"number"},"subtitleUrl":{"type":"string"},"subtitlesArray":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"number","description":"The start time of the subtitle item in seconds, e.g. 53.58"},"end":{"type":"number","description":"The end time of the subtitle item in seconds, e.g. 65.08"},"text":{"type":"string","description":"The text of the subtitle item"},"index":{"type":"number","description":"The index of the subtitle item"},"words":{"description":"The words of the subtitle item","type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"text":{"type":"string"},"punctuation":{"type":"string"}},"required":["start","end","text"],"additionalProperties":false}},"speaker_id":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"The speaker id of the subtitle item"},"_isGrouped":{"description":"Whether this subtitle is a grouped subtitle","type":"boolean"},"_originalSubtitles":{"description":"Original subtitles that were grouped together","type":"array","items":{}}},"required":["startTime","end","text","index"],"additionalProperties":false}},{"type":"null"}]},"translationUrls":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"url":{"type":"string"}},"required":["code","url"],"additionalProperties":false}},"description":{"type":"string"},"format":{"type":"string"},"author":{"type":"string"},"publishedDate":{"type":"string"},"content":{"type":"string"},"authorId":{"type":"string"},"chapters":{"type":"array","items":{"type":"object","properties":{"from":{"type":"number"},"to":{"type":"number"},"content":{"type":"string"},"type":{"type":"number"},"imgUrl":{"type":"string"}},"required":["from","to","content"],"additionalProperties":false}},"rawUrl":{"type":"string"},"rawHtml":{"type":"string"}},"required":["audioUrl","title","cover","duration","description","format","content","rawUrl","rawHtml"],"additionalProperties":false}]}},"required":["success","id","service","sourceUrl","htmlUrl","costDuration","remainingTime"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/v1/summarizeWithConfig":{"post":{"operationId":"summarizeWithConfig","summary":"Generate configurable summary from url based on prompt config","tags":["open"],"security":[{"Authorization":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The URL to the video (e.g., ?url=https://www.bilibili.com/video/BV1Sk4y1x7r2)"},"includeDetail":{"description":"Include audio, video or media webpage detail in response","type":"boolean"},"promptConfig":{"type":"object","properties":{"customPrompt":{"type":"string"},"outputLanguage":{"type":"string"},"autoTranslateLanguage":{"type":"string"},"showEmoji":{"type":"boolean"},"detailLevel":{"type":"number"},"sentenceNumber":{"type":"number"},"isRefresh":{"type":"boolean"},"showTimestamp":{"type":"boolean"},"audioLanguage":{"type":"string"},"whisperPrompt":{"type":"string"},"transcribeProvider":{"type":"string"},"elevenlabsApiKey":{"type":"string"},"speakerCount":{"type":"number"}}},"videoDetail":{"type":"object","properties":{"summary":{"type":"string"},"dbId":{"type":"string"},"id":{"type":"string"},"embedId":{"type":"string"},"pageId":{"type":"string"},"url":{"type":"string"},"subtitleUrl":{"type":"string"},"rawLang":{"type":"string"},"translationUrls":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"url":{"type":"string"}},"required":["code","url"]}},"audioUrl":{"type":"string"},"playUrl":{"type":"string"},"type":{"type":"string","enum":["bilibili","youtube","podcast","douyin","tiktok","online-media","url-media","import-file","local-video","local-audio","record-audio","local-subtitle","webpage","meeting"]},"title":{"type":"string"},"cover":{"type":"string"},"author":{"type":"string"},"authorId":{"type":"string"},"duration":{"type":"number"},"publishedDate":{},"subtitlesArray":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"number","description":"The start time of the subtitle item in seconds, e.g. 53.58"},"end":{"type":"number","description":"The end time of the subtitle item in seconds, e.g. 65.08"},"text":{"type":"string","description":"The text of the subtitle item"},"index":{"type":"number","description":"The index of the subtitle item"},"words":{"description":"The words of the subtitle item","type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"text":{"type":"string"},"punctuation":{"type":"string"}},"required":["start","end","text"]}},"speaker_id":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"The speaker id of the subtitle item"},"_isGrouped":{"description":"Whether this subtitle is a grouped subtitle","type":"boolean"},"_originalSubtitles":{"description":"Original subtitles that were grouped together","type":"array","items":{}}},"required":["startTime","end","text","index"]}},{"type":"null"}]},"descriptionText":{"type":"string"},"contentText":{"type":"string"},"aiImages":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"number"},"endTime":{"type":"number"},"image":{"type":"string"},"prompt":{"type":"string"}},"required":["startTime","endTime","prompt"]}},"chapters":{"type":"array","items":{"type":"object","properties":{"from":{"type":"number"},"to":{"type":"number"},"content":{"type":"string"},"type":{"type":"number"},"imgUrl":{"type":"string"}},"required":["from","to","content"]}},"local_path":{"type":"string"},"status":{"type":"string"}},"required":["id","url","type","title","duration"]}},"required":["url"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"id":{"type":"string"},"service":{"type":"string"},"sourceUrl":{"type":"string"},"htmlUrl":{"type":"string"},"summary":{"type":"string"},"costDuration":{"type":"number"},"remainingTime":{"type":"number"},"billingNote":{"type":"string"},"detail":{"anyOf":[{"type":"object","properties":{"summary":{"type":"string"},"dbId":{"type":"string"},"id":{"type":"string"},"embedId":{"type":"string"},"pageId":{"type":"string"},"url":{"type":"string"},"rawLang":{"type":"string"},"translationUrls":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"url":{"type":"string"}},"required":["code","url"],"additionalProperties":false}},"audioUrl":{"type":"string"},"playUrl":{"type":"string"},"type":{"type":"string","enum":["bilibili","youtube","podcast","douyin","tiktok","online-media","url-media","import-file","local-video","local-audio","record-audio","local-subtitle","webpage","meeting"]},"title":{"type":"string"},"cover":{"type":"string"},"author":{"type":"string"},"authorId":{"type":"string"},"duration":{"type":"number"},"publishedDate":{},"subtitlesArray":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"number","description":"The start time of the subtitle item in seconds, e.g. 53.58"},"end":{"type":"number","description":"The end time of the subtitle item in seconds, e.g. 65.08"},"text":{"type":"string","description":"The text of the subtitle item"},"index":{"type":"number","description":"The index of the subtitle item"},"words":{"description":"The words of the subtitle item","type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"text":{"type":"string"},"punctuation":{"type":"string"}},"required":["start","end","text"],"additionalProperties":false}},"speaker_id":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"The speaker id of the subtitle item"},"_isGrouped":{"description":"Whether this subtitle is a grouped subtitle","type":"boolean"},"_originalSubtitles":{"description":"Original subtitles that were grouped together","type":"array","items":{}}},"required":["startTime","end","text","index"],"additionalProperties":false}},{"type":"null"}]},"descriptionText":{"type":"string"},"contentText":{"type":"string"},"aiImages":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"number"},"endTime":{"type":"number"},"image":{"type":"string"},"prompt":{"type":"string"}},"required":["startTime","endTime","prompt"],"additionalProperties":false}},"chapters":{"type":"array","items":{"type":"object","properties":{"from":{"type":"number"},"to":{"type":"number"},"content":{"type":"string"},"type":{"type":"number"},"imgUrl":{"type":"string"}},"required":["from","to","content"],"additionalProperties":false}},"local_path":{"type":"string"},"status":{"type":"string"}},"required":["id","url","type","title","duration"],"additionalProperties":false},{"type":"object","properties":{"dbId":{"type":"string"},"audioUrl":{"type":"string"},"playUrl":{"type":"string"},"videoUrl":{"type":"string"},"title":{"type":"string"},"cover":{"type":"string"},"duration":{"type":"number"},"subtitleUrl":{"type":"string"},"subtitlesArray":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"number","description":"The start time of the subtitle item in seconds, e.g. 53.58"},"end":{"type":"number","description":"The end time of the subtitle item in seconds, e.g. 65.08"},"text":{"type":"string","description":"The text of the subtitle item"},"index":{"type":"number","description":"The index of the subtitle item"},"words":{"description":"The words of the subtitle item","type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"text":{"type":"string"},"punctuation":{"type":"string"}},"required":["start","end","text"],"additionalProperties":false}},"speaker_id":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"The speaker id of the subtitle item"},"_isGrouped":{"description":"Whether this subtitle is a grouped subtitle","type":"boolean"},"_originalSubtitles":{"description":"Original subtitles that were grouped together","type":"array","items":{}}},"required":["startTime","end","text","index"],"additionalProperties":false}},{"type":"null"}]},"translationUrls":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"url":{"type":"string"}},"required":["code","url"],"additionalProperties":false}},"description":{"type":"string"},"format":{"type":"string"},"author":{"type":"string"},"publishedDate":{"type":"string"},"content":{"type":"string"},"authorId":{"type":"string"},"chapters":{"type":"array","items":{"type":"object","properties":{"from":{"type":"number"},"to":{"type":"number"},"content":{"type":"string"},"type":{"type":"number"},"imgUrl":{"type":"string"}},"required":["from","to","content"],"additionalProperties":false}},"rawUrl":{"type":"string"},"rawHtml":{"type":"string"}},"required":["audioUrl","title","cover","duration","description","format","content","rawUrl","rawHtml"],"additionalProperties":false}]}},"required":["success","id","service","sourceUrl","htmlUrl","costDuration","remainingTime"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/v1/summarizeByChapter":{"get":{"operationId":"summarizeByChapter","summary":"Generate chapter summary for url","tags":["open"],"security":[{"Authorization":[]}],"parameters":[{"in":"query","name":"url","schema":{"type":"string","description":"The URL to the video (e.g., ?url=https://www.bilibili.com/video/BV1Sk4y1x7r2)"},"required":true,"description":"The URL to the video (e.g., ?url=https://www.bilibili.com/video/BV1Sk4y1x7r2)"},{"in":"query","name":"includeDetail","schema":{"type":"boolean"}},{"in":"query","name":"outputLanguage","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"id":{"type":"string"},"service":{"type":"string"},"sourceUrl":{"type":"string"},"htmlUrl":{"type":"string"},"summary":{"type":"string"},"costDuration":{"type":"number"},"remainingTime":{"type":"number"},"billingNote":{"type":"string"},"detail":{"anyOf":[{"type":"object","properties":{"summary":{"type":"string"},"dbId":{"type":"string"},"id":{"type":"string"},"embedId":{"type":"string"},"pageId":{"type":"string"},"url":{"type":"string"},"rawLang":{"type":"string"},"translationUrls":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"url":{"type":"string"}},"required":["code","url"],"additionalProperties":false}},"audioUrl":{"type":"string"},"playUrl":{"type":"string"},"type":{"type":"string","enum":["bilibili","youtube","podcast","douyin","tiktok","online-media","url-media","import-file","local-video","local-audio","record-audio","local-subtitle","webpage","meeting"]},"title":{"type":"string"},"cover":{"type":"string"},"author":{"type":"string"},"authorId":{"type":"string"},"duration":{"type":"number"},"publishedDate":{},"subtitlesArray":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"number","description":"The start time of the subtitle item in seconds, e.g. 53.58"},"end":{"type":"number","description":"The end time of the subtitle item in seconds, e.g. 65.08"},"text":{"type":"string","description":"The text of the subtitle item"},"index":{"type":"number","description":"The index of the subtitle item"},"words":{"description":"The words of the subtitle item","type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"text":{"type":"string"},"punctuation":{"type":"string"}},"required":["start","end","text"],"additionalProperties":false}},"speaker_id":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"The speaker id of the subtitle item"},"_isGrouped":{"description":"Whether this subtitle is a grouped subtitle","type":"boolean"},"_originalSubtitles":{"description":"Original subtitles that were grouped together","type":"array","items":{}}},"required":["startTime","end","text","index"],"additionalProperties":false}},{"type":"null"}]},"descriptionText":{"type":"string"},"contentText":{"type":"string"},"aiImages":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"number"},"endTime":{"type":"number"},"image":{"type":"string"},"prompt":{"type":"string"}},"required":["startTime","endTime","prompt"],"additionalProperties":false}},"chapters":{"type":"array","items":{"type":"object","properties":{"from":{"type":"number"},"to":{"type":"number"},"content":{"type":"string"},"type":{"type":"number"},"imgUrl":{"type":"string"}},"required":["from","to","content"],"additionalProperties":false}},"local_path":{"type":"string"},"status":{"type":"string"}},"required":["id","url","type","title","duration"],"additionalProperties":false},{"type":"object","properties":{"dbId":{"type":"string"},"audioUrl":{"type":"string"},"playUrl":{"type":"string"},"videoUrl":{"type":"string"},"title":{"type":"string"},"cover":{"type":"string"},"duration":{"type":"number"},"subtitleUrl":{"type":"string"},"subtitlesArray":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"number","description":"The start time of the subtitle item in seconds, e.g. 53.58"},"end":{"type":"number","description":"The end time of the subtitle item in seconds, e.g. 65.08"},"text":{"type":"string","description":"The text of the subtitle item"},"index":{"type":"number","description":"The index of the subtitle item"},"words":{"description":"The words of the subtitle item","type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"text":{"type":"string"},"punctuation":{"type":"string"}},"required":["start","end","text"],"additionalProperties":false}},"speaker_id":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"The speaker id of the subtitle item"},"_isGrouped":{"description":"Whether this subtitle is a grouped subtitle","type":"boolean"},"_originalSubtitles":{"description":"Original subtitles that were grouped together","type":"array","items":{}}},"required":["startTime","end","text","index"],"additionalProperties":false}},{"type":"null"}]},"translationUrls":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"url":{"type":"string"}},"required":["code","url"],"additionalProperties":false}},"description":{"type":"string"},"format":{"type":"string"},"author":{"type":"string"},"publishedDate":{"type":"string"},"content":{"type":"string"},"authorId":{"type":"string"},"chapters":{"type":"array","items":{"type":"object","properties":{"from":{"type":"number"},"to":{"type":"number"},"content":{"type":"string"},"type":{"type":"number"},"imgUrl":{"type":"string"}},"required":["from","to","content"],"additionalProperties":false}},"rawUrl":{"type":"string"},"rawHtml":{"type":"string"}},"required":["audioUrl","title","cover","duration","description","format","content","rawUrl","rawHtml"],"additionalProperties":false}]},"url":{"type":"string"},"title":{"type":"string"},"chapterSummary":{"type":"string"},"chapters":{"type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"text":{"type":"string"},"contents":{"type":"array","items":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"},{"type":"string"}]}},"summary":{"type":"string"},"title":{"type":"string"}},"required":["start","end","contents","summary","title"],"additionalProperties":false}}},"required":["success","id","service","sourceUrl","htmlUrl","costDuration","remainingTime","url","title","chapters"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/v1/createSummaryTask":{"get":{"operationId":"createSummaryTask","summary":"Submit video summary processing task","tags":["open"],"security":[{"Authorization":[]}],"parameters":[{"in":"query","name":"url","schema":{"type":"string","description":"The URL to the video (e.g., ?url=https://www.bilibili.com/video/BV1Sk4y1x7r2)"},"required":true,"description":"The URL to the video (e.g., ?url=https://www.bilibili.com/video/BV1Sk4y1x7r2)"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"taskId":{"type":"string"},"status":{"type":"string"},"message":{"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"type":"string"}},"required":["success","taskId","status"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/v1/getSummaryTaskStatus":{"get":{"operationId":"getSummaryTaskStatus","summary":"Check task status and get result if completed","tags":["open"],"security":[{"Authorization":[]}],"parameters":[{"in":"query","name":"taskId","schema":{"type":"string"},"required":true},{"in":"query","name":"includeDetail","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"success":{"type":"boolean"},"taskId":{"type":"string"},"status":{"type":"string"},"message":{"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"type":"string"}},"required":["success","taskId","status"],"additionalProperties":false},{"type":"object","properties":{"success":{"type":"boolean"},"id":{"type":"string"},"service":{"type":"string"},"sourceUrl":{"type":"string"},"htmlUrl":{"type":"string"},"summary":{"type":"string"},"costDuration":{"type":"number"},"remainingTime":{"type":"number"},"billingNote":{"type":"string"},"detail":{"anyOf":[{"type":"object","properties":{"summary":{"type":"string"},"dbId":{"type":"string"},"id":{"type":"string"},"embedId":{"type":"string"},"pageId":{"type":"string"},"url":{"type":"string"},"rawLang":{"type":"string"},"translationUrls":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"url":{"type":"string"}},"required":["code","url"],"additionalProperties":false}},"audioUrl":{"type":"string"},"playUrl":{"type":"string"},"type":{"type":"string","enum":["bilibili","youtube","podcast","douyin","tiktok","online-media","url-media","import-file","local-video","local-audio","record-audio","local-subtitle","webpage","meeting"]},"title":{"type":"string"},"cover":{"type":"string"},"author":{"type":"string"},"authorId":{"type":"string"},"duration":{"type":"number"},"publishedDate":{},"subtitlesArray":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"number","description":"The start time of the subtitle item in seconds, e.g. 53.58"},"end":{"type":"number","description":"The end time of the subtitle item in seconds, e.g. 65.08"},"text":{"type":"string","description":"The text of the subtitle item"},"index":{"type":"number","description":"The index of the subtitle item"},"words":{"description":"The words of the subtitle item","type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"text":{"type":"string"},"punctuation":{"type":"string"}},"required":["start","end","text"],"additionalProperties":false}},"speaker_id":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"The speaker id of the subtitle item"},"_isGrouped":{"description":"Whether this subtitle is a grouped subtitle","type":"boolean"},"_originalSubtitles":{"description":"Original subtitles that were grouped together","type":"array","items":{}}},"required":["startTime","end","text","index"],"additionalProperties":false}},{"type":"null"}]},"descriptionText":{"type":"string"},"contentText":{"type":"string"},"aiImages":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"number"},"endTime":{"type":"number"},"image":{"type":"string"},"prompt":{"type":"string"}},"required":["startTime","endTime","prompt"],"additionalProperties":false}},"chapters":{"type":"array","items":{"type":"object","properties":{"from":{"type":"number"},"to":{"type":"number"},"content":{"type":"string"},"type":{"type":"number"},"imgUrl":{"type":"string"}},"required":["from","to","content"],"additionalProperties":false}},"local_path":{"type":"string"},"status":{"type":"string"}},"required":["id","url","type","title","duration"],"additionalProperties":false},{"type":"object","properties":{"dbId":{"type":"string"},"audioUrl":{"type":"string"},"playUrl":{"type":"string"},"videoUrl":{"type":"string"},"title":{"type":"string"},"cover":{"type":"string"},"duration":{"type":"number"},"subtitleUrl":{"type":"string"},"subtitlesArray":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"number","description":"The start time of the subtitle item in seconds, e.g. 53.58"},"end":{"type":"number","description":"The end time of the subtitle item in seconds, e.g. 65.08"},"text":{"type":"string","description":"The text of the subtitle item"},"index":{"type":"number","description":"The index of the subtitle item"},"words":{"description":"The words of the subtitle item","type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"text":{"type":"string"},"punctuation":{"type":"string"}},"required":["start","end","text"],"additionalProperties":false}},"speaker_id":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"The speaker id of the subtitle item"},"_isGrouped":{"description":"Whether this subtitle is a grouped subtitle","type":"boolean"},"_originalSubtitles":{"description":"Original subtitles that were grouped together","type":"array","items":{}}},"required":["startTime","end","text","index"],"additionalProperties":false}},{"type":"null"}]},"translationUrls":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"url":{"type":"string"}},"required":["code","url"],"additionalProperties":false}},"description":{"type":"string"},"format":{"type":"string"},"author":{"type":"string"},"publishedDate":{"type":"string"},"content":{"type":"string"},"authorId":{"type":"string"},"chapters":{"type":"array","items":{"type":"object","properties":{"from":{"type":"number"},"to":{"type":"number"},"content":{"type":"string"},"type":{"type":"number"},"imgUrl":{"type":"string"}},"required":["from","to","content"],"additionalProperties":false}},"rawUrl":{"type":"string"},"rawHtml":{"type":"string"}},"required":["audioUrl","title","cover","duration","description","format","content","rawUrl","rawHtml"],"additionalProperties":false}]}},"required":["success","id","service","sourceUrl","htmlUrl","costDuration","remainingTime"],"additionalProperties":false}]}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/v1/getSubtitle":{"get":{"operationId":"getSubtitle","summary":"Only returns the video subtitles array in detail","tags":["open"],"security":[{"Authorization":[]}],"parameters":[{"in":"query","name":"url","schema":{"type":"string","description":"The URL to the video (e.g., ?url=https://www.bilibili.com/video/BV1Sk4y1x7r2)"},"required":true,"description":"The URL to the video (e.g., ?url=https://www.bilibili.com/video/BV1Sk4y1x7r2)"},{"in":"query","name":"audioLanguage","schema":{"type":"string"}},{"in":"query","name":"enabledSpeaker","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"id":{"type":"string"},"service":{"type":"string"},"sourceUrl":{"type":"string"},"htmlUrl":{"type":"string"},"summary":{"type":"string"},"costDuration":{"type":"number"},"remainingTime":{"type":"number"},"billingNote":{"type":"string"},"detail":{"anyOf":[{"type":"object","properties":{"summary":{"type":"string"},"dbId":{"type":"string"},"id":{"type":"string"},"embedId":{"type":"string"},"pageId":{"type":"string"},"url":{"type":"string"},"rawLang":{"type":"string"},"translationUrls":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"url":{"type":"string"}},"required":["code","url"],"additionalProperties":false}},"audioUrl":{"type":"string"},"playUrl":{"type":"string"},"type":{"type":"string","enum":["bilibili","youtube","podcast","douyin","tiktok","online-media","url-media","import-file","local-video","local-audio","record-audio","local-subtitle","webpage","meeting"]},"title":{"type":"string"},"cover":{"type":"string"},"author":{"type":"string"},"authorId":{"type":"string"},"duration":{"type":"number"},"publishedDate":{},"subtitlesArray":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"number","description":"The start time of the subtitle item in seconds, e.g. 53.58"},"end":{"type":"number","description":"The end time of the subtitle item in seconds, e.g. 65.08"},"text":{"type":"string","description":"The text of the subtitle item"},"index":{"type":"number","description":"The index of the subtitle item"},"words":{"description":"The words of the subtitle item","type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"text":{"type":"string"},"punctuation":{"type":"string"}},"required":["start","end","text"],"additionalProperties":false}},"speaker_id":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"The speaker id of the subtitle item"},"_isGrouped":{"description":"Whether this subtitle is a grouped subtitle","type":"boolean"},"_originalSubtitles":{"description":"Original subtitles that were grouped together","type":"array","items":{}}},"required":["startTime","end","text","index"],"additionalProperties":false}},{"type":"null"}]},"descriptionText":{"type":"string"},"contentText":{"type":"string"},"aiImages":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"number"},"endTime":{"type":"number"},"image":{"type":"string"},"prompt":{"type":"string"}},"required":["startTime","endTime","prompt"],"additionalProperties":false}},"chapters":{"type":"array","items":{"type":"object","properties":{"from":{"type":"number"},"to":{"type":"number"},"content":{"type":"string"},"type":{"type":"number"},"imgUrl":{"type":"string"}},"required":["from","to","content"],"additionalProperties":false}},"local_path":{"type":"string"},"status":{"type":"string"}},"required":["id","url","type","title","duration"],"additionalProperties":false},{"type":"object","properties":{"dbId":{"type":"string"},"audioUrl":{"type":"string"},"playUrl":{"type":"string"},"videoUrl":{"type":"string"},"title":{"type":"string"},"cover":{"type":"string"},"duration":{"type":"number"},"subtitleUrl":{"type":"string"},"subtitlesArray":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"number","description":"The start time of the subtitle item in seconds, e.g. 53.58"},"end":{"type":"number","description":"The end time of the subtitle item in seconds, e.g. 65.08"},"text":{"type":"string","description":"The text of the subtitle item"},"index":{"type":"number","description":"The index of the subtitle item"},"words":{"description":"The words of the subtitle item","type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"text":{"type":"string"},"punctuation":{"type":"string"}},"required":["start","end","text"],"additionalProperties":false}},"speaker_id":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"The speaker id of the subtitle item"},"_isGrouped":{"description":"Whether this subtitle is a grouped subtitle","type":"boolean"},"_originalSubtitles":{"description":"Original subtitles that were grouped together","type":"array","items":{}}},"required":["startTime","end","text","index"],"additionalProperties":false}},{"type":"null"}]},"translationUrls":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"url":{"type":"string"}},"required":["code","url"],"additionalProperties":false}},"description":{"type":"string"},"format":{"type":"string"},"author":{"type":"string"},"publishedDate":{"type":"string"},"content":{"type":"string"},"authorId":{"type":"string"},"chapters":{"type":"array","items":{"type":"object","properties":{"from":{"type":"number"},"to":{"type":"number"},"content":{"type":"string"},"type":{"type":"number"},"imgUrl":{"type":"string"}},"required":["from","to","content"],"additionalProperties":false}},"rawUrl":{"type":"string"},"rawHtml":{"type":"string"}},"required":["audioUrl","title","cover","duration","description","format","content","rawUrl","rawHtml"],"additionalProperties":false}]}},"required":["success","id","service","sourceUrl","htmlUrl","costDuration","remainingTime"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/v1/getPolishedText":{"get":{"operationId":"getPolishedText","summary":"Polish video subtitles into readable article segments","tags":["open"],"security":[{"Authorization":[]}],"parameters":[{"in":"query","name":"url","schema":{"type":"string","description":"The URL to the video (e.g., ?url=https://www.bilibili.com/video/BV1Sk4y1x7r2)"},"required":true,"description":"The URL to the video (e.g., ?url=https://www.bilibili.com/video/BV1Sk4y1x7r2)"},{"in":"query","name":"includeDetail","schema":{"type":"boolean"}},{"in":"query","name":"keywords","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"id":{"type":"string"},"service":{"type":"string"},"sourceUrl":{"type":"string"},"htmlUrl":{"type":"string"},"title":{"type":"string"},"segments":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"number"},"endTime":{"type":"number"},"chapterTitle":{"type":"string"},"polishedText":{"type":"string"},"fromCache":{"type":"boolean"}},"required":["startTime","endTime","polishedText","fromCache"],"additionalProperties":false}},"costDuration":{"type":"number"},"remainingTime":{"type":"number"},"detail":{"anyOf":[{"type":"object","properties":{"summary":{"type":"string"},"dbId":{"type":"string"},"id":{"type":"string"},"embedId":{"type":"string"},"pageId":{"type":"string"},"url":{"type":"string"},"rawLang":{"type":"string"},"translationUrls":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"url":{"type":"string"}},"required":["code","url"],"additionalProperties":false}},"audioUrl":{"type":"string"},"playUrl":{"type":"string"},"type":{"type":"string","enum":["bilibili","youtube","podcast","douyin","tiktok","online-media","url-media","import-file","local-video","local-audio","record-audio","local-subtitle","webpage","meeting"]},"title":{"type":"string"},"cover":{"type":"string"},"author":{"type":"string"},"authorId":{"type":"string"},"duration":{"type":"number"},"publishedDate":{},"subtitlesArray":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"number","description":"The start time of the subtitle item in seconds, e.g. 53.58"},"end":{"type":"number","description":"The end time of the subtitle item in seconds, e.g. 65.08"},"text":{"type":"string","description":"The text of the subtitle item"},"index":{"type":"number","description":"The index of the subtitle item"},"words":{"description":"The words of the subtitle item","type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"text":{"type":"string"},"punctuation":{"type":"string"}},"required":["start","end","text"],"additionalProperties":false}},"speaker_id":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"The speaker id of the subtitle item"},"_isGrouped":{"description":"Whether this subtitle is a grouped subtitle","type":"boolean"},"_originalSubtitles":{"description":"Original subtitles that were grouped together","type":"array","items":{}}},"required":["startTime","end","text","index"],"additionalProperties":false}},{"type":"null"}]},"descriptionText":{"type":"string"},"contentText":{"type":"string"},"aiImages":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"number"},"endTime":{"type":"number"},"image":{"type":"string"},"prompt":{"type":"string"}},"required":["startTime","endTime","prompt"],"additionalProperties":false}},"chapters":{"type":"array","items":{"type":"object","properties":{"from":{"type":"number"},"to":{"type":"number"},"content":{"type":"string"},"type":{"type":"number"},"imgUrl":{"type":"string"}},"required":["from","to","content"],"additionalProperties":false}},"local_path":{"type":"string"},"status":{"type":"string"}},"required":["id","url","type","title","duration"],"additionalProperties":false},{"type":"object","properties":{"dbId":{"type":"string"},"audioUrl":{"type":"string"},"playUrl":{"type":"string"},"videoUrl":{"type":"string"},"title":{"type":"string"},"cover":{"type":"string"},"duration":{"type":"number"},"subtitleUrl":{"type":"string"},"subtitlesArray":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"number","description":"The start time of the subtitle item in seconds, e.g. 53.58"},"end":{"type":"number","description":"The end time of the subtitle item in seconds, e.g. 65.08"},"text":{"type":"string","description":"The text of the subtitle item"},"index":{"type":"number","description":"The index of the subtitle item"},"words":{"description":"The words of the subtitle item","type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"text":{"type":"string"},"punctuation":{"type":"string"}},"required":["start","end","text"],"additionalProperties":false}},"speaker_id":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"The speaker id of the subtitle item"},"_isGrouped":{"description":"Whether this subtitle is a grouped subtitle","type":"boolean"},"_originalSubtitles":{"description":"Original subtitles that were grouped together","type":"array","items":{}}},"required":["startTime","end","text","index"],"additionalProperties":false}},{"type":"null"}]},"translationUrls":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"url":{"type":"string"}},"required":["code","url"],"additionalProperties":false}},"description":{"type":"string"},"format":{"type":"string"},"author":{"type":"string"},"publishedDate":{"type":"string"},"content":{"type":"string"},"authorId":{"type":"string"},"chapters":{"type":"array","items":{"type":"object","properties":{"from":{"type":"number"},"to":{"type":"number"},"content":{"type":"string"},"type":{"type":"number"},"imgUrl":{"type":"string"}},"required":["from","to","content"],"additionalProperties":false}},"rawUrl":{"type":"string"},"rawHtml":{"type":"string"}},"required":["audioUrl","title","cover","duration","description","format","content","rawUrl","rawHtml"],"additionalProperties":false}]}},"required":["success","id","service","sourceUrl","htmlUrl","segments","costDuration","remainingTime"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/v1/express":{"get":{"operationId":"express","summary":"Rewrite video subtitles as a polished article","tags":["open"],"security":[{"Authorization":[]}],"parameters":[{"in":"query","name":"url","schema":{"type":"string","description":"The URL to the video (e.g., ?url=https://www.bilibili.com/video/BV1Sk4y1x7r2)"},"required":true,"description":"The URL to the video (e.g., ?url=https://www.bilibili.com/video/BV1Sk4y1x7r2)"},{"in":"query","name":"includeDetail","schema":{"type":"boolean"}},{"in":"query","name":"outputLanguage","schema":{"type":"string"}},{"in":"query","name":"model","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"id":{"type":"string"},"service":{"type":"string"},"sourceUrl":{"type":"string"},"htmlUrl":{"type":"string"},"title":{"type":"string"},"article":{"type":"string"},"fromCache":{"type":"boolean"},"costDuration":{"type":"number"},"remainingTime":{"type":"number"},"detail":{"anyOf":[{"type":"object","properties":{"summary":{"type":"string"},"dbId":{"type":"string"},"id":{"type":"string"},"embedId":{"type":"string"},"pageId":{"type":"string"},"url":{"type":"string"},"rawLang":{"type":"string"},"translationUrls":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"url":{"type":"string"}},"required":["code","url"],"additionalProperties":false}},"audioUrl":{"type":"string"},"playUrl":{"type":"string"},"type":{"type":"string","enum":["bilibili","youtube","podcast","douyin","tiktok","online-media","url-media","import-file","local-video","local-audio","record-audio","local-subtitle","webpage","meeting"]},"title":{"type":"string"},"cover":{"type":"string"},"author":{"type":"string"},"authorId":{"type":"string"},"duration":{"type":"number"},"publishedDate":{},"subtitlesArray":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"number","description":"The start time of the subtitle item in seconds, e.g. 53.58"},"end":{"type":"number","description":"The end time of the subtitle item in seconds, e.g. 65.08"},"text":{"type":"string","description":"The text of the subtitle item"},"index":{"type":"number","description":"The index of the subtitle item"},"words":{"description":"The words of the subtitle item","type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"text":{"type":"string"},"punctuation":{"type":"string"}},"required":["start","end","text"],"additionalProperties":false}},"speaker_id":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"The speaker id of the subtitle item"},"_isGrouped":{"description":"Whether this subtitle is a grouped subtitle","type":"boolean"},"_originalSubtitles":{"description":"Original subtitles that were grouped together","type":"array","items":{}}},"required":["startTime","end","text","index"],"additionalProperties":false}},{"type":"null"}]},"descriptionText":{"type":"string"},"contentText":{"type":"string"},"aiImages":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"number"},"endTime":{"type":"number"},"image":{"type":"string"},"prompt":{"type":"string"}},"required":["startTime","endTime","prompt"],"additionalProperties":false}},"chapters":{"type":"array","items":{"type":"object","properties":{"from":{"type":"number"},"to":{"type":"number"},"content":{"type":"string"},"type":{"type":"number"},"imgUrl":{"type":"string"}},"required":["from","to","content"],"additionalProperties":false}},"local_path":{"type":"string"},"status":{"type":"string"}},"required":["id","url","type","title","duration"],"additionalProperties":false},{"type":"object","properties":{"dbId":{"type":"string"},"audioUrl":{"type":"string"},"playUrl":{"type":"string"},"videoUrl":{"type":"string"},"title":{"type":"string"},"cover":{"type":"string"},"duration":{"type":"number"},"subtitleUrl":{"type":"string"},"subtitlesArray":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"number","description":"The start time of the subtitle item in seconds, e.g. 53.58"},"end":{"type":"number","description":"The end time of the subtitle item in seconds, e.g. 65.08"},"text":{"type":"string","description":"The text of the subtitle item"},"index":{"type":"number","description":"The index of the subtitle item"},"words":{"description":"The words of the subtitle item","type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"text":{"type":"string"},"punctuation":{"type":"string"}},"required":["start","end","text"],"additionalProperties":false}},"speaker_id":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"The speaker id of the subtitle item"},"_isGrouped":{"description":"Whether this subtitle is a grouped subtitle","type":"boolean"},"_originalSubtitles":{"description":"Original subtitles that were grouped together","type":"array","items":{}}},"required":["startTime","end","text","index"],"additionalProperties":false}},{"type":"null"}]},"translationUrls":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"url":{"type":"string"}},"required":["code","url"],"additionalProperties":false}},"description":{"type":"string"},"format":{"type":"string"},"author":{"type":"string"},"publishedDate":{"type":"string"},"content":{"type":"string"},"authorId":{"type":"string"},"chapters":{"type":"array","items":{"type":"object","properties":{"from":{"type":"number"},"to":{"type":"number"},"content":{"type":"string"},"type":{"type":"number"},"imgUrl":{"type":"string"}},"required":["from","to","content"],"additionalProperties":false}},"rawUrl":{"type":"string"},"rawHtml":{"type":"string"}},"required":["audioUrl","title","cover","duration","description","format","content","rawUrl","rawHtml"],"additionalProperties":false}]}},"required":["success","id","service","sourceUrl","htmlUrl","article","fromCache","costDuration","remainingTime"],"additionalProperties":false}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Authorization not provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}}},"components":{"schemas":{"error.UNAUTHORIZED":{"type":"object","properties":{"message":{"type":"string","description":"The error message","example":"Authorization not provided"},"code":{"type":"string","description":"The error code","example":"UNAUTHORIZED"},"issues":{"description":"An array of issues that were responsible for the error","example":[],"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}},"required":["message","code"],"additionalProperties":false,"title":"Authorization not provided error (401)","description":"The error information","example":{"code":"UNAUTHORIZED","message":"Authorization not provided","issues":[]}},"error.FORBIDDEN":{"type":"object","properties":{"message":{"type":"string","description":"The error message","example":"Insufficient access"},"code":{"type":"string","description":"The error code","example":"FORBIDDEN"},"issues":{"description":"An array of issues that were responsible for the error","example":[],"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}},"required":["message","code"],"additionalProperties":false,"title":"Insufficient access error (403)","description":"The error information","example":{"code":"FORBIDDEN","message":"Insufficient access","issues":[]}},"error.INTERNAL_SERVER_ERROR":{"type":"object","properties":{"message":{"type":"string","description":"The error message","example":"Internal server error"},"code":{"type":"string","description":"The error code","example":"INTERNAL_SERVER_ERROR"},"issues":{"description":"An array of issues that were responsible for the error","example":[],"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}},"required":["message","code"],"additionalProperties":false,"title":"Internal server error error (500)","description":"The error information","example":{"code":"INTERNAL_SERVER_ERROR","message":"Internal server error","issues":[]}},"error.BAD_REQUEST":{"type":"object","properties":{"message":{"type":"string","description":"The error message","example":"Invalid input data"},"code":{"type":"string","description":"The error code","example":"BAD_REQUEST"},"issues":{"description":"An array of issues that were responsible for the error","example":[],"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}},"required":["message","code"],"additionalProperties":false,"title":"Invalid input data error (400)","description":"The error information","example":{"code":"BAD_REQUEST","message":"Invalid input data","issues":[]}},"error.NOT_FOUND":{"type":"object","properties":{"message":{"type":"string","description":"The error message","example":"Not found"},"code":{"type":"string","description":"The error code","example":"NOT_FOUND"},"issues":{"description":"An array of issues that were responsible for the error","example":[],"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}},"required":["message","code"],"additionalProperties":false,"title":"Not found error (404)","description":"The error information","example":{"code":"NOT_FOUND","message":"Not found","issues":[]}}},"securitySchemes":{"Authorization":{"type":"http","scheme":"bearer"}}}}