{"openapi":"3.1.0","info":{"title":"Prosopo","version":"0.1.0"},"paths":{"/api/v1/sessions/concurrency":{"get":{"tags":["sdk"],"summary":"Concurrency","operationId":"concurrency_api_v1_sessions_concurrency_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConcurrencyResponse"}}}}}}},"/api/v1/sessions":{"get":{"tags":["sdk"],"summary":"Sessions","operationId":"sessions_api_v1_sessions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActiveSessionList"}}}}}},"post":{"tags":["sdk"],"summary":"Create Session","operationId":"create_session_api_v1_sessions_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionInput"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionTokenResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/sessions/{session_id}":{"get":{"tags":["sdk"],"summary":"Session Detail","operationId":"session_detail_api_v1_sessions__session_id__get","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActiveSessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/sessions/{session_id}/stop":{"post":{"tags":["sdk"],"summary":"Stop Session","operationId":"stop_session_api_v1_sessions__session_id__stop_post","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StopResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/personas":{"get":{"tags":["sdk"],"summary":"List Personas","operationId":"list_personas_api_v1_personas_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPersonaList"}}}}}},"post":{"tags":["sdk"],"summary":"Create Persona","operationId":"create_persona_api_v1_personas_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonaInput"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/personas/{persona_id}":{"put":{"tags":["sdk"],"summary":"Update Persona","operationId":"update_persona_api_v1_personas__persona_id__put","parameters":[{"name":"persona_id","in":"path","required":true,"schema":{"type":"string","title":"Persona Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonaInput"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/personas/{key}":{"get":{"tags":["sdk"],"summary":"Persona Public","operationId":"persona_public_api_v1_personas__key__get","parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string","title":"Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPersonaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"ActiveSessionList":{"properties":{"data":{"items":{"$ref":"#/components/schemas/ActiveSessionResponse"},"type":"array","title":"Data"}},"type":"object","required":["data"],"title":"ActiveSessionList"},"ActiveSessionResponse":{"properties":{"id":{"type":"string","title":"Id"},"persona_id":{"type":"string","title":"Persona Id"},"api_key_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key Id"},"started_at":{"type":"string","title":"Started At"}},"type":"object","required":["id","persona_id","api_key_id","started_at"],"title":"ActiveSessionResponse"},"Body_clone_api_voices_clone_post":{"properties":{"clip":{"type":"string","contentMediaType":"application/octet-stream","title":"Clip"},"name":{"type":"string","maxLength":100,"minLength":1,"title":"Name"},"language":{"type":"string","pattern":"^[a-z]{2}$","title":"Language","default":"it"},"consent":{"type":"boolean","title":"Consent","default":false}},"type":"object","required":["clip","name"],"title":"Body_clone_api_voices_clone_post"},"Body_personalized_mouth_reference_api_avatar__key__mouth_reference_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_personalized_mouth_reference_api_avatar__key__mouth_reference_post"},"Body_render_file_api_render_post":{"properties":{"avatar_id":{"type":"string","title":"Avatar Id"},"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["avatar_id","file"],"title":"Body_render_file_api_render_post"},"Body_save_recording_api_recording_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_save_recording_api_recording_post"},"Body_upload_avatar_api_avatar_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_avatar_api_avatar_post"},"Body_upload_personal_motion_api_avatar__key__motion_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_personal_motion_api_avatar__key__motion_post"},"CheckoutInput":{"properties":{"request_id":{"type":"string","pattern":"^[a-f0-9-]{32,36}$","title":"Request Id"}},"additionalProperties":false,"type":"object","required":["request_id"],"title":"CheckoutInput"},"ConcurrencyResponse":{"properties":{"active_sessions":{"type":"integer","title":"Active Sessions"},"max_sessions":{"type":"integer","title":"Max Sessions"},"available":{"type":"boolean","title":"Available"}},"type":"object","required":["active_sessions","max_sessions","available"],"title":"ConcurrencyResponse"},"Credentials":{"properties":{"email":{"type":"string","maxLength":254,"minLength":3,"title":"Email"},"password":{"type":"string","maxLength":128,"minLength":12,"title":"Password"}},"additionalProperties":false,"type":"object","required":["email","password"],"title":"Credentials"},"EditRequest":{"properties":{"edit_id":{"type":"string","pattern":"^[a-f0-9]{32}$","title":"Edit Id"},"current_avatar_id":{"type":"string","pattern":"^[a-f0-9]{32}$","title":"Current Avatar Id"},"prompt":{"type":"string","maxLength":2000,"title":"Prompt","default":""},"preset":{"type":"string","pattern":"^(custom|prosopo)$","title":"Preset","default":"custom"},"outfit_template":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Outfit Template"},"background_template":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Background Template"},"optimize_posture":{"type":"boolean","title":"Optimize Posture","default":false},"optimize_lighting":{"type":"boolean","title":"Optimize Lighting","default":false},"quoted_units":{"type":"integer","exclusiveMinimum":0.0,"title":"Quoted Units"}},"type":"object","required":["edit_id","current_avatar_id","quoted_units"],"title":"EditRequest"},"EmbedConfig":{"properties":{"public_enabled":{"type":"boolean","title":"Public Enabled","default":false},"mode":{"type":"string","enum":["inline","fixed"],"title":"Mode","default":"inline"},"aspect":{"type":"string","enum":["16:9","9:16","1:1"],"title":"Aspect","default":"9:16"},"fit":{"type":"string","enum":["auto","contain","cover"],"title":"Fit","default":"auto"},"collapsed":{"type":"boolean","title":"Collapsed","default":true},"compact_style":{"type":"string","enum":["avatar","pill","mini"],"title":"Compact Style","default":"pill"},"position":{"type":"string","enum":["right","left"],"title":"Position","default":"right"},"background":{"type":"string","enum":["original","ai"],"title":"Background","default":"original"},"title":{"type":"string","maxLength":100,"title":"Title","default":"Parliamone"},"subtitle":{"type":"string","maxLength":160,"title":"Subtitle","default":"Sono qui per aiutarti"},"compact_tagline":{"type":"string","maxLength":120,"title":"Compact Tagline","default":"è qui per te"},"connected_title":{"type":"string","maxLength":100,"title":"Connected Title","default":"Ti ascolto."},"cta_talk":{"type":"string","maxLength":40,"title":"Cta Talk","default":"Parliamo"},"cta_end":{"type":"string","maxLength":40,"title":"Cta End","default":"Termina"},"chat_placeholder":{"type":"string","maxLength":120,"title":"Chat Placeholder","default":"Oppure scrivi qui…"},"wait_message":{"type":"string","maxLength":200,"title":"Wait Message","default":"La persona sarà disponibile a breve."},"unavailable_message":{"type":"string","maxLength":240,"title":"Unavailable Message","default":"La conversazione non è ancora disponibile. Puoi ascoltare un’anteprima."},"name_visible":{"type":"boolean","title":"Name Visible","default":true},"name_position":{"type":"string","enum":["left","center","right"],"title":"Name Position","default":"left"},"name_style":{"type":"string","enum":["pill","text"],"title":"Name Style","default":"pill"},"show_transcript":{"type":"boolean","title":"Show Transcript","default":true},"accent":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$","title":"Accent","default":"#ffffff"},"show_brand":{"type":"boolean","title":"Show Brand","default":true}},"additionalProperties":false,"type":"object","title":"EmbedConfig"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"KeyInput":{"properties":{"label":{"type":"string","maxLength":80,"minLength":1,"title":"Label"},"origins":{"items":{"type":"string"},"type":"array","maxItems":20,"title":"Origins"}},"additionalProperties":false,"type":"object","required":["label"],"title":"KeyInput"},"KnowledgeConfig":{"properties":{"enabled":{"type":"boolean","title":"Enabled","default":false},"collection_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0.0},{"type":"null"}],"title":"Collection Id"},"collection_name":{"type":"string","maxLength":200,"title":"Collection Name","default":""},"instructions":{"type":"string","maxLength":2000,"title":"Instructions","default":"Rispondi usando le fonti disponibili; se non trovi informazioni, dichiaralo."}},"additionalProperties":false,"type":"object","title":"KnowledgeConfig"},"OriginsInput":{"properties":{"origins":{"items":{"type":"string"},"type":"array","maxItems":20,"title":"Origins"}},"additionalProperties":false,"type":"object","title":"OriginsInput"},"PersonaInput":{"properties":{"name":{"type":"string","maxLength":100,"minLength":1,"title":"Name","default":"Nuova persona"},"avatar_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Id"},"description":{"type":"string","maxLength":500,"title":"Description","default":""},"system_prompt":{"type":"string","maxLength":12000,"title":"System Prompt","default":"Sei un assistente italiano cordiale, chiaro e affidabile. Rispondi in modo naturale e conciso. Non fingere di essere umano."},"greeting":{"type":"string","maxLength":1000,"title":"Greeting","default":""},"voice":{"type":"string","maxLength":100,"minLength":1,"title":"Voice","default":"a0e99841-438c-4a64-b679-ae501e7d6091"},"model":{"type":"string","maxLength":100,"title":"Model","default":"gpt-6-luna"},"interruptible":{"type":"boolean","title":"Interruptible","default":true},"expressivity":{"type":"number","maximum":1.6,"minimum":0.0,"title":"Expressivity","default":1},"idle_enabled":{"type":"boolean","title":"Idle Enabled","default":true},"head_motion":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Head Motion","default":0.7},"body_motion":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Body Motion","default":0.6},"mouth_mode":{"type":"string","enum":["neural","3d"],"title":"Mouth Mode","default":"neural"},"language":{"type":"string","maxLength":20,"title":"Language","default":"it"},"director_notes":{"type":"string","maxLength":2000,"title":"Director Notes","default":""},"knowledge":{"$ref":"#/components/schemas/KnowledgeConfig"},"tools":{"items":{"$ref":"#/components/schemas/ToolConfig"},"type":"array","maxItems":12,"title":"Tools"},"embed":{"$ref":"#/components/schemas/EmbedConfig"}},"additionalProperties":false,"type":"object","title":"PersonaInput"},"PortraitUpdate":{"properties":{"avatar_id":{"type":"string","pattern":"^[a-f0-9]{32}$","title":"Avatar Id"}},"additionalProperties":false,"type":"object","required":["avatar_id"],"title":"PortraitUpdate"},"PublicPersonaList":{"properties":{"data":{"items":{"$ref":"#/components/schemas/PublicPersonaResponse"},"type":"array","title":"Data"}},"type":"object","required":["data"],"title":"PublicPersonaList"},"PublicPersonaResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"avatar_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Id"},"voice":{"type":"string","title":"Voice"},"model":{"type":"string","title":"Model"},"head_motion":{"type":"number","title":"Head Motion"},"idle_enabled":{"type":"boolean","title":"Idle Enabled"},"body_motion":{"type":"number","title":"Body Motion"},"expressivity":{"type":"number","title":"Expressivity"},"mouth_mode":{"type":"string","title":"Mouth Mode"},"embed":{"additionalProperties":true,"type":"object","title":"Embed"}},"type":"object","required":["id","name","avatar_id","voice","model","head_motion","idle_enabled","body_motion","expressivity","mouth_mode","embed"],"title":"PublicPersonaResponse"},"Registration":{"properties":{"email":{"type":"string","maxLength":254,"minLength":3,"title":"Email"},"password":{"type":"string","maxLength":128,"minLength":12,"title":"Password"},"name":{"type":"string","maxLength":100,"minLength":1,"title":"Name"}},"additionalProperties":false,"type":"object","required":["email","password","name"],"title":"Registration"},"ResetPassword":{"properties":{"token":{"type":"string","maxLength":200,"minLength":20,"title":"Token"},"password":{"type":"string","maxLength":128,"minLength":12,"title":"Password"}},"type":"object","required":["token","password"],"title":"ResetPassword"},"ResetRequest":{"properties":{"email":{"type":"string","maxLength":254,"minLength":3,"title":"Email"}},"type":"object","required":["email"],"title":"ResetRequest"},"SessionInput":{"properties":{"persona_id":{"type":"string","pattern":"^[a-f0-9]{32}$","title":"Persona Id"},"origin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Origin"},"end_user":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"End User"}},"additionalProperties":false,"type":"object","required":["persona_id"],"title":"SessionInput"},"SessionTokenResponse":{"properties":{"session_token":{"type":"string","title":"Session Token"},"media_token":{"type":"string","title":"Media Token"},"expires_at":{"type":"integer","title":"Expires At"},"persona_id":{"type":"string","title":"Persona Id"},"persona":{"$ref":"#/components/schemas/PublicPersonaResponse"},"websocket_url":{"type":"string","title":"Websocket Url"}},"type":"object","required":["session_token","media_token","expires_at","persona_id","persona","websocket_url"],"title":"SessionTokenResponse"},"StopResponse":{"properties":{"id":{"type":"string","title":"Id"},"status":{"type":"string","title":"Status"}},"type":"object","required":["id","status"],"title":"StopResponse"},"ToolConfig":{"properties":{"name":{"type":"string","pattern":"^[a-z][a-z0-9_]{1,47}$","title":"Name"},"description":{"type":"string","maxLength":600,"minLength":1,"title":"Description"},"kind":{"type":"string","enum":["link","event"],"title":"Kind","default":"link"},"url":{"type":"string","maxLength":2000,"pattern":"^(https://[^\\s]+)?$","title":"Url","default":""},"label":{"type":"string","maxLength":80,"title":"Label","default":"Apri"},"enabled":{"type":"boolean","title":"Enabled","default":true}},"additionalProperties":false,"type":"object","required":["name","description"],"title":"ToolConfig"},"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"}}}}