번역 작업 추산
번역 작업을 생성하기 전에 제출할 문서의 작업량과 예상 비용을 미리 확인하세요.
번역을 시작하기 전에 처리 대상으로 선택된 작업이나 예상 사용량을 확인하려면 추산을 요청하세요. 이 엔드포인트는 작업을 생성하거나 파이프라인을 실행하지 않고, 엔진의 현재 설정에 따라 문서 처리 계획을 세웁니다.
추산 요청 #
POST /v2/organizations/:orgId/localization/estimates
Content-Type: application/json
X-API-Key: YOUR_API_KEY작업 생성과 동일한 engineId, sourceLocale, targetLocales, documents 필드를 사용하세요. 인라인 JSON, 아티팩트 주소, 이전 원문과 이전 번역을 지원합니다. originId 같은 작업 전용 옵션은 생략하세요.
{
"engineId": "YOUR_ENGINE_ID",
"sourceLocale": "en",
"targetLocales": ["es"],
"documents": [
{
"key": "messages.json",
"format": { "type": "json" },
"source": { "content": { "save": "Save changes", "cancel": "Cancel" } }
}
]
}요청 하나에 문서는 최대 100개, 대상 로캘은 문서별 재정의로 지정한 로캘까지 포함해 서로 다른 로캘 100개까지 지정할 수 있습니다. 계획 수립에는 입력 25메비바이트, 원문 단위 20,000개, 대기 중인 번역 20,000개의 한도도 적용됩니다. 이 한도를 넘는 작업은 여러 개의 작은 추산 요청으로 나누세요. EstimateTooLarge는 초과한 한도를, EstimateDocumentInvalid는 구문 분석이나 정렬이 불가능한 문서를 나타냅니다.
누락된 파일 제공 #
HTTP 200 응답에서도 uploads 배열이 포함된 "_tag": "MissingArtifacts"가 반환될 수 있습니다. 인증된 PUT를 사용해 각 주소의 원본 바이트를 응답으로 받은 uploadUrl에 업로드한 다음, 추산을 다시 요청하세요. 이 파일은 조직의 아티팩트로 업로드되며, 작업은 생성되지 않습니다.
인라인 입력만 사용하면 제공된 JSON을 직접 읽어 추산합니다. 추산할 때도 콘텐츠는 Lingo.dev로 전송됩니다. 오프라인으로 확인하는 기능은 아닙니다.
추산 결과 확인 #
추산이 완료된 응답에는 "_tag": "Estimated"와 approximate: true가 포함됩니다.
| 필드 | 의미 |
|---|---|
work | sourceUnits, pendingTranslations, reusedTranslations의 개수. |
totals | 계획된 토큰 수와 비용의 합계. |
conditional | 이후 결과에 따라 달라지는 작업을 위해 별도로 책정한 예비 비용. |
byLocale | 대상 로캘별 대기 중인 번역과 재사용된 번역, 계획된 비용과 조건부 비용. |
stages | 단계, 선택 사항인 로캘 값(공유 작업은 null), 조건부 플래그, 단위 수와 요청 수, 예상 비용. |
exclusions | externalHumanReview 등 비용이 산정되지 않은 작업. |
warnings | 이 추산에 적용되는 한도와 가정. |
각 비용 객체에는 inputTokens, outputTokens, providerCostUsd, providerDirectCostUsd, localizationCostUsd, aiReviewCostUsd, totalCostUsd가 포함됩니다. totalCostUsd에는 자체 키를 사용해 제공업체에 직접 지불하는 비용, 조건부 예비 비용, 외부 휴먼 리뷰 수수료가 포함되지 않습니다. 워크플로를 계획할 때는 이 비용들을 별도로 확인하세요.
표시된 금액은 요금제의 기본 제공량을 적용하기 전의 예상 사용 요금입니다. 청구 금액이나 지출 한도가 아니며, 최대 비용을 보장하지도 않습니다. 여러 로캘이 공유하는 원문 처리 단계의 작업에는 locale: null가 표시될 수 있으므로, 로캘별 행의 합계가 전체 작업의 합계와 일치하지 않을 수 있습니다.
계획을 확인한 후 사용할 원문 버전과 옵션을 지정해 작업을 생성하고 시작하세요. 추산만으로 작업이나 가격이 확정되지는 않습니다. 원문, 지침, 모델 또는 파이프라인 설정이 바뀌면 실제 처리할 작업도 달라질 수 있습니다.