翻訳するファイルの配列。ファイルサイズ：最大500MB。文字数：最大270KB相当。(日本語約9万字) 各段落(改行までは一つの段落)の文字数制限：500字以内。対応フォーマット: PDF, DOCX, XLSX, PPTX, XML。ページ数の制限はございません。言語数に制限はございませんが、単一言語がおすすめです。

contractId

契約のID。利用するAPIに適した契約IDをご指定ください。例：テキスト翻訳APIを利用する場合はテキスト契約IDを,ファイル翻訳APIを利用する場合はファイル契約IDを指定してください。

sourceLang

原文の言語。（一つのみ）一部の言語（zh-CN、zh-TWなど）以外はISO 639-1コードで指定します。省略した場合、自動判定します。 ※文章が短い場合は、言語の自動判定がうまく認識できないので、短文がある場合は、sourceLangを設定してください。対応の言語は「言語一覧取得」を参照してください。原文の言語は現在下記の言語に対応しておりません： am(アムハラ語) 、hy(アルメニア語) 、kn(カンナダ語) 、km(カンボジア語)、my(ミャンマー語)

Body (T-4OOエンジン利用時のみ)

Key

Required

Description

fieldId

T-4OOエンジン利用時のみ。分野ID。正しく指定することで翻訳精度を向上させることができます。「専門分野」を参照してください。 T-3MTエンジン利用する場合、fieldIdは入力しないでください。

t4ooGlossaryId

T-4OOエンジン利用時のみ。統一用語ID複数選択する場合はIDにカンマを入れて連結します。(例)101,252,301 指定しない場合は、ユーザに紐づく統一用語ID(個人統一用語、グループ統一用語)を自動取得します。統一用語を使用しない場合、"-1"を指定してください。 ※IDは別途ご連絡致します。

Body (T-3MTエンジン利用時のみ)

Key

Required

Description

domainId

T-3MTエンジン利用時のみ。「T-3MT用分野」または「モデルID」を入力してください。

translateType

T-3MTエンジン利用時のみ。固定値t3mtを入力してください。

Request例

curl -X POST -H "nonce: Your Nonce" -H "accessKey: Your Access Key" -H "signature: Your Signature" -H "Content-Type: multipart/form-data" -F "files=@Your File Path" -F "targetLangs=[\"en\"]" -F "fieldId=1" https://translate.rozetta-api.io/api/v1/file-translate

Response

Key

Description

status

成功の場合は「success」、失敗の場合は「failure」を返します。

data

オブジェクトとして結果を返します。「translateId」で翻訳結果のファイルを取得する。

api/v1/file-translate

指定されたファイルを英語に翻訳するリクエストを要請します。

JavaScript

VB.NET

const superagent = require('superagent');
const fs = require('fs');
const path = require('path');
const config = require('./config');

const authUtils = require('./utils/auth-utils');

const url = '/api/v1/file-translate';

const sendRequest = async (serverConfig, accessKey, secretKey) => {
  const nonce = new Date().getTime().toString();
  const signature = authUtils.generateSignature(
    url,
    secretKey,
    nonce,
  );
  const langs = ['en'];
  superagent.post(`${serverConfig.protocol}//${serverConfig.hostname}:${serverConfig.port}${url}`)
    .set({
      accessKey,
      signature,
      nonce,
    })
    .attach('files', fs.createReadStream(path.join(
      __dirname,
      'sample-files',
      'testfile.docx',
    )), 'testfile.docx')
    .field('targetLangs', JSON.stringify(langs))
    .field('fieldId', '1')
    .field('contractId', 'your contractId')
    .end((_, resp) => {
      console.log(resp.text);
    });
};

const main = async () => {
  try {
    await sendRequest(
      config.serverConfig,
      config.authConfig.accessKey,
      config.authConfig.secretKey,
    );
  } catch (error) {
    console.error(error);
  }
};

main();

認証については、「認証方法」をご参照ください。

各言語の完全版のサンプルコードをここで参照できます。