자막 정렬 실패
이 문제가 발생하면 API는 422 Unprocessable Content을 반환합니다. type 값은 https://lingo.dev/docs/api/errors/vtt-alignment-failed입니다. 모든 오류에 공통으로 적용되는 구조는 오류 및 상태 코드를 참고하세요.
LLM이 반환한 구간은 2개이며, 예상한 구간도 2개(원본 장면당 하나)입니다. 모델이 장면을 누락하거나 병합했을 가능성이 높습니다. 안전하게 진행할 수 없으므로 수동으로 다시 정렬해야 합니다.
필드#
본문에는 표준 멤버인 type, status, title, detail 외에도 다음 필드가 포함됩니다. detail 텍스트는 이 필드를 바탕으로 생성되므로 클라이언트에서 자체 문구를 대신 표시할 수 있습니다.
| 필드 | 유형 |
|---|---|
reason | object |
예시#
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