---
title: "Translates uploaded document"
method: POST
path: "/v2/blu_translate/translate"
tags: ["translate"]
---

# Translates uploaded document

`POST /v2/blu_translate/translate`

Starts the translation for a document on the translation service

## Headers

- `Authorization` string, required

## Request body

- BluenteInternalTranslateModelTranslateRequest
  - `action` 'start' | 'cancel'
  - `client_id` integer
  - `font_name` string
  - `font_uuid` string — custom font ecosystem (v2); empty = legacy behavior
  - `from` string
  - `id` integer
  - `is_only_extract` boolean
  - `is_use_bilingual` boolean
  - `is_use_custom_glossary` boolean
  - `is_use_glossary` boolean
  - `is_use_table_layout_enhancement` boolean
  - `is_vertical_bilingual` boolean
  - `meta_data` object
  - `namespace` string
  - `namespaces` string[]
  - `page_range` string
  - `scanned_option` integer
  - `selected_engine` string
  - `to` string
  - `to_type` string
  - `translate_image` boolean

## Response `200`

OK

---

[API](https://skmtc.net/bluente/apis/bluente-api.md) · [All operations](https://skmtc.net/bluente/apis/bluente-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bluente/bluente-api/revisions/5c90e58bf672/schema)