자막 정렬 실패

Moses Skoda엔지니어1분 소요

이 문제가 발생하면 API는 422 Unprocessable Content을 반환합니다. type 값은 https://lingo.dev/docs/api/errors/vtt-alignment-failed입니다. 모든 오류에 공통으로 적용되는 구조는 오류 및 상태 코드를 참고하세요.

LLM이 반환한 구간은 2개이며, 예상한 구간도 2개(원본 장면당 하나)입니다. 모델이 장면을 누락하거나 병합했을 가능성이 높습니다. 안전하게 진행할 수 없으므로 수동으로 다시 정렬해야 합니다.

필드#

본문에는 표준 멤버인 type, status, title, detail 외에도 다음 필드가 포함됩니다. detail 텍스트는 이 필드를 바탕으로 생성되므로 클라이언트에서 자체 문구를 대신 표시할 수 있습니다.

필드유형
reasonobject

예시#

json
{
  "detail": "LLM returned 2 spans, expected 2 (one per source scene). Likely the model dropped or merged scenes. Cannot proceed safely — alignment must be redone manually.",
  "reason": {
    "type": "SpanCount",
    "returned": 2,
    "expected": 2
  },
  "type": "https://lingo.dev/docs/api/errors/vtt-alignment-failed",
  "status": 422,
  "title": "Subtitle alignment failed"
}

이 오류를 반환하는 엔드포인트#

  • POST /v2/engines/{engineId}/glossary-terms/extract-from-vtt