翻訳タスクAPI

翻訳タスクの作成

POST/v1/translation/create

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

完全な住所: https://otranslator.com/api/v1/translation/create
認証: Authorizationリクエストヘッダーに API Key を渡す必要があります
Content-Type: multipart/form-data
誤った形式: { "error": "Invalid API key." }

注意事項

タスクを作成すると、すぐに待機キューに入り、taskIdが返されます。その後、タスク照会インターフェースから進捗、費用、ダウンロードリンクを取得できます。

タスクを作成するには、アカウントのポイント残高が最低2 credits必要です。previewがtrueの場合、プレビューのみを生成し、プレビューのポイントを支払います。

glossary パラメータは用語集名で一致させ、複数の用語集を指定する際は同名のフィールドを複数回渡すことができます。

例

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' \
6--form 'outputFormat=MD' \
7--form 'bilingualMode=Horizontal'

リクエストパラメータ

パラメータ	タイプ	デフォルト	説明	例
*file	binary	-	翻訳が必要なファイルサポートファイル形式：照会	bitcoin.pdf
*fromLang	String	-	原言語、原言語は対象言語と同じであってはなりませんサポート言語：照会	English
*toLang	String	-	対象言語、対象言語は元の言語と同じにすることはできませんサポート言語：照会	Simplified Chinese
model	String	-	翻訳のAIモデルサポートモデル：照会	-
fileDescription	String	-	文書説明。追加情報を提供することで翻訳品質を向上させます。例えば、文書の背景情報やその他の翻訳要件の追加など	-
glossary	String	-	翻訳時に使用する用語集の名称	-
preview	Boolean	false	プレビューのみ生成するかどうか。プレビューのみ生成する場合、2クレジットをお支払いいただくことで文書翻訳のプレビューを生成します	-
shouldTranslateImage	Boolean	false	文書内の画像を翻訳するかどうか PDF / DOCX / PPTX / EPUB / ODS / ODT / ODFのみサポート	-
forceOCR	Boolean	false	OCRで文書内容を強制認識するかどうか。有効にすると画像翻訳も同時に有効になります。	-
shouldTranslateFileName	Boolean	true	ファイル名を翻訳するかどうか	-
strictSourceLanguageCheck	Boolean	false	原言語として認識されたテキストのみを翻訳するかどうか。有効にすると、原言語以外のコンテンツをより厳密にフィルタリングし、費用計算にもより厳格な係数を使用します。	-
outputFormat	String	-	出力形式。MDを渡すと、Markdown訳文の生成を試みます。	MD
bilingualMode	String	Horizontal	対訳ファイルのレイアウト方向。Horizontalは左右配置、Verticalは上下配置を表します。	Horizontal
password	String	-	PDFファイルのオープンパスワード	-
ignoreComments	Boolean	false	DOCX、PPTX、XLSXのコメントを無視するかどうか	-
ignoreNotes	Boolean	false	PPTXのノートを無視するかどうか	-
ignoreHeadersAndFooters	Boolean	false	DOCXのフッターとヘッダーを無視するかどうか	-
ignoreHidden	Boolean	false	PPTXの非表示スライドを無視するかどうか	-
ignoreMasters	Boolean	false	PPTXのマスターテキストを無視するかどうか	-
ignoreSheetNames	Boolean	false	XLSXのシート名を翻訳しないかどうか	-
extractTextRegExpPattern	String	-	正規表現にマッチするコンテンツのみを翻訳し、翻訳文に置き換えます txmsgのみサポート	-
extractTextRegExpFlags	String	-	正規表現のFlags: g, s, m, u, y txmsgのみサポート	-
allowFlip	Boolean	true	RTL言語でページレイアウトを反転することを許可するかどうか。falseを渡すと画像の反転も同時にオフになります。	-
allowFlipImage	Boolean	true	RTL言語で画像の内容を反転することを許可するかどうか。	-
webhookUrl	String	-	ステータス更新時のコールバックURL、コールバック内容に含まれるもの: {taskId, progress, status}	-

レスポンス

パラメータ	タイプ	デフォルト	説明	例
taskId	String	-	タスクID	-

よくあるエラー

401 Missing API key.

The Authorization request header is required.

401 Invalid API key.

The API key does not exist, has been deleted, or is no longer valid.

402 Insufficient credits balance.

The account does not have enough credits to create the task.

400 Missing required parameter: fromLang.

Provide fromLang using a language returned by /api/v1/languages.

400 Missing required parameter: toLang.

Provide toLang using a language returned by /api/v1/languages.

400 Invalid fromLang: [language]. Use a language returned by /api/v1/languages.

The provided source language is not supported.

400 Invalid toLang: [language]. Use a language returned by /api/v1/languages.

The provided target language is not supported.

400 Missing required file upload: file.

Upload the source document in the file form field.

404 Glossary "[name]" not found.

The specified glossary does not exist or does not belong to the current API account.