文書目次

翻訳タスクAPI

翻訳タスクの作成

/v1/translation/create

文書・ファイル翻訳のための新しい翻訳タスクを作成します。

例

curl
1curl -X POST 'https://otranslator.com/api/v1/translation/create' \
2--header 'Authorization: [yourSecretKey]' \
3--form 'file=@bitcoin.pdf' \
4--form 'fromLang=English' \
5--form 'toLang=Simplified Chinese'

リクエストパラメータ

パラメータタイプデフォルト説明例
*filebinary-
  • 翻訳が必要なファイル - サポートファイル形式：照会
bitcoin.pdf
*fromLangString-
  • ソース言語、ソース言語はターゲット言語と同じであってはなりません - サポート言語：照会
English
*toLangString-
  • 対象言語、対象言語は元の言語と同じにはできません - サポート言語：照会
Simplified Chinese
modelString-
  • 翻訳のAIモデル - サポートモデル：照会
-
fileDescriptionString-

文書説明。追加情報を提供することで翻訳品質を向上させます。例えば、文書の背景情報やその他の翻訳要件の追加など

-
glossaryString-

翻訳時に使用する用語集の名称

-
previewBooleanfalse

プレビューのみ生成するかどうか。プレビューのみ生成する場合、2クレジットをお支払いいただくことで文書翻訳のプレビューを生成します

-
shouldTranslateImageBooleanfalse
  • 文書内の画像を翻訳するかどうか - PDF / DOCX / PPTX / EPUB / ODS / ODT / ODFのみサポート
-
shouldTranslateFileNameBooleantrue

ファイル名を翻訳するかどうか

-
passwordString-

PDFファイルのオープンパスワード

-
ignoreCommentsBooleanfalse

DOCX、PPTX、XLSXのコメントを無視するかどうか

-
ignoreNotesBooleanfalse

PPTXのノートを無視するかどうか

-
ignoreHeadersAndFootersBooleanfalse

DOCXのフッターとヘッダーを無視するかどうか

-
ignoreHiddenBooleanfalse

PPTXの非表示スライドを無視するかどうか

-
ignoreMastersBooleanfalse

PPTXのマスターテキストを無視するかどうか

-
ignoreSheetNamesBooleanfalse

XLSXのシート名を翻訳しないかどうか

-
extractTextRegExpPatternString-
  • 正規表現にマッチするコンテンツのみを翻訳し、それを翻訳文に置き換えます - txtファイルのみサポート
-
extractTextRegExpFlagsString-
  • 正規表現のFlags: g, s, m, u, y - txtのみサポート
-
webhookUrlString-

ステータス更新時のコールバックURL。コールバックの内容には以下が含まれます： {taskId, progress, status}

-

レスポンス

パラメータタイプデフォルト説明例
taskIdString-

タスクID

-
はじめに
開発者になる
翻訳タスクAPI
翻訳タスクの照会