번역 작업 추산

번역 작업을 생성하기 전에 제출할 문서의 작업량과 예상 비용을 미리 확인하세요.

번역을 시작하기 전에 처리 대상으로 선택된 작업이나 예상 사용량을 확인하려면 추산을 요청하세요. 이 엔드포인트는 작업을 생성하거나 파이프라인을 실행하지 않고, 엔진의 현재 설정에 따라 문서 처리 계획을 세웁니다.

추산 요청 #

http
POST /v2/organizations/:orgId/localization/estimates
Content-Type: application/json
X-API-Key: YOUR_API_KEY

작업 생성과 동일한 engineId, sourceLocale, targetLocales, documents 필드를 사용하세요. 인라인 JSON, 아티팩트 주소, 이전 원문과 이전 번역을 지원합니다. originId 같은 작업 전용 옵션은 생략하세요.

json
{
  "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가 포함됩니다.

필드의미
worksourceUnits, pendingTranslations, reusedTranslations의 개수.
totals계획된 토큰 수와 비용의 합계.
conditional이후 결과에 따라 달라지는 작업을 위해 별도로 책정한 예비 비용.
byLocale대상 로캘별 대기 중인 번역과 재사용된 번역, 계획된 비용과 조건부 비용.
stages단계, 선택 사항인 로캘 값(공유 작업은 null), 조건부 플래그, 단위 수와 요청 수, 예상 비용.
exclusionsexternalHumanReview 등 비용이 산정되지 않은 작업.
warnings이 추산에 적용되는 한도와 가정.

각 비용 객체에는 inputTokens, outputTokens, providerCostUsd, providerDirectCostUsd, localizationCostUsd, aiReviewCostUsd, totalCostUsd가 포함됩니다. totalCostUsd에는 자체 키를 사용해 제공업체에 직접 지불하는 비용, 조건부 예비 비용, 외부 휴먼 리뷰 수수료가 포함되지 않습니다. 워크플로를 계획할 때는 이 비용들을 별도로 확인하세요.

표시된 금액은 요금제의 기본 제공량을 적용하기 전의 예상 사용 요금입니다. 청구 금액이나 지출 한도가 아니며, 최대 비용을 보장하지도 않습니다. 여러 로캘이 공유하는 원문 처리 단계의 작업에는 locale: null가 표시될 수 있으므로, 로캘별 행의 합계가 전체 작업의 합계와 일치하지 않을 수 있습니다.

계획을 확인한 후 사용할 원문 버전과 옵션을 지정해 작업을 생성하고 시작하세요. 추산만으로 작업이나 가격이 확정되지는 않습니다. 원문, 지침, 모델 또는 파이프라인 설정이 바뀌면 실제 처리할 작업도 달라질 수 있습니다.