文档翻译Document Translation

# 同步模式：基础文档翻译
curl -X POST https://api.itranslator.cc/v1/document/translate \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@report.pdf" \
  -F "source_lang=zh" \
  -F "target_lang=en" \
  -F "output_format=same" \
  -o report_en.pdf

# 异步模式 + 术语库 + 翻译记忆库（适合专业文档）
curl -X POST https://api.itranslator.cc/v1/document/translate \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@contract.docx" \
  -F "source_lang=zh" \
  -F "target_lang=en" \
  -F "translate_mode=async" \
  -F "glossary_id=gl_legal_001" \
  -F "tm_id=tm_law_2024" \
  -F "preserve_formatting=true" \
  -F "callback_url=https://myapp.com/webhook/doc-translate"

# 扫描版 PDF（自动 OCR）
curl -X POST https://api.itranslator.cc/v1/document/translate \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@scanned_manual.pdf" \
  -F "source_lang=auto" \
  -F "target_lang=zh" \
  -F "ocr_fallback=true" \
  -F "translate_mode=async" \
  -F "callback_url=https://myapp.com/webhook/doc-translate"

import requests
import time

token = "YOUR_ACCESS_TOKEN"
url = "https://api.itranslator.cc/v1/document/translate"

# 同步模式：直接获取翻译后的文件
with open("report.pdf", "rb") as f:
    resp = requests.post(
        url,
        headers={"Authorization": f"Bearer {token}"},
        files={"file": f},
        data={
            "source_lang": "zh",
            "target_lang": "en",
            "output_format": "same"
        }
    )
with open("report_en.pdf", "wb") as out:
    out.write(resp.content)
print(f"✅ 翻译完成，字符数: {resp.headers.get('X-Char-Count')}")

# 异步模式：提交任务 + 轮询状态
with open("contract.docx", "rb") as f:
    resp = requests.post(
        url,
        headers={"Authorization": f"Bearer {token}"},
        files={"file": f},
        data={
            "source_lang": "zh",
            "target_lang": "en",
            "translate_mode": "async",
            "glossary_id": "gl_legal_001",
            "tm_id": "tm_law_2024",
            "preserve_formatting": "true",
            "callback_url": "https://myapp.com/webhook/doc-translate"
        }
    )
task = resp.json()
task_id = task["task_id"]
print(f"任务已提交: {task_id}, 状态: {task['status']}")

# 轮询任务状态
while True:
    status_resp = requests.get(
        f"https://api.itranslator.cc/v1/document/tasks/{task_id}",
        headers={"Authorization": f"Bearer {token}"}
    ).json()
    if status_resp["status"] in ("succeeded", "failed"):
        break
    time.sleep(5)

if status_resp["status"] == "succeeded":
    # 下载翻译结果
    download_resp = requests.get(
        f"https://api.itranslator.cc/v1/document/tasks/{task_id}/download",
        headers={"Authorization": f"Bearer {token}"}
    )
    with open("contract_en.docx", "wb") as out:
        out.write(download_resp.content)
    print("✅ 翻译文件已下载")

const axios = require("axios");
const fs = require("fs");

const token = process.env.API_TOKEN;

// 异步模式提交翻译任务
const form = new FormData();
form.append("file", fs.createReadStream("contract.docx"));
form.append("source_lang", "zh");
form.append("target_lang", "en");
form.append("translate_mode", "async");
form.append("glossary_id", "gl_legal_001");
form.append("preserve_formatting", "true");
form.append("callback_url", "https://myapp.com/webhook/doc-translate");

const resp = await axios.post(
  "https://api.itranslator.cc/v1/document/translate",
  form,
  { headers: { ...form.getHeaders(), Authorization: `Bearer ${token}` } }
);
console.log("任务已提交:", resp.data.task_id);

// 查询任务状态
const status = await axios.get(
  `https://api.itranslator.cc/v1/document/tasks/${resp.data.task_id}`,
  { headers: { Authorization: `Bearer ${token}` } }
);
console.log("当前状态:", status.data.status, "进度:", status.data.progress + "%");

// 下载翻译结果（状态为 succeeded 后）
if (status.data.status === "succeeded") {
  const file = await axios.get(
    `https://api.itranslator.cc/v1/document/tasks/${resp.data.task_id}/download`,
    { headers: { Authorization: `Bearer ${token}` }, responseType: "arraybuffer" }
  );
  fs.writeFileSync("contract_en.docx", file.data);
  console.log("✅ 翻译文件已下载");
}

import okhttp3.*;
import java.io.*;

OkHttpClient client = new OkHttpClient();

// 同步模式：直接获取翻译后的文件流
RequestBody body = new MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart("file", "report.pdf",
        RequestBody.create(new File("report.pdf"),
            MediaType.parse("application/pdf")))
    .addFormDataPart("source_lang", "zh")
    .addFormDataPart("target_lang", "en")
    .addFormDataPart("output_format", "same")
    .build();

Request request = new Request.Builder()
    .url("https://api.itranslator.cc/v1/document/translate")
    .header("Authorization", "Bearer " + token)
    .post(body)
    .build();

try (Response response = client.newCall(request).execute()) {
    try (FileOutputStream fos = new FileOutputStream("report_en.pdf")) {
        fos.write(response.body().bytes());
    }
    System.out.println("✅ 字符数: " +
        response.header("X-Char-Count"));
}

package main

import (
    "bytes"
    "fmt"
    "io"
    "mime/multipart"
    "net/http"
    "os"
)

func main() {
    file, _ := os.Open("report.pdf")
    defer file.Close()

    var buf bytes.Buffer
    writer := multipart.NewWriter(&buf)
    fw, _ := writer.CreateFormFile("file", "report.pdf")
    io.Copy(fw, file)
    writer.WriteField("source_lang", "zh")
    writer.WriteField("target_lang", "en")
    writer.WriteField("output_format", "same")
    writer.Close()

    req, _ := http.NewRequest("POST",
        "https://api.itranslator.cc/v1/document/translate", &buf)
    req.Header.Set("Authorization", "Bearer "+os.Getenv("API_TOKEN"))
    req.Header.Set("Content-Type", writer.FormDataContentType())

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()

    out, _ := os.Create("report_en.pdf")
    defer out.Close()
    io.Copy(out, resp.Body)
    fmt.Println("✅ 翻译完成, 字符数:", resp.Header.Get("X-Char-Count"))
}

curl -X GET https://api.itranslator.cc/v1/document/tasks/doc-task-9f8e7d6c \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

curl -X GET https://api.itranslator.cc/v1/document/tasks/doc-task-9f8e7d6c/download \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -o contract_en.docx