Tradução instantânea
Tradução curta de texto
Seção intitulada “Tradução curta de texto”POST /api/v1/ai/translate-snippet{ "text": "Hello world", "source_lang": "auto", "target_lang": "zh", "engine": "xr-397b"}text tem de 1 a 5000 caracteres. target_lang e source_lang (exceto auto) devem ser códigos de idioma suportados; caso contrário, 422. Resposta:
{ "translated_text": "你好,世界", "source_lang": "auto", "target_lang": "zh" }Tradução em lote de segmentos
Seção intitulada “Tradução em lote de segmentos”POST /api/v1/ai/translate-batch{ "segments": [ { "id": "p1", "text": "First paragraph." }, { "id": "p2", "text": "Second paragraph." } ], "target_lang": "zh"}segmentsarmazena de 1 a 64 segmentos, cada um com no máximo 4000 caracteres; cadaidé exclusivo dentro da solicitação (de 1 a 64 caracteres). Um número excessivo de segmentos ou um segmento muito longo retorna413.- A resposta retorna
segments: [{ "id", "translated_text" }]na ordem solicitada. - Segmentos que contêm apenas espaços em branco são retornados como estão e não são cobrados.
Convenções
Seção intitulada “Convenções”- O corpo da solicitação é limitado a 2 MB e uma solicitação pode durar no máximo 180 segundos; configure os timeouts do cliente para pelo menos 180 segundos.
- Envie um
Idempotency-Key. Após uma queda de rede ou timeout, tente novamente com a mesma chave e o mesmo corpo; não será cobrado duas vezes. - Um
engineindisponível retorna400; se a chave tiver configurações permitidas que não incluem a selecionada,403. - Cobrado com base na quantidade de texto-fonte efetivamente processada.
Reconhecimento de texto em imagens
Seção intitulada “Reconhecimento de texto em imagens”POST /api/v1/ai/ocrCarregue a imagem no campo file de multipart/form-data (PNG, JPEG, WebP, BMP, GIF, até 12 MB e 25 milhões de pixels), ou envie a imagem como o corpo da solicitação. A resposta retorna o texto linha por linha com coordenadas de pixels:
{ "width": 640, "height": 240, "engine": "omnidoc-ocr", "blocks": [ { "text": "编号 INV-20261029-0042", "confidence": 0.97, "x": 23, "y": 76, "w": 366, "h": 33 } ]}xeysão os pontos correspondentes ao canto superior esquerdo da linha de texto, nas coordenadas da imagem carregada (uma JPEG com dados de orientação é lida na posição vertical).- Uma caixa por linha;
confidenceé a confiança de reconhecimento dessa linha (0–1). Se nenhum texto for encontrado, a resposta é200comblocksvazio. - O reconhecimento de texto em imagens não consome créditos. Imagens com menos de 11 pixels de largura ou altura retornam um resultado vazio.
- Se o reconhecimento estiver temporariamente indisponível, a resposta é
503; em caso de timeout,504, com uma explicação em chinês emdetail; tente novamente mais tarde. - O login da extensão de tradução web (
omnidoc.translate.use), as chaves da API e o login do navegador podem todos chamá-lo. - Os parâmetros de consulta
engine,sceneelangsão mantidos para versões antigas da extensão e não afetam o resultado. - Para obter imagens traduzidas diretamente, envie a imagem e crie um job de tradução.
Pontos finais aposentados
Seção intitulada “Pontos finais aposentados”POST /api/v1/ai/notes, /ai/chat e /ai/generate foram desativados e retornam 410.