DeckFlow Logo Developers DeckFlow documentation
Developer Guide API Reference MCP CLI

Submit Translation Task

Translate presentation files (PPTX, PDF, etc.) while keeping the layout and typography intact.

Interface Specification

Create an asynchronous slide translation task. The value for type must be translation.

POST /tools/tasks

Request Headers

Header Type Required Description
Authorization String Yes Bearer <YOUR_API_KEY> — Your developer API key.
Content-Type String Yes Must be multipart/form-data.

POST Request Body Parameters (Form Data)

Parameter Type Required Description
spaceId String No Target workspace Space ID.
files File Yes Reference document files to translate (PPTX, Keynote, PDF, Word, Excel). Supports multiple files.
type String Yes Task type. Fixed value: translation.
name String No Task display name, e.g., "AI Document Translation Task".
params String (JSON) Yes JSON string containing task parameters. Detailed fields below.

Task Parameters (params)

Inner properties supported inside the params JSON string:

Field Type Required Description
from String Yes Source language code, e.g., "zh".
to String Yes Target language code, e.g., "en".
notifyURL String No Webhook callback address triggered on task status changes.

Supported Languages

The translation API supports the following language codes for both from (source) and to (target) fields:

🔥

Popular

Code Language
enEnglish
zh-CNSimplified Chinese
zh-TWTraditional Chinese
jaJapanese
koKorean
esSpanish
🇪🇺

Europe

Code Language
frFrench
deGerman
itItalian
nlDutch
ruRussian
plPolish
svSwedish
daDanish
fiFinnish
elGreek
csCzech
roRomanian
huHungarian
ukUkrainian
🌏

Asia

Code Language
arArabic
thThai
viVietnamese
heHebrew
🌎

Americas & Others

Code Language
pt-BRBrazilian Portuguese
trTurkish