Übersetzungsaufwand schätzen

Sehen Sie den voraussichtlichen Aufwand und die ungefähren Kosten für die eingereichten Dokumente, bevor Sie einen Übersetzungsauftrag erstellen.

Fordern Sie eine Schätzung für einen Auftrag an, um vor der Übersetzung den ausgewählten Arbeitsumfang oder den voraussichtlichen Verbrauch einzusehen. Der Endpunkt plant die Verarbeitung der Dokumente anhand der aktuellen Konfiguration der Engine, ohne einen Auftrag zu erstellen oder die Pipeline auszuführen.

Schätzung anfordern #

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

Verwenden Sie dieselben Felder engineId, sourceLocale, targetLocales und documents wie bei der Auftragserstellung. Unterstützt werden Inline-JSON, Artefaktadressen, frühere Ausgangstexte und frühere Übersetzungen. Lassen Sie Optionen weg, die nur für Aufträge gelten, etwa originId.

json
{
  "engineId": "YOUR_ENGINE_ID",
  "sourceLocale": "en",
  "targetLocales": ["es"],
  "documents": [
    {
      "key": "messages.json",
      "format": { "type": "json" },
      "source": { "content": { "save": "Save changes", "cancel": "Cancel" } }
    }
  ]
}

Die Anfrage unterstützt maximal 100 Dokumente und 100 unterschiedliche Zielsprachen, einschließlich abweichender Einstellungen für einzelne Dokumente. Die Planung ist außerdem auf 25 MiB Eingabedaten, 20.000 Quelleinheiten und 20.000 ausstehende Übersetzungen begrenzt. Teilen Sie größere Arbeitsumfänge auf mehrere kleinere Schätzungen auf. EstimateTooLarge gibt das überschrittene Limit an; EstimateDocumentInvalid kennzeichnet ein Dokument, das nicht geparst oder zugeordnet werden kann.

Fehlende Dateien bereitstellen #

Eine Antwort mit HTTP 200 kann "_tag": "MissingArtifacts" mit einem uploads-Array enthalten. Laden Sie für jede Adresse die Originaldaten mit einem authentifizierten PUT an die jeweils zurückgegebene uploadUrl hoch und wiederholen Sie anschließend die Schätzungsanfrage. Dabei werden Artefakte für die Organisation hochgeladen; es wird kein Auftrag erstellt.

Bei reinen Inline-Eingaben wird das bereitgestellte JSON für die Schätzung direkt gelesen. Auch eine Schätzung sendet Inhalte an Lingo.dev; sie ist keine Offline-Prüfung.

Schätzung lesen #

Eine fertige Antwort enthält "_tag": "Estimated" und approximate: true:

FeldBedeutung
workJeweilige Anzahl von sourceUnits, pendingTranslations und reusedTranslations.
totalsGeplante Gesamtzahl der Tokens und Gesamtkosten.
conditionalSeparate Kostenansätze für Arbeiten, die von späteren Ergebnissen abhängen.
byLocaleAusstehende und wiederverwendete Übersetzungen, geplante Kosten und bedingt anfallende Kosten für jede Zielsprache.
stagesStufe, optionale Sprache (null für sprachübergreifende Arbeiten), Kennzeichen für bedingte Ausführung, Anzahl der Einheiten und Anfragen sowie geschätzte Kosten.
exclusionsArbeiten ohne Preisangabe, etwa externalHumanReview.
warningsFür diese Schätzung relevante Limits und Annahmen.

Jedes Kostenobjekt enthält inputTokens, outputTokens, providerCostUsd, providerDirectCostUsd, localizationCostUsd, aiReviewCostUsd und totalCostUsd. totalCostUsd umfasst weder direkt beim Anbieter anfallende BYOK-Ausgaben noch bedingte Kostenansätze oder externe Gebühren für die Prüfung durch Menschen. Berücksichtigen Sie diese bei der Planung des Workflows gesondert.

Die Beträge sind Schätzungen der Nutzungsgebühren, bevor die im Tarif enthaltenen Kontingente angerechnet werden. Sie sind weder eine Rechnung noch ein Ausgabenlimit oder eine garantierte Obergrenze. Sprachübergreifende Arbeiten in der Quellstufe können mit locale: null erscheinen. Deshalb ergeben die Zeilen pro Sprache allein nicht unbedingt die Gesamtsumme des Auftrags.

Nachdem Sie den Plan eingesehen haben, erstellen und starten Sie einen Auftrag mit der vorgesehenen Version des Ausgangstexts und den gewünschten Optionen. Die Schätzung reserviert weder Arbeiten noch Preise; Änderungen am Ausgangstext, an Vorgaben, Modellen oder Pipeline-Einstellungen können den tatsächlichen Arbeitsumfang verändern.