Files
CenaForge/voice/app/errors.py
T
MateuusandClaude Opus 5.5 84f30bbc2d CenaForge: primeira versão pública
Gerador de vídeos narrativos (Godot + FFmpeg), painel Next.js, serviço de voz,
Clipador de lives e Publicador para YouTube, TikTok e Instagram.

Inclui a leitura das visualizações dos posts para o Dashboard e o botão
"Publicar no <rede>" nos cartões das publicações.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 16:35:09 -03:00

126 lines
4.3 KiB
Python

"""Erros de domínio → resposta HTTP padronizada `{"error": {"code", "message"}}`."""
from __future__ import annotations
class ServiceError(Exception):
status = 500
code = "internal_error"
message = "Erro interno."
retry_after: int | None = None
def __init__(self, message: str | None = None, retry_after: int | None = None):
super().__init__(message or self.message)
if message:
self.message = message
if retry_after is not None:
self.retry_after = retry_after
class Unauthorized(ServiceError):
status, code, message = 401, "unauthorized", "Chave de serviço ausente ou inválida."
class InsufficientScope(ServiceError):
"""403: a chave é válida, mas não tem o escopo da operação (ADR 0027 §10)."""
status, code, message = 403, "insufficient_scope", "A chave não tem o escopo desta operação."
def __init__(self, scope: str):
super().__init__()
self.scope = scope
class InvalidRequest(ServiceError):
status, code, message = 422, "invalid_request", "Requisição inválida."
class TextTooLong(ServiceError):
status, code, message = 422, "text_too_long", "Texto acima do limite."
class VoiceNotFound(ServiceError):
status, code, message = 422, "voice_not_found", "Voz fora do catálogo."
class VoiceDetailNotFound(ServiceError):
"""404 de GET /v1/voices/{voiceId} (a síntese continua com 422 voice_not_found)."""
status, code, message = 404, "voice_not_found", "Voz fora do catálogo."
class AudioTooLong(ServiceError):
status, code, message = 422, "audio_too_long", "Áudio passaria do limite de duração."
class IdempotencyConflict(ServiceError):
status, code = 409, "idempotency_conflict"
message = "Este requestId já foi usado com outro conteúdo."
class QueueFull(ServiceError):
status, code, message, retry_after = 503, "queue_full", "Fila cheia.", 5
class QueueTimeout(ServiceError):
status, code, message, retry_after = 503, "queue_timeout", "Tempo de espera na fila esgotado.", 5
class SynthesisTimeout(ServiceError):
status, code, message = 504, "synthesis_timeout", "Síntese passou do tempo limite."
class SynthesisFailed(ServiceError):
status, code, message = 500, "synthesis_failed", "Falha na síntese."
class EngineUnavailable(ServiceError):
# 502: o motor depende de um serviço de fora (Edge TTS) que não respondeu. Tente de novo ou use uma voz offline.
status, code, message, retry_after = 502, "engine_unavailable", "Motor de voz indisponível (sem internet?).", 5
class RvcFailed(ServiceError):
status, code = 422, "rvc_failed"
message = "O modelo RVC desta voz não pôde ser usado (arquivo inválido ou incompatível com o Applio 3.7.0)."
class RvcUnavailable(ServiceError):
status, code, message = 501, "rvc_disabled", "Voz de personagem (RVC) exige o Applio instalado pelo setup."
class CloneUnavailable(ServiceError):
# 503: a voz clonada depende do processo de clonagem (voice/.venv-clone, porta 4511), que não respondeu.
status, code, retry_after = 503, "clone_unavailable", 10
message = "A clonagem de voz não está rodando: rode setup.bat -Clone e reinicie o start.bat."
# ---------- transcrição ----------
class InvalidAudio(ServiceError):
status, code, message = 422, "invalid_audio", "Áudio ilegível ou em formato não suportado."
class AudioTooLarge(ServiceError):
status, code, message = 413, "audio_too_large", "Áudio acima do limite de bytes."
class LanguageNotSupported(ServiceError):
status, code, message = 422, "language_not_supported", "Idioma não atendido."
class SttDisabled(ServiceError):
# 501: configuração do serviço, não sobrecarga (o 503 do serviço quer dizer "fila cheia").
status, code, message = 501, "stt_disabled", "Transcrição desligada neste serviço."
class JobNotFound(ServiceError):
# 410 (e não 404): o 404 genérico do serviço significa rota errada (= `misconfigured` no backend).
status, code, message = 410, "job_not_found", "Job desconhecido ou expirado."
class TranscriptionTimeout(ServiceError):
status, code, message = 504, "transcription_timeout", "Transcrição passou do tempo limite."
class TranscriptionFailed(ServiceError):
status, code, message = 500, "transcription_failed", "Falha na transcrição."