{"openapi":"3.1.0","info":{"title":"Whisper API — mayelk7.fr","description":"Audio transcription (Whisper large-v3). Documentation: https://whisper.mayelk7.fr/","version":"2.0"},"paths":{"/health":{"get":{"tags":["Service"],"summary":"Service status (no token needed)","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/me":{"get":{"tags":["Service"],"summary":"Your token and usage","operationId":"me_me_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","description":"Bearer <token>","default":"","title":"Authorization"},"description":"Bearer <token>"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/transcriptions":{"post":{"tags":["Transcriptions"],"summary":"Submit a file","operationId":"submit_transcriptions_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","description":"Bearer <token>","default":"","title":"Authorization"},"description":"Bearer <token>"}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_submit_transcriptions_post"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["Transcriptions"],"summary":"List your tasks (last 24 hours)","operationId":"list_tasks_transcriptions_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","description":"Bearer <token>","default":"","title":"Authorization"},"description":"Bearer <token>"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/transcriptions/{task_id}":{"get":{"tags":["Transcriptions"],"summary":"Task status and result","operationId":"get_task_transcriptions__task_id__get","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","description":"Bearer <token>","default":"","title":"Authorization"},"description":"Bearer <token>"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Transcriptions"],"summary":"Delete a task (cancels it if still queued)","operationId":"delete_task_transcriptions__task_id__delete","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","description":"Bearer <token>","default":"","title":"Authorization"},"description":"Bearer <token>"}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/transcriptions/{task_id}/txt":{"get":{"tags":["Transcriptions"],"summary":"Result as plain text","operationId":"get_txt_transcriptions__task_id__txt_get","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","description":"Bearer <token>","default":"","title":"Authorization"},"description":"Bearer <token>"}],"responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/transcriptions/{task_id}/srt":{"get":{"tags":["Transcriptions"],"summary":"Result as SRT subtitles","operationId":"get_srt_transcriptions__task_id__srt_get","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","description":"Bearer <token>","default":"","title":"Authorization"},"description":"Bearer <token>"}],"responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/transcriptions/{task_id}/vtt":{"get":{"tags":["Transcriptions"],"summary":"Result as WebVTT subtitles","operationId":"get_vtt_transcriptions__task_id__vtt_get","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","description":"Bearer <token>","default":"","title":"Authorization"},"description":"Bearer <token>"}],"responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"Body_submit_transcriptions_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"Audio or video file"},"language":{"type":"string","title":"Language","description":"ISO 639-1 code (fr, en, es…) or \"auto\"","default":"fr"},"model":{"type":"string","title":"Model","description":"large-v3 | large-v3-turbo | medium | small","default":"large-v3"}},"type":"object","required":["file"],"title":"Body_submit_transcriptions_post"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"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"}}}}