{"openapi":"3.1.0","info":{"title":"FalaAI API","version":"1.21.50"},"paths":{"/v1/audio/transcriptions":{"post":{"tags":["speech"],"summary":"Transcribe audio to text","operationId":"create_transcription_v1_audio_transcriptions_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_create_transcription_v1_audio_transcriptions_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranscriptionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/analyze/diagnostic":{"post":{"tags":["analysis"],"summary":"Analyze a call transcript — 5 parallel analyses","operationId":"create_diagnostic_v1_analyze_diagnostic_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DiagnosticRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DiagnosticResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/analyze/riskAudit":{"post":{"tags":["analysis"],"summary":"Compliance Risk Audit — conversation compliance analysis","operationId":"create_risk_audit_v1_analyze_riskAudit_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RiskAuditRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RiskAuditV2Response"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/usage/log":{"get":{"tags":["usage"],"summary":"Get Usage Log","operationId":"get_usage_log_v1_usage_log_get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"api_key_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageLogResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/usage/by-key":{"get":{"tags":["usage"],"summary":"Get Usage By Key","operationId":"get_usage_by_key_v1_usage_by_key_get","parameters":[{"name":"key_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UsageByKeyItem"},"title":"Response Get Usage By Key V1 Usage By Key Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/webhooks":{"get":{"tags":["webhooks"],"summary":"List webhooks","description":"Lists the authenticated user's webhooks (10 alerts). Paginated. Includes the URL signature secret (always visible to the owner).","operationId":"list_webhooks_v1_webhooks_get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Pagina (1-indexed)","default":1,"title":"Page"},"description":"Pagina (1-indexed)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Itens por pagina (max 100)","default":20,"title":"Limit"},"description":"Itens por pagina (max 100)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["webhooks"],"summary":"Create webhook","description":"Creates a subscription for alert events (10 alerts). Payload delivered: WebhookPayload(event, data, timestamp) with HMAC FalaAI-Signature. To verify the origin, recompute HMAC-SHA256 of \"timestamp.body\" with your secret.","operationId":"create_webhook_v1_webhooks_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWebhookRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookItem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/webhooks/{webhook_id}":{"put":{"tags":["webhooks"],"summary":"Update webhook","description":"Updates the webhook's name/url/events/retry_enabled/active. Valid events: 10 alerts.","operationId":"update_webhook_v1_webhooks__webhook_id__put","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","title":"Webhook Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateWebhookRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["webhooks"],"summary":"Delete webhook","description":"Deletes a webhook subscription by ID.","operationId":"delete_webhook_v1_webhooks__webhook_id__delete","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","title":"Webhook Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/email-alerts":{"get":{"tags":["email-alerts"],"summary":"List email alerts","operationId":"list_email_alerts_v1_email_alerts_get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailAlertListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["email-alerts"],"summary":"Create email alert","operationId":"create_email_alert_v1_email_alerts_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateEmailAlertRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailAlertItem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/email-alerts/{alert_id}":{"put":{"tags":["email-alerts"],"summary":"Update email alert","operationId":"update_email_alert_v1_email_alerts__alert_id__put","parameters":[{"name":"alert_id","in":"path","required":true,"schema":{"type":"string","title":"Alert Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateEmailAlertRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailAlertMessageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["email-alerts"],"summary":"Delete email alert","operationId":"delete_email_alert_v1_email_alerts__alert_id__delete","parameters":[{"name":"alert_id","in":"path","required":true,"schema":{"type":"string","title":"Alert Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailAlertMessageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/version":{"get":{"tags":["version"],"summary":"Get Version","operationId":"get_version_api_version_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VersionResponse"}}}}},"security":[]}},"/v1/health":{"get":{"tags":["health"],"summary":"Health Check","operationId":"health_check","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}},"security":[]},"head":{"tags":["health"],"summary":"Health Check","operationId":"health_check_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}},"security":[]}}},"components":{"schemas":{"AudioEvent":{"properties":{"event":{"type":"string","title":"Event","description":"Type of identified audio event. Ex: [riso], [suspiro], [pausa], [tosse]"},"start_s":{"type":"number","title":"Start S","description":"Start time of audio event in seconds"},"end_s":{"type":"number","title":"End S","description":"End time of audio event in seconds"},"duration_s":{"type":"number","title":"Duration S","description":"Event duration in seconds"},"formatted_timestamp":{"type":"string","title":"Formatted Timestamp","description":"Formatted timestamp HH:MM:SS.mmm of event start"}},"type":"object","required":["event","start_s","end_s","duration_s","formatted_timestamp"],"title":"AudioEvent"},"AudioInputMeta":{"properties":{"duration_s":{"type":"number","title":"Duration S","description":"Exact audio duration sent in seconds"},"original_format":{"type":"string","title":"Original Format","description":"Original file format (wav, mp3, ogg, etc)"},"codec":{"type":"string","title":"Codec","description":"Audio codec sent"},"sample_rate":{"type":"integer","title":"Sample Rate","description":"Audio sample rate in Hz"},"channels":{"type":"integer","title":"Channels","description":"Number of channels (1=mono, 2=stereo)"}},"type":"object","required":["duration_s","original_format","codec","sample_rate","channels"],"title":"AudioInputMeta"},"Body_create_transcription_v1_audio_transcriptions_post":{"properties":{"file":{"type":"string","title":"File","format":"binary"},"model":{"type":"string","title":"Model","default":"falaai-transcribe-1"},"language":{"type":"string","title":"Language","default":"pt"},"client_reference_id":{"type":"string","title":"Client Reference Id","description":"Optional client-supplied ID echoed verbatim in the response. Use to correlate/sync with your system. Accepted charset: [A-Za-z0-9._:-]. Not idempotency."}},"type":"object","required":["file"],"title":"Body_create_transcription_v1_audio_transcriptions_post"},"CreateEmailAlertRequest":{"properties":{"name":{"type":"string","title":"Name","description":"Nome identificador"},"email":{"type":"string","title":"Email","description":"Email destino"},"events":{"items":{"$ref":"#/components/schemas/EmailEvent"},"type":"array","title":"Events","description":"Eventos subscritos"}},"type":"object","required":["name","email","events"],"title":"CreateEmailAlertRequest"},"CreateWebhookRequest":{"properties":{"name":{"type":"string","title":"Name","description":"Nome identificador do webhook"},"url":{"type":"string","title":"Url","description":"URL HTTPS que recebera POST com HMAC FalaAI-Signature"},"events":{"items":{"$ref":"#/components/schemas/WebhookEvent"},"type":"array","title":"Events","description":"Eventos subscritos (10 alertas)"},"retry_enabled":{"type":"boolean","title":"Retry Enabled","description":"Retry exponencial 5 tentativas quando true (false=1 tentativa)","default":false}},"type":"object","required":["name","url","events"],"title":"CreateWebhookRequest"},"DiagnosticAnalysisMap":{"properties":{"dialogue_summary":{"$ref":"#/components/schemas/DiagnosticTextAnalysis","description":"Detailed conversation summary"},"contact_reason":{"$ref":"#/components/schemas/DiagnosticTextAnalysis","description":"Initial contact reason"},"identified_action":{"$ref":"#/components/schemas/DiagnosticCategoricalAnalysis","description":"Action taken / resolution"},"identified_label":{"$ref":"#/components/schemas/DiagnosticCategoricalAnalysis","description":"Theme classification"},"sentiment":{"$ref":"#/components/schemas/DiagnosticCategoricalAnalysis","description":"Predominant sentiment"},"participants_identified":{"items":{"$ref":"#/components/schemas/ParticipantDiagnostic"},"type":"array","title":"Participants Identified","description":"Identified participants and roles (same field names as auditoria)","default":[]}},"type":"object","required":["dialogue_summary","contact_reason","identified_action","identified_label","sentiment"],"title":"DiagnosticAnalysisMap"},"DiagnosticAudioEvent":{"properties":{"event":{"type":"string","title":"Event","description":"Audio event type. E.g.: [laughter], [sigh]"},"start_s":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Start S","description":"Start time in seconds"},"end_s":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"End S","description":"End time in seconds"},"duration_s":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Duration S","description":"Duration in seconds"},"formatted_timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Formatted Timestamp","description":"Formatted timestamp (HH:MM:SS.ms)"}},"type":"object","required":["event"],"title":"DiagnosticAudioEvent"},"DiagnosticCategoricalAnalysis":{"properties":{"list_choice":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"List Choice","description":"Selected value from classification list (used in action, label, sentiment)"},"justification":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Justification","description":"Justification for the choice"},"evidence_phrases":{"items":{"type":"string"},"type":"array","title":"Evidence Phrases","description":"Verbatim transcript excerpts supporting the analysis","default":[]}},"type":"object","title":"DiagnosticCategoricalAnalysis"},"DiagnosticParticipant":{"properties":{"interlocutor":{"type":"string","title":"Interlocutor","description":"Exact speaker label from the dialog (e.g. 'Speaker 1')"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Participant name (optional)"},"role":{"type":"string","enum":["agent","client","bot"],"title":"Role","description":"agent | client | bot"}},"additionalProperties":false,"type":"object","required":["interlocutor","role"],"title":"DiagnosticParticipant"},"DiagnosticRequest":{"properties":{"model":{"type":"string","title":"Model","description":"Analysis model. Always 'falaai-diagnostic-1'","default":"falaai-diagnostic-1"},"text":{"type":"string","maxLength":300000,"title":"Text","description":"Plain transcript (fallback if dialog is empty). At least one of 'dialog' or 'text' required. Max 300,000 characters","default":""},"dialog":{"type":"string","maxLength":300000,"title":"Dialog","description":"Diarized transcript with speaker turns. PRIMARY source. At least one of 'dialog' or 'text' required. Speaker labels accepted (any case): 'Speaker N', 'Interlocutor N', 'Hablante N', 'Locutor N', 'Orador N' (space or underscore). Normalized internally to 'Speaker N' in the response. Max 300,000 characters","default":""},"audio_events":{"items":{"$ref":"#/components/schemas/DiagnosticAudioEvent"},"type":"array","maxItems":500,"title":"Audio Events","description":"Detected audio events with timestamps (required when using dialog)","default":[]},"language":{"type":"string","title":"Language","description":"Transcript language. Required. Accepted: en-US, pt-BR, es-ES, es-MX, fr-FR, de-DE, it-IT, pt-PT, zh-CN, ja-JP, ko-KR, ar-SA, hi-IN, ru-RU, id-ID, tr-TR, nl-NL, pl-PL, vi-VN, th-TH, en-GB"},"response_language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Response Language","description":"Language for the analysis results (labels, categories, levels). Can differ from 'language' (input). If omitted, uses 'language'. Accepted: en-US, es-ES, es-MX, pt-BR, fr-FR, de-DE, it-IT, pt-PT, zh-CN, ja-JP, ko-KR, ar-SA, hi-IN, ru-RU, id-ID, tr-TR, nl-NL, pl-PL, vi-VN, th-TH, en-GB."},"duration_seconds":{"type":"number","minimum":1.0,"title":"Duration Seconds","description":"Total audio duration in seconds. Required. Max 3h (10800s)."},"client_reference_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Reference Id","description":"Optional client-supplied ID echoed verbatim in the response. Use to correlate/sync with your system. Accepted charset: [A-Za-z0-9._:-], max 128 chars. Not idempotency."},"call_direction":{"anyOf":[{"type":"string","enum":["inbound","outbound"]},{"type":"null"}],"title":"Call Direction","description":"Who originated the call. inbound=client called, outbound=company called. If omitted, the LLM infers from context."},"participants":{"anyOf":[{"items":{"$ref":"#/components/schemas/DiagnosticParticipant"},"type":"array","maxItems":10},{"type":"null"}],"title":"Participants","description":"Explicit participant roles. If omitted, the LLM infers from the dialog. When provided, used as ground truth (no inference) and echoed in analysis.participants_identified."}},"additionalProperties":false,"type":"object","required":["language","duration_seconds"],"title":"DiagnosticRequest"},"DiagnosticResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Unique analysis identifier. Prefix 'di-' + UUID"},"response_language":{"type":"string","title":"Response Language","description":"Language used in the response. E.g.: 'pt-BR', 'en-US', 'es-ES'"},"object":{"type":"string","title":"Object","description":"Object type. Always 'analysis'"},"analysis":{"$ref":"#/components/schemas/DiagnosticAnalysisMap","description":"The 6 conversation analyses (5 + participants)"},"usage":{"$ref":"#/components/schemas/DiagnosticUsage","description":"Usage and processing information"},"client_reference_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Reference Id","description":"Client-supplied ID echoed verbatim (if provided in request)"}},"type":"object","required":["id","response_language","object","analysis","usage"],"title":"DiagnosticResponse"},"DiagnosticTextAnalysis":{"properties":{"explanation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Explanation","description":"Explanatory text (used in summary and reason)"}},"type":"object","title":"DiagnosticTextAnalysis"},"DiagnosticUsage":{"properties":{"characters":{"type":"integer","title":"Characters","description":"Total characters analyzed"},"credits_consumed":{"type":"integer","title":"Credits Consumed","description":"Credits consumed: max(ceil(chars/500)*3, 3) * 5"},"processing_ms":{"type":"integer","title":"Processing Ms","description":"Total processing time in milliseconds"}},"type":"object","required":["characters","credits_consumed","processing_ms"],"title":"DiagnosticUsage"},"EmailAlertItem":{"properties":{"id":{"type":"string","title":"Id","description":"Email alert id"},"user_id":{"type":"string","title":"User Id","description":"Owner user id"},"name":{"type":"string","title":"Name","description":"Email alert name"},"email":{"type":"string","title":"Email","description":"Destination email"},"events":{"items":{"type":"string"},"type":"array","title":"Events","description":"Subscribed events"},"active":{"type":"boolean","title":"Active","description":"Is active"},"created_at":{"type":"string","title":"Created At","description":"ISO 8601 created"},"updated_at":{"type":"string","title":"Updated At","description":"ISO 8601 updated"}},"type":"object","required":["id","user_id","name","email","events","active","created_at","updated_at"],"title":"EmailAlertItem"},"EmailAlertListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/EmailAlertItem"},"type":"array","title":"Data"},"page":{"type":"integer","title":"Page"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["data","page","limit"],"title":"EmailAlertListResponse"},"EmailAlertMessageResponse":{"properties":{"message":{"type":"string","title":"Message","description":"Operation result message"}},"type":"object","required":["message"],"title":"EmailAlertMessageResponse"},"EmailEvent":{"type":"string","enum":["subscription.created","avulso.completed","subscription.upgraded","subscription.downgraded","subscription.canceled","credits.low","credits.exhausted","subscription.renewed","payment.failed"],"title":"EmailEvent"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Overall API status"},"version":{"type":"string","title":"Version","description":"Current API version"},"uptime_seconds":{"type":"integer","title":"Uptime Seconds","description":"Uptime in seconds"},"database":{"type":"boolean","title":"Database","description":"Database connection status"},"phase":{"type":"string","title":"Phase","description":"Development phase"},"launch_date":{"type":"string","title":"Launch Date","description":"Expected public launch date"}},"type":"object","required":["status","version","uptime_seconds","database","phase","launch_date"],"title":"HealthResponse"},"MessageResponse":{"properties":{"message":{"type":"string","title":"Message","description":"Operation result message"}},"type":"object","required":["message"],"title":"MessageResponse"},"Participant":{"properties":{"interlocutor":{"type":"string","title":"Interlocutor","description":"Exact identifier as used in dialog (e.g. 'Interlocutor 1', 'Antonio')"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Participant name (humanizes report, does not affect logic)"},"role":{"type":"string","enum":["agent","client","bot"],"title":"Role","description":"Role: agent (human operator), client (customer), bot (IVR/AI)"}},"type":"object","required":["interlocutor","role"],"title":"Participant"},"ParticipantDiagnostic":{"properties":{"interlocutor":{"type":"string","title":"Interlocutor","description":"Exact speaker label from the dialog (e.g. 'Speaker 1')"},"role":{"type":"string","title":"Role","description":"Role: agent | client | bot | agent_requester | agent_custodian"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Participant name if mentioned in the dialogue"},"confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confidence","description":"high | medium | low"},"evidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence","description":"Exact verbatim quote supporting the role (no timestamps)"}},"type":"object","required":["interlocutor","role"],"title":"ParticipantDiagnostic"},"RiskAuditAnalysisV2":{"properties":{"global_metrics":{"additionalProperties":true,"type":"object","title":"Global Metrics","description":"Global metrics","default":{}},"final_analysis":{"additionalProperties":true,"type":"object","title":"Final Analysis","description":"Final analysis","default":{}},"frameworks":{"additionalProperties":true,"type":"object","title":"Frameworks","description":"Frameworks (COPC/ISO/Kirkpatrick/CES)","default":{}}},"additionalProperties":false,"type":"object","title":"RiskAuditAnalysisV2"},"RiskAuditAppliedActionV2":{"properties":{"action_type":{"type":"string","title":"Action Type","description":"Action type code"},"label":{"type":"string","title":"Label","description":"Action label"},"description":{"type":"string","title":"Description","description":"Action description"},"priority":{"type":"string","title":"Priority","description":"CRITICO/ALTO/MEDIO/BAIXO"},"color":{"type":"string","title":"Color","description":"Color","default":""},"icon":{"type":"string","title":"Icon","description":"Icon","default":""},"condition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Condition","description":"Condition"},"reason":{"type":"string","title":"Reason","description":"Reason","default":""}},"additionalProperties":false,"type":"object","required":["action_type","label","description","priority"],"title":"RiskAuditAppliedActionV2"},"RiskAuditAudioEventModelV2":{"properties":{"model":{"type":"string","title":"Model","description":"MAC model text (i18n)","default":""},"description":{"type":"string","title":"Description","description":"MAC description (i18n)","default":""},"windows_s":{"additionalProperties":true,"type":"object","title":"Windows S","description":"Temporal windows (s)","default":{}}},"additionalProperties":false,"type":"object","title":"RiskAuditAudioEventModelV2"},"RiskAuditAuditDecisionsV2":{"properties":{"risk_origin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Risk Origin","description":"Risk origin"},"has_zero_tolerance_violation":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has Zero Tolerance Violation","description":"Has zero-tolerance violation"},"deterministic_validator_changes":{"items":{},"type":"array","title":"Deterministic Validator Changes","description":"Deterministic validator changes","default":[]}},"additionalProperties":false,"type":"object","title":"RiskAuditAuditDecisionsV2"},"RiskAuditConversationScoresV2":{"properties":{"consolidated_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Consolidated Score","description":"Consolidated score"},"violation_density_per_min":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Violation Density Per Min","description":"Violation density/min"},"sentiment_trend":{"anyOf":[{},{"type":"null"}],"title":"Sentiment Trend","description":"Sentiment trend"},"pct_turns_with_violation":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Turns With Violation","description":"% turns with violation"},"most_critical_turn":{"anyOf":[{},{"type":"null"}],"title":"Most Critical Turn","description":"Most critical turn"},"positive_negative_ratio":{"anyOf":[{},{"type":"null"}],"title":"Positive Negative Ratio","description":"Positive:negative ratio"},"global_risk_severity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Global Risk Severity","description":"Global risk severity code"},"global_risk_severity_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Global Risk Severity Label","description":"Global risk severity label"},"global_risk_severity_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Global Risk Severity Color","description":"Global risk severity color"},"risk_likelihood_avg":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Risk Likelihood Avg","description":"Risk likelihood avg"},"risk_impact_avg":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Risk Impact Avg","description":"Risk impact avg"}},"additionalProperties":false,"type":"object","title":"RiskAuditConversationScoresV2"},"RiskAuditDetectionItemV2":{"properties":{"turn":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Turn","description":"Turn number"},"interlocutor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Interlocutor","description":"Speaker"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role","description":"Role"},"timestamp_start_s":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Timestamp Start S","description":"Start (s)"},"timestamp_end_s":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Timestamp End S","description":"End (s)"},"timestamp_formatted":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp Formatted","description":"Formatted timestamp"},"term_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Term Text","description":"Detected term"},"suggested_term_for_bank":{"anyOf":[{},{"type":"null"}],"title":"Suggested Term For Bank","description":"Suggested term for bank"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category","description":"Category code"},"category_label":{"type":"string","title":"Category Label","description":"Category label (i18n)"},"category_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category Color","description":"Category color"},"category_icon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category Icon","description":"Category icon"},"criticality":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Criticality","description":"Criticality"},"category_threshold":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Category Threshold","description":"Category threshold"},"category_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category Type","description":"Category type"},"category_group":{"type":"string","title":"Category Group","description":"Category group label (i18n)"},"nature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nature","description":"Nature"},"llm_confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Llm Confidence","description":"LLM confidence"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason","description":"Reason"},"is_valid_context":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Valid Context","description":"Valid context"},"risk_probability":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Risk Probability","description":"Risk probability"},"risk_impact":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Risk Impact","description":"Risk impact"},"category_weight":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Category Weight","description":"Category weight"},"turn_sentiment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Turn Sentiment","description":"Turn sentiment"},"intensity":{"anyOf":[{},{"type":"null"}],"title":"Intensity","description":"Intensity"},"mod_applied":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Mod Applied","description":"Total modifier applied"},"mac_applied":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Mac Applied","description":"Audio modifier applied"},"mvad_applied":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Mvad Applied","description":"Intensity modifier applied"},"mod_formula":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mod Formula","description":"Modifier formula"},"mac_details":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Mac Details","description":"MAC details","default":[]},"calibration_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Calibration Reason","description":"Calibration reason"},"final_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Final Score","description":"Final score"},"final_score_formula":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Final Score Formula","description":"Final score formula"},"conversation_limit":{"anyOf":[{},{"type":"null"}],"title":"Conversation Limit","description":"Conversation limit"},"apply_saturation":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Apply Saturation","description":"Apply saturation"},"block_repetition":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Block Repetition","description":"Block repetition"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"Status"},"effective_impact":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Effective Impact","description":"Effective impact"},"saturation_factor":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Saturation Factor","description":"Saturation factor"},"saturation_formula":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Saturation Formula","description":"Saturation formula"},"threshold_formula":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Threshold Formula","description":"Threshold formula"},"blocked_formula":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Blocked Formula","description":"Blocked formula"},"reconciliation_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reconciliation Note","description":"Reconciliation note"},"violated_frameworks":{"items":{},"type":"array","title":"Violated Frameworks","description":"Violated frameworks","default":[]},"citation_fidelity":{"type":"boolean","title":"Citation Fidelity","description":"Citation fidelity","default":true},"subcategory":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subcategory","description":"Subcategory code"},"subcategory_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subcategory Label","description":"Subcategory label (i18n)"}},"additionalProperties":false,"type":"object","required":["category_label","category_group"],"title":"RiskAuditDetectionItemV2"},"RiskAuditDetectionsV2":{"properties":{"violations":{"items":{"$ref":"#/components/schemas/RiskAuditDetectionItemV2"},"type":"array","title":"Violations","description":"Active violations","default":[]},"positives":{"items":{"$ref":"#/components/schemas/RiskAuditDetectionItemV2"},"type":"array","title":"Positives","description":"Active positives","default":[]},"client_risk_alerts":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Client Risk Alerts","description":"Client risk alerts","default":[]},"client_behavior_alerts":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Client Behavior Alerts","description":"Client behavior alerts","default":[]},"client_negatives":{"items":{"$ref":"#/components/schemas/RiskAuditDetectionItemV2"},"type":"array","title":"Client Negatives","description":"Client negatives","default":[]}},"additionalProperties":false,"type":"object","title":"RiskAuditDetectionsV2"},"RiskAuditIndexerV2":{"properties":{"suggested_terms_for_bank":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Suggested Terms For Bank","description":"Suggested terms for bank","default":[]}},"additionalProperties":false,"type":"object","title":"RiskAuditIndexerV2"},"RiskAuditMetaV2":{"properties":{"id":{"type":"string","title":"Id","description":"Analysis id"},"object":{"type":"string","title":"Object","description":"Object type","default":"risk_audit"},"call_duration_s":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Call Duration S","description":"Call duration (s)"},"analyzed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Analyzed At","description":"ISO 8601 analyzed timestamp"},"usage":{"$ref":"#/components/schemas/RiskAuditUsageV2","description":"Usage block"},"client_reference_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Reference Id","description":"Echoed client reference id"}},"additionalProperties":false,"type":"object","required":["id","usage"],"title":"RiskAuditMetaV2"},"RiskAuditParticipantV2":{"properties":{"interlocutor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Interlocutor","description":"Speaker label"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Participant name"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role","description":"Role (agent/client/bot/unknown)"},"confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confidence","description":"Role inference confidence (high/medium/low)"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","description":"Role source (input/inferred)"},"evidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence","description":"Role inference evidence"}},"additionalProperties":false,"type":"object","title":"RiskAuditParticipantV2"},"RiskAuditParticipantsV2":{"properties":{"identified":{"items":{"$ref":"#/components/schemas/RiskAuditParticipantV2"},"type":"array","title":"Identified","description":"Identified participants","default":[]},"call_direction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Call Direction","description":"inbound/outbound"},"role_inference_reliable":{"type":"boolean","title":"Role Inference Reliable","description":"Role inference reliability","default":true},"identification_status":{"type":"string","title":"Identification Status","description":"Identification status","default":"none"},"unidentified_items_count":{"type":"integer","title":"Unidentified Items Count","description":"Unidentified items count","default":0}},"additionalProperties":false,"type":"object","title":"RiskAuditParticipantsV2"},"RiskAuditRequest":{"properties":{"model":{"type":"string","title":"Model","description":"Analysis model. Always 'falaai-risk-audit-1'","default":"falaai-risk-audit-1"},"text":{"type":"string","maxLength":300000,"title":"Text","description":"Plain transcript (fallback if dialog is empty). At least one of 'dialog' or 'text' required. Max 300,000 characters","default":""},"dialog":{"type":"string","maxLength":300000,"title":"Dialog","description":"Diarized transcript with speaker turns. PRIMARY source. Speaker labels accepted (any case): 'Speaker N', 'Interlocutor N', 'Hablante N', 'Locutor N', 'Orador N' (space or underscore). Normalized internally to 'Speaker N' in the response. Max 300,000 characters","default":""},"audio_events":{"items":{"$ref":"#/components/schemas/DiagnosticAudioEvent"},"type":"array","maxItems":500,"title":"Audio Events","description":"Audio events with timestamps (correlated with turns when diarization is present)","default":[]},"duration_seconds":{"type":"number","minimum":1.0,"title":"Duration Seconds","description":"Total audio duration in seconds. Required. Max 3h (10800s)."},"language":{"type":"string","title":"Language","description":"Language of the transcript being analyzed. Must match the dialog/text language. Accepted: pt-BR, en-US, es-ES."},"response_language":{"type":"string","title":"Response Language","description":"Language for analysis results (labels, categories, levels, actions, HTML report). Can differ from 'language'. Accepted: pt-BR, en-US, es-ES."},"call_direction":{"anyOf":[{"type":"string","enum":["inbound","outbound"]},{"type":"null"}],"title":"Call Direction","description":"Who originated the call. inbound=client called, outbound=company called. If omitted, LLM infers from context."},"participants":{"anyOf":[{"items":{"$ref":"#/components/schemas/Participant"},"type":"array","maxItems":10},{"type":"null"}],"title":"Participants","description":"Explicit participant roles. If omitted, LLM infers from dialog (Lei 17). When provided, used as ground truth — no inference."},"response_format":{"type":"string","enum":["v2"],"title":"Response Format","description":"Response format version. Only 'v2' (structured EN-US blocks) is available today.","default":"v2"},"client_reference_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Reference Id","description":"Optional client-supplied ID echoed verbatim in the response. Use to correlate/sync with your system. Accepted charset: [A-Za-z0-9._:-], max 128 chars. Not idempotency."}},"additionalProperties":false,"type":"object","required":["duration_seconds","language","response_language"],"title":"RiskAuditRequest"},"RiskAuditScoresV2":{"properties":{"conversation":{"$ref":"#/components/schemas/RiskAuditConversationScoresV2","description":"Conversation scores"},"per_participant":{"additionalProperties":true,"type":"object","title":"Per Participant","description":"Per-participant KPIs","default":{}}},"additionalProperties":false,"type":"object","required":["conversation"],"title":"RiskAuditScoresV2"},"RiskAuditScoringExplanationV2":{"properties":{"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary","description":"Explanation summary"},"steps":{"items":{},"type":"array","title":"Steps","description":"Explanation steps","default":[]}},"additionalProperties":false,"type":"object","title":"RiskAuditScoringExplanationV2"},"RiskAuditSummaryV2":{"properties":{"total_turns":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Turns","description":"Total turns"},"total_calibrated":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Calibrated","description":"Total calibrated detections"},"active":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Active","description":"Active detections"},"tolerated":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tolerated","description":"Tolerated detections"},"blocked":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Blocked","description":"Blocked detections"},"audio_events_used":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Audio Events Used","description":"Audio events used"},"audio_events_aggravated":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Audio Events Aggravated","description":"Audio events aggravated"},"mac_audio_applied":{"anyOf":[{},{"type":"null"}],"title":"Mac Audio Applied","description":"MAC audio applied"},"mvad_applied":{"anyOf":[{},{"type":"null"}],"title":"Mvad Applied","description":"MVAD applied"},"total_participants":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Participants","description":"Total participants"},"total_agents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Agents","description":"Total agents"},"total_clients":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Clients","description":"Total clients"},"total_bots":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Bots","description":"Total bots"},"total_unknown":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Unknown","description":"Total unknown"},"client_risk_alerts_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Client Risk Alerts Count","description":"Client risk alerts count"},"client_behavior_alerts_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Client Behavior Alerts Count","description":"Client behavior alerts count"}},"additionalProperties":false,"type":"object","title":"RiskAuditSummaryV2"},"RiskAuditTimelineV2":{"properties":{"turns_sentiment":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Turns Sentiment","description":"Per-turn sentiment","default":[]},"audio_events":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Audio Events","description":"Audio events (i18n)","default":[]},"audio_groups_found":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Audio Groups Found","description":"Audio groups found","default":[]}},"additionalProperties":false,"type":"object","title":"RiskAuditTimelineV2"},"RiskAuditUsageV2":{"properties":{"characters":{"type":"integer","title":"Characters","description":"Characters analyzed"},"credits_consumed":{"type":"integer","title":"Credits Consumed","description":"Credits consumed"},"processing_ms":{"type":"integer","title":"Processing Ms","description":"Processing time (ms)"}},"type":"object","required":["characters","credits_consumed","processing_ms"],"title":"RiskAuditUsageV2"},"RiskAuditV2":{"properties":{"meta":{"$ref":"#/components/schemas/RiskAuditMetaV2","description":"Identification + usage"},"participants":{"$ref":"#/components/schemas/RiskAuditParticipantsV2","description":"Participants/roles/direction"},"verdict":{"$ref":"#/components/schemas/RiskAuditVerdictV2","description":"Verdict + level + applied actions"},"scores":{"$ref":"#/components/schemas/RiskAuditScoresV2","description":"Consolidated + per-participant scores"},"detections":{"$ref":"#/components/schemas/RiskAuditDetectionsV2","description":"violations/positives/client alerts"},"analysis":{"$ref":"#/components/schemas/RiskAuditAnalysisV2","description":"global_metrics + final_analysis + frameworks"},"timeline":{"$ref":"#/components/schemas/RiskAuditTimelineV2","description":"turns_sentiment + audio_events + groups"},"audio_event_model":{"$ref":"#/components/schemas/RiskAuditAudioEventModelV2","description":"MAC audio event semantics"},"categories_summary":{"additionalProperties":true,"type":"object","title":"Categories Summary","description":"Per-category summary (keyed by category)"},"indexer":{"$ref":"#/components/schemas/RiskAuditIndexerV2","description":"Suggested terms for bank"},"summary":{"$ref":"#/components/schemas/RiskAuditSummaryV2","description":"Executive summary counts"},"actions_i18n":{"additionalProperties":true,"type":"object","title":"Actions I18N","description":"Used actions i18n catalog (keyed by action)"},"audit_decisions":{"$ref":"#/components/schemas/RiskAuditAuditDecisionsV2","description":"Risk origin + validator changes"},"scoring_explanation":{"$ref":"#/components/schemas/RiskAuditScoringExplanationV2","description":"Score composition explanation"},"html_report":{"type":"string","title":"Html Report","description":"HTML report (base64 gzip)"}},"additionalProperties":false,"type":"object","required":["meta","participants","verdict","scores","detections","analysis","timeline","audio_event_model","categories_summary","indexer","summary","actions_i18n","audit_decisions","scoring_explanation","html_report"],"title":"RiskAuditV2","description":"Response V2 (build_public_response_v2) — blocos logicos EN-US. Fonte: response_builder.py."},"RiskAuditV2Response":{"properties":{"response":{"$ref":"#/components/schemas/RiskAuditV2","description":"Public response V2 — always returned"}},"type":"object","required":["response"],"title":"RiskAuditV2Response"},"RiskAuditVerdictV2":{"properties":{"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label","description":"Human-readable verdict"},"level_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Level Code","description":"Classification level code"},"color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Color","description":"Level color"},"icon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon","description":"Level icon"},"risk_matrix":{"additionalProperties":true,"type":"object","title":"Risk Matrix","description":"Risk matrix","default":{}},"applied_actions":{"items":{"$ref":"#/components/schemas/RiskAuditAppliedActionV2"},"type":"array","title":"Applied Actions","description":"Applied actions","default":[]},"decision_details":{"anyOf":[{},{"type":"null"}],"title":"Decision Details","description":"Decision details"}},"additionalProperties":false,"type":"object","title":"RiskAuditVerdictV2"},"TranscriptionResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Unique transcription identifier. Prefix 'tr-' followed by UUID"},"object":{"type":"string","title":"Object","description":"Returned object type. Always 'transcription'"},"model":{"type":"string","title":"Model","description":"Model used for transcription. Ex: 'falaai-transcribe-1'"},"filename":{"type":"string","title":"Filename","description":"Original audio file name uploaded"},"processed_at":{"type":"string","title":"Processed At","description":"Processing datetime in ISO 8601 UTC format"},"usage":{"$ref":"#/components/schemas/TranscriptionUsage","description":"Usage and processing information"},"language":{"type":"string","title":"Language","description":"ISO 639-3 language code detected in audio. Ex: 'por' (Portuguese), 'eng' (English), 'spa' (Spanish)"},"language_confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Language Confidence","description":"Language detection confidence level (0.0 to 1.0). Higher is more reliable"},"duration_seconds":{"type":"number","title":"Duration Seconds","description":"Total audio duration in seconds"},"text":{"type":"string","title":"Text","description":"Full transcription as plain text, including audio events in brackets"},"dialog":{"type":"string","title":"Dialog","description":"Turn-by-turn formatted transcript with speaker identification and start/end timestamps"},"audio_events":{"items":{"$ref":"#/components/schemas/AudioEvent"},"type":"array","title":"Audio Events","description":"List of detected audio events (laughs, sighs, pauses, etc) with timestamps and duration"},"event_types":{"items":{"type":"string"},"type":"array","title":"Event Types","description":"Unique audio event types found in transcription, alphabetically sorted"},"word_count":{"type":"integer","title":"Word Count","description":"Total number of recognized words in transcription"},"input":{"$ref":"#/components/schemas/AudioInputMeta","description":"Metadados do arquivo de audio enviado (duracao, formato, codec, sample rate, canais)"},"client_reference_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Reference Id","description":"Client-supplied ID echoed verbatim (if provided in request)"}},"type":"object","required":["id","object","model","filename","processed_at","usage","language","duration_seconds","text","dialog","audio_events","event_types","word_count","input"],"title":"TranscriptionResponse"},"TranscriptionUsage":{"properties":{"audio_seconds":{"type":"number","title":"Audio Seconds","description":"Actual audio duration processed in seconds"},"credits_consumed":{"type":"integer","title":"Credits Consumed","description":"Number of credits consumed in this request"},"processing_ms":{"type":"integer","title":"Processing Ms","description":"Total processing time in milliseconds"}},"type":"object","required":["audio_seconds","credits_consumed","processing_ms"],"title":"TranscriptionUsage"},"UpdateEmailAlertRequest":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"events":{"anyOf":[{"items":{"$ref":"#/components/schemas/EmailEvent"},"type":"array"},{"type":"null"}],"title":"Events"},"active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Active"}},"type":"object","title":"UpdateEmailAlertRequest"},"UpdateWebhookRequest":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Nome identificador"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL HTTPS destino"},"events":{"anyOf":[{"items":{"$ref":"#/components/schemas/WebhookEvent"},"type":"array"},{"type":"null"}],"title":"Events","description":"Eventos subscritos"},"retry_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Retry Enabled","description":"Habilita retry exponencial"},"active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Active","description":"Ativa/desativa sem deletar"}},"type":"object","title":"UpdateWebhookRequest"},"UsageByKeyItem":{"properties":{"key_id":{"type":"string","title":"Key Id","description":"API key id"},"key_name":{"type":"string","title":"Key Name","description":"API key name"},"total_credits":{"type":"integer","title":"Total Credits","description":"Total credits consumed by the key"},"request_count":{"type":"integer","title":"Request Count","description":"Number of requests"},"last_used":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Used","description":"ISO 8601 of last use (null if never)"}},"type":"object","required":["key_id","key_name","total_credits","request_count"],"title":"UsageByKeyItem"},"UsageLogItem":{"properties":{"id":{"type":"string","title":"Id","description":"Usage log entry id"},"endpoint":{"type":"string","title":"Endpoint","description":"Endpoint called"},"credits_cost":{"type":"integer","title":"Credits Cost","description":"Credits consumed"},"status":{"type":"string","title":"Status","description":"Result status"},"errors_count":{"type":"integer","title":"Errors Count","description":"Errors count"},"created_at":{"type":"string","title":"Created At","description":"ISO 8601 timestamp"}},"type":"object","required":["id","endpoint","credits_cost","status","errors_count","created_at"],"title":"UsageLogItem"},"UsageLogResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/UsageLogItem"},"type":"array","title":"Data"},"page":{"type":"integer","title":"Page"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["data","page","limit"],"title":"UsageLogResponse"},"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"},"VersionResponse":{"properties":{"service":{"type":"string","title":"Service","description":"Service name"},"version":{"type":"string","title":"Version","description":"Current API version"},"deployDate":{"type":"string","title":"Deploydate","description":"Deploy timestamp"}},"type":"object","required":["service","version","deployDate"],"title":"VersionResponse"},"WebhookEvent":{"type":"string","enum":["subscription.created","avulso.completed","subscription.upgraded","subscription.downgraded","subscription.canceled","credits.low","credits.exhausted","subscription.renewed","subscription.expired","payment.failed"],"title":"WebhookEvent"},"WebhookItem":{"properties":{"id":{"type":"string","title":"Id","description":"Webhook id"},"user_id":{"type":"string","title":"User Id","description":"Owner user id"},"name":{"type":"string","title":"Name","description":"Webhook name"},"url":{"type":"string","title":"Url","description":"Destination URL"},"secret":{"type":"string","title":"Secret","description":"HMAC signing secret"},"events":{"items":{"type":"string"},"type":"array","title":"Events","description":"Subscribed events"},"active":{"type":"boolean","title":"Active","description":"Is active"},"retry_enabled":{"type":"boolean","title":"Retry Enabled","description":"Retry enabled"},"last_delivery_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Delivery At","description":"ISO 8601 of last delivery"},"last_status":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Last Status","description":"Last HTTP status delivered"},"failure_count":{"type":"integer","title":"Failure Count","description":"Consecutive failures","default":0},"created_at":{"type":"string","title":"Created At","description":"ISO 8601 created"},"updated_at":{"type":"string","title":"Updated At","description":"ISO 8601 updated"}},"type":"object","required":["id","user_id","name","url","secret","events","active","retry_enabled","created_at","updated_at"],"title":"WebhookItem"},"WebhookListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/WebhookItem"},"type":"array","title":"Data"},"page":{"type":"integer","title":"Page"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["data","page","limit"],"title":"WebhookListResponse"}},"securitySchemes":{"ApiKeyAuth":{"type":"http","scheme":"bearer","bearerFormat":"fai_xxx","description":"Enter your API Key (fai_...)"}}},"servers":[{"url":"https://api01-falaai.action.tec.br","description":"FalaAI API - producao"}],"security":[{"ApiKeyAuth":[]}]}