Odhad rozsahu překladu
Před vytvořením překladové úlohy si prohlédněte rozsah práce a přibližné náklady na zpracování odesílaných dokumentů.
Pokud si před překladem potřebujete ověřit vybraný rozsah práce nebo očekávanou spotřebu, vyžádejte si odhad úlohy. Koncový bod naplánuje zpracování dokumentů podle aktuální konfigurace engine, aniž by vytvořil úlohu nebo spustil pipeline.
Vyžádejte si odhad #
POST /v2/organizations/:orgId/localization/estimates
Content-Type: application/json
X-API-Key: YOUR_API_KEYPoužijte stejná pole engineId, sourceLocale, targetLocales a documents jako při vytváření úlohy. Podporován je přímo vložený JSON, adresy artefaktů, předchozí zdrojové texty i předchozí překlady. Vynechte možnosti určené pouze pro úlohy, například originId.
{
"engineId": "YOUR_ENGINE_ID",
"sourceLocale": "en",
"targetLocales": ["es"],
"documents": [
{
"key": "messages.json",
"format": { "type": "json" },
"source": { "content": { "save": "Save changes", "cancel": "Cancel" } }
}
]
}Požadavek podporuje nejvýše 100 dokumentů a 100 různých cílových jazyků, a to i se započtením nastavení přepsaných u jednotlivých dokumentů. Pro plánování dále platí limity 25 MiB vstupních dat, 20 000 zdrojových jednotek a 20 000 čekajících překladů. Větší rozsah práce rozdělte do menších odhadů. EstimateTooLarge označuje překročený limit; EstimateDocumentInvalid označuje dokument, který nelze parsovat nebo zarovnat.
Doplňte chybějící soubory #
Odpověď HTTP 200 může vrátit "_tag": "MissingArtifacts" s polem uploads. Pro každou adresu nahrajte původní bajty na vrácenou adresu uploadUrl pomocí autentizovaného požadavku PUT a poté požadavek na odhad zopakujte. Artefakty se nahrávají na úrovni organizace; žádná úloha se nevytváří.
Pokud vstup obsahuje pouze přímo vložená data, odhad se vypočítá přímo z dodaného JSON. I při odhadu se obsah odesílá do Lingo.dev; nejde o offline kontrolu.
Projděte si odhad #
Odpověď s hotovým odhadem obsahuje "_tag": "Estimated" a approximate: true:
| Pole | Význam |
|---|---|
work | Počty pro sourceUnits, pendingTranslations a reusedTranslations. |
totals | Celkový plánovaný počet tokenů a celkové plánované náklady. |
conditional | Samostatné rezervy na práci, která závisí na pozdějších výsledcích. |
byLocale | Čekající a znovu použité překlady, plánované náklady a podmíněné náklady pro každý cílový jazyk. |
stages | Fáze, nepovinné určení jazyka (null pro sdílenou práci), příznak podmíněnosti, počty jednotek a požadavků a odhadované náklady. |
exclusions | Práce bez stanovených nákladů, například externalHumanReview. |
warnings | Limity a předpoklady vztahující se k tomuto odhadu. |
Každý objekt nákladů obsahuje inputTokens, outputTokens, providerCostUsd, providerDirectCostUsd, localizationCostUsd, aiReviewCostUsd a totalCostUsd. totalCostUsd nezahrnuje výdaje za BYOK hrazené přímo poskytovateli, podmíněné rezervy ani poplatky za externí kontrolu prováděnou lidmi. Při plánování workflow tyto položky posuzujte samostatně.
Částky představují odhad poplatků za spotřebu před započtením objemu zahrnutého v plánu. Nejde o fakturu, limit výdajů ani zaručenou horní hranici. Sdílená práce ve fázi zpracování zdroje se může zobrazovat s locale: null, takže součet samotných řádků pro jednotlivé jazyky nemusí odpovídat celkové částce za úlohu.
Po kontrole plánu vytvořte a spusťte úlohu s požadovanou revizí zdroje a nastavením. Odhad nerezervuje práci ani nezaručuje sazby; změny zdroje, pokynů, modelů nebo nastavení pipeline mohou změnit výsledný rozsah práce.