즉시 번역
짧은 텍스트 번역
섹션 제목: “짧은 텍스트 번역”POST /api/v1/ai/translate-snippet{ "text": "Hello world", "source_lang": "auto", "target_lang": "zh", "engine": "xr-397b"}text는 1~5000자입니다. target_lang 및 source_lang(단, auto 제외)는 지원되는 언어 코드여야 하며, 그렇지 않은 경우 422이 됩니다. 응답:
{ "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은 각각 최대 4000자로 구성된 164개의 세그먼트를 저장하며, 각64자). 세그먼트 수가 너무 많거나 세그먼트 길이가 지나치게 길면id은 요청 내에서 고유합니다(1413오류가 반환됩니다.- 응답은 요청 순서대로
segments: [{ "id", "translated_text" }]을 반환합니다. - 공백만 포함된 세그먼트는 그대로 반환되며 요금이 부과되지 않습니다.
- 요청 본문 크기는 2MB로 제한되며, 요청 처리 시간은 최대 180초입니다. 클라이언트의 타임아웃 값을 최소 180초 이상으로 설정하십시오.
Idempotency-Key을 전송합니다. 네트워크 연결 끊김 또는 시간 초과 후에는 동일한 키와 본문으로 재시도하십시오; 두 번 결제되지 않습니다.- 사용할 수 없는
engine은400을 반환합니다. 키에 선택한 설정을 포함하지 않는 허용된 설정이 있는 경우,403입니다. - 실제로 처리된 원본 텍스트의 양에 따라 청구됩니다.
이미지 텍스트 인식
섹션 제목: “이미지 텍스트 인식”POST /api/v1/ai/ocrmultipart/form-data의 file 필드에 이미지를 업로드하십시오(PNG, JPEG, WebP, BMP, GIF, 최대 12MB 및 2,500만 픽셀). 또는 요청 본문으로 이미지를 전송하십시오. 응답에는 픽셀 좌표와 함께 텍스트가 줄 단위로 포함됩니다:
{ "width": 640, "height": 240, "engine": "omnidoc-ocr", "blocks": [ { "text": "编号 INV-20261029-0042", "confidence": 0.97, "x": 23, "y": 76, "w": 366, "h": 33 } ]}x및y은 업로드된 이미지의 좌표계에서 텍스트 줄의 왼쪽 상단 모서리입니다(JPEG에 방향 데이터가 포함된 경우, 이미지는 위로 향한 상태로 읽힙니다).- 한 줄에 하나의 상자;
confidence는 해당 줄의 인식 신뢰도(0–1)입니다. 텍스트가 발견되지 않으면 응답은200이며blocks은 비어 있습니다. - 이미지 텍스트 인식은 크레딧이 부과되지 않습니다. 너비 또는 높이가 11픽셀보다 작은 이미지는 빈 결과를 반환합니다.
- 인식 기능을 일시적으로 사용할 수 없는 경우 응답은
503이며, 시간 초과 시에는504이 반환되고, 중국어 설명은detail에 포함됩니다. 나중에 다시 시도해 주세요. - 웹 번역 확장 프로그램의 로그인(
omnidoc.translate.use), API 키 및 브라우저 로그인 모두 이를 호출할 수 있습니다. - 쿼리 매개변수
engine,scene및lang는 이전 확장 프로그램 버전을 위해 유지되며 결과에 영향을 미치지 않습니다. - 번역된 이미지를 직접 받으려면 이미지를 업로드하고 번역 작업 을 생성하세요.
종료된 엔드포인트
섹션 제목: “종료된 엔드포인트”POST /api/v1/ai/notes, /ai/chat 및 /ai/generate은 폐기되었으며 410을 반환합니다.