{"openapi":"3.1.0","info":{"title":"QSign Translator API","description":"Prototype RU/KZ/EN text-to-sign-plan API with transparent draft output. Not a professional interpretation.","version":"0.2.0"},"paths":{"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health/live":{"get":{"summary":"Live","operationId":"live_health_live_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health/ready":{"get":{"summary":"Ready","operationId":"ready_health_ready_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/translate/text":{"post":{"summary":"Translate Text","operationId":"translate_text_v1_translate_text_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TextTranslateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Translate Text V1 Translate Text Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/transcribe/audio":{"post":{"summary":"Transcribe Audio","operationId":"transcribe_audio_v1_transcribe_audio_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Transcribe Audio V1 Transcribe Audio Post"}}}}}}},"/v1/sources":{"get":{"summary":"Sources","operationId":"sources_v1_sources_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Sources V1 Sources Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/lexicon":{"get":{"summary":"Lexicon","operationId":"lexicon_v1_lexicon_get","parameters":[{"name":"language","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Lexicon V1 Lexicon Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}":{"get":{"summary":"Translation Job","operationId":"translation_job_v1_jobs__job_id__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Translation Job V1 Jobs  Job Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/render-plan":{"get":{"summary":"Translation Job Render Plan","operationId":"translation_job_render_plan_v1_jobs__job_id__render_plan_get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Translation Job Render Plan V1 Jobs  Job Id  Render Plan Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/review-video":{"get":{"summary":"Translation Job Review Video","operationId":"translation_job_review_video_v1_jobs__job_id__review_video_get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/rendered-video":{"get":{"summary":"Translation Job Rendered Video","operationId":"translation_job_rendered_video_v1_jobs__job_id__rendered_video_get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/ai-video-brief":{"get":{"summary":"Translation Job Ai Video Brief","operationId":"translation_job_ai_video_brief_v1_jobs__job_id__ai_video_brief_get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Translation Job Ai Video Brief V1 Jobs  Job Id  Ai Video Brief Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ai-video-batch-brief":{"post":{"summary":"Ai Video Batch Brief","operationId":"ai_video_batch_brief_v1_ai_video_batch_brief_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchAIVideoBriefRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Ai Video Batch Brief V1 Ai Video Batch Brief Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/review/login":{"post":{"summary":"Review Login","operationId":"review_login_v1_review_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewLoginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Review Login V1 Review Login Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/review/logout":{"post":{"summary":"Review Logout","operationId":"review_logout_v1_review_logout_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Review Logout V1 Review Logout Post"}}}}}}},"/v1/review/me":{"get":{"summary":"Review Me","operationId":"review_me_v1_review_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Review Me V1 Review Me Get"}}}}}}},"/v1/review/system-status":{"get":{"summary":"Review System Status","operationId":"review_system_status_v1_review_system_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Review System Status V1 Review System Status Get"}}}}}}},"/v1/review/coverage-report":{"get":{"summary":"Review Coverage Report","operationId":"review_coverage_report_v1_review_coverage_report_get","parameters":[{"name":"limit_jobs","in":"query","required":false,"schema":{"type":"integer","default":500,"title":"Limit Jobs"}},{"name":"limit_terms","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit Terms"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Review Coverage Report V1 Review Coverage Report Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/review/jobs":{"get":{"summary":"Review Jobs","operationId":"review_jobs_v1_review_jobs_get","parameters":[{"name":"review_status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Review Status"}},{"name":"publish_status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publish Status"}},{"name":"detected_language","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detected Language"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Review Jobs V1 Review Jobs Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/review/jobs/{job_id}":{"patch":{"summary":"Review Job","operationId":"review_job_v1_review_jobs__job_id__patch","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewStatusRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Review Job V1 Review Jobs  Job Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/review/feedback":{"get":{"summary":"Review Feedback","operationId":"review_feedback_v1_review_feedback_get","parameters":[{"name":"job_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Review Feedback V1 Review Feedback Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/review/audit":{"get":{"summary":"Review Audit","operationId":"review_audit_v1_review_audit_get","parameters":[{"name":"job_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Review Audit V1 Review Audit Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/review/sessions":{"get":{"summary":"Review Sessions","operationId":"review_sessions_v1_review_sessions_get","parameters":[{"name":"job_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Review Sessions V1 Review Sessions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"summary":"Create Review Session","operationId":"create_review_session_v1_review_sessions_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewSessionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Review Session V1 Review Sessions Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/review/jobs/{job_id}/rendered-video":{"post":{"summary":"Upload Rendered Video","operationId":"upload_rendered_video_v1_review_jobs__job_id__rendered_video_post","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Upload Rendered Video V1 Review Jobs  Job Id  Rendered Video Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/review/jobs/{job_id}/publish-status":{"patch":{"summary":"Update Job Publish Status","operationId":"update_job_publish_status_v1_review_jobs__job_id__publish_status_patch","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishStatusRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Job Publish Status V1 Review Jobs  Job Id  Publish Status Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/review/lexicon-candidates":{"get":{"summary":"Review Lexicon Candidates","operationId":"review_lexicon_candidates_v1_review_lexicon_candidates_get","parameters":[{"name":"job_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Id"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Review Lexicon Candidates V1 Review Lexicon Candidates Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"summary":"Create Review Lexicon Candidate","operationId":"create_review_lexicon_candidate_v1_review_lexicon_candidates_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LexiconSuggestionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Review Lexicon Candidate V1 Review Lexicon Candidates Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/feedback":{"post":{"summary":"Feedback","operationId":"feedback_v1_feedback_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Feedback V1 Feedback Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"BatchAIVideoBriefRequest":{"properties":{"job_ids":{"items":{"type":"string"},"type":"array","maxItems":20,"minItems":1,"title":"Job Ids"},"title":{"anyOf":[{"type":"string","maxLength":120,"minLength":1},{"type":"null"}],"title":"Title"}},"type":"object","required":["job_ids"],"title":"BatchAIVideoBriefRequest"},"FeedbackRequest":{"properties":{"job_id":{"type":"string","maxLength":80,"minLength":1,"title":"Job Id"},"feedback_type":{"type":"string","maxLength":40,"minLength":1,"title":"Feedback Type"},"note":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Note"}},"type":"object","required":["job_id","feedback_type"],"title":"FeedbackRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LexiconSuggestionRequest":{"properties":{"job_id":{"type":"string","maxLength":80,"minLength":1,"title":"Job Id"},"unit_position":{"type":"integer","maximum":500.0,"minimum":1.0,"title":"Unit Position"},"source_token":{"type":"string","maxLength":200,"minLength":1,"title":"Source Token"},"suggested_gloss":{"type":"string","maxLength":200,"minLength":1,"title":"Suggested Gloss"},"suggested_language":{"type":"string","enum":["ru","kk","en","rsl","krsl","asl"],"title":"Suggested Language"},"suggested_clip_id":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Suggested Clip Id"},"reason":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Reason"}},"type":"object","required":["job_id","unit_position","source_token","suggested_gloss","suggested_language"],"title":"LexiconSuggestionRequest"},"PublishStatusRequest":{"properties":{"publish_status":{"type":"string","maxLength":40,"minLength":1,"title":"Publish Status"},"note":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Note"}},"type":"object","required":["publish_status"],"title":"PublishStatusRequest"},"ReviewLoginRequest":{"properties":{"token":{"type":"string","maxLength":200,"minLength":1,"title":"Token"},"role":{"type":"string","enum":["admin","reviewer","linguist","operator","native_signer"],"title":"Role","default":"operator"}},"type":"object","required":["token"],"title":"ReviewLoginRequest"},"ReviewSessionRequest":{"properties":{"job_id":{"type":"string","maxLength":80,"minLength":1,"title":"Job Id"},"reviewer_role":{"type":"string","maxLength":80,"minLength":1,"title":"Reviewer Role"},"reviewer_language":{"type":"string","maxLength":20,"minLength":1,"title":"Reviewer Language"},"review_status":{"anyOf":[{"type":"string","maxLength":40,"minLength":1},{"type":"null"}],"title":"Review Status"},"meaning_score":{"anyOf":[{"type":"integer","maximum":5.0,"minimum":1.0},{"type":"null"}],"title":"Meaning Score"},"sign_choice_score":{"anyOf":[{"type":"integer","maximum":5.0,"minimum":1.0},{"type":"null"}],"title":"Sign Choice Score"},"grammar_score":{"anyOf":[{"type":"integer","maximum":5.0,"minimum":1.0},{"type":"null"}],"title":"Grammar Score"},"nonmanual_score":{"anyOf":[{"type":"integer","maximum":5.0,"minimum":1.0},{"type":"null"}],"title":"Nonmanual Score"},"fingerspelling_score":{"anyOf":[{"type":"integer","maximum":5.0,"minimum":1.0},{"type":"null"}],"title":"Fingerspelling Score"},"timing_score":{"anyOf":[{"type":"integer","maximum":5.0,"minimum":1.0},{"type":"null"}],"title":"Timing Score"},"understandability_score":{"anyOf":[{"type":"integer","maximum":5.0,"minimum":1.0},{"type":"null"}],"title":"Understandability Score"},"notes":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Notes"},"blocking_issue":{"type":"boolean","title":"Blocking Issue","default":false}},"type":"object","required":["job_id","reviewer_role","reviewer_language"],"title":"ReviewSessionRequest"},"ReviewStatusRequest":{"properties":{"review_status":{"type":"string","maxLength":40,"minLength":1,"title":"Review Status"}},"type":"object","required":["review_status"],"title":"ReviewStatusRequest"},"TextTranslateRequest":{"properties":{"text":{"type":"string","maxLength":5000,"minLength":1,"title":"Text"},"language":{"anyOf":[{"type":"string","enum":["ru","kk","en"]},{"type":"null"}],"title":"Language"}},"type":"object","required":["text"],"title":"TextTranslateRequest"},"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"}}}}