翻訳作業を見積もる

翻訳ジョブを作成する前に、送信するドキュメントの作業内容と概算費用を確認します。

翻訳前に対象の作業内容や想定使用量を確認したい場合は、ジョブの見積もりをリクエストしてください。このエンドポイントは、ジョブの作成やパイプラインの実行は行わず、エンジンの現在の設定に基づいてドキュメントの処理計画を立てます。

見積もりをリクエストする #

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 MiB、原文ユニット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 には、BYOK によるプロバイダーへの直接支払い、条件付きの見込み額、外部の人手によるレビュー費用は含まれません。ワークフローを計画する際は、これらを別途確認してください。

金額は、プランの利用枠を適用する前の従量料金の見積もりです。請求額や支出上限を示すものではなく、上限額を保証するものでもありません。原文処理ステージの共通作業は locale: null とともに表示される場合があるため、ロケールごとの行だけを合計しても、ジョブ全体の合計と一致するとは限りません。

処理計画を確認したら、使用する原文のリビジョンとオプションを指定してジョブを作成し、開始してください。見積もりは作業や価格を事前に確保するものではありません。原文、ガイダンス、モデル、パイプライン設定が変わると、実際の作業内容も変わる可能性があります。