Pular para o conteúdo

Tradução instantânea

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" }
POST /api/v1/ai/translate-batch
{
"segments": [
{ "id": "p1", "text": "First paragraph." },
{ "id": "p2", "text": "Second paragraph." }
],
"target_lang": "zh"
}
  • segments armazena de 1 a 64 segmentos, cada um com no máximo 4000 caracteres; cada id é exclusivo dentro da solicitação (de 1 a 64 caracteres). Um número excessivo de segmentos ou um segmento muito longo retorna 413.
  • 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.
  • 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 engine indisponível retorna 400; se a chave tiver configurações permitidas que não incluem a selecionada, 403.
  • Cobrado com base na quantidade de texto-fonte efetivamente processada.
POST /api/v1/ai/ocr

Carregue 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 }
]
}
  • x e y sã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 é 200 com blocks vazio.
  • 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 em detail; 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, scene e lang sã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.

POST /api/v1/ai/notes, /ai/chat e /ai/generate foram desativados e retornam 410.