機械翻訳ユニバーサル版呼び出しガイド - Machine Translation

一般的な翻訳インターフェイス呼び出しの説明。

制限

1. QPS 制限は 50 です。拡張要件がある場合は、お問い合わせください。DingTalk グループ番号：21983957

2. インターフェースの使用前に、ユニバーサル版翻訳プロダクトの課金方法と価格を十分に理解していることを確認してください。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。 OpenAPI Explorer は、さまざまな SDK の操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター	タイプ	必須	例	メッセージ
Action	文字列	はい	TranslateGeneral	実行する操作。値：TranslateGeneral
FormatType	文字列	はい	text	翻訳されたテキストの形式。html（Web ページ形式。このパラメーターを設定すると、翻訳対象のテキストと翻訳されたテキストが html 形式で処理されます）、text（テキスト形式。このパラメーターを設定すると、翻訳対象のテキストと翻訳結果はテキスト形式で処理されず、純粋なテキスト形式として処理されます。
Scene	文字列	はい	general	デフォルトの汎用バージョンは general です。
SourceLanguage	文字列	はい	zh	ソース言語機械翻訳の一般バージョン
SourceText	文字列	はい	Hello	翻訳するコンテンツ
TargetLanguage	文字列	はい	en	ターゲット言語機械翻訳の一般バージョン

レスポンスパラメーター

パラメーター	タイプ	例	メッセージ
Code	整数	200	エラーコード
Data	構造体		レスポンス。
Translated	文字列	Hello	翻訳された文字列。
WordCount	文字列	10	単語の総数
DetectedLanguage	文字列	zh	ソース言語が auto として渡された場合の言語識別後のソース言語コード
Message	文字列	success	返されるメッセージ。
RequestId	文字列	86D18195-D89C-4C8C-9DC4-5FCE789CE6D5	リクエストの ID。

例

サンプルリクエスト

http(s)://[エンドポイント]/?Action=TranslateGeneral
&FormatType=text
&Scene=general
&SourceLanguage=en
&SourceText=Hello
&TargetLanguage=zh
&<共通リクエストパラメーター>

サンプル成功レスポンス

XML 形式

<TranslateGeneralResponse>
      <RequestId>14E447CA-B93B-4526-ACD7-42AE13CC2AF6</RequestId>
      <Data>
            <Translated>Hello</Translated>
      </Data>
      <Code>200</Code>
</TranslateGeneralResponse>

JSON 形式

{
    "TranslateGeneralResponse": {
        "RequestId": "14E447CA-B93B-4526-ACD7-42AE13CC2AF6",
        "Data": {
            "Translated": "Hello"
        },
        "Code": 200
    }
}

エラーコード

HttpCode	エラーコード	エラーメッセージ	備考
101	10001	リクエストがタイムアウトしました。	リクエストがタイムアウトしました。
102	10002	システムエラーが発生しました。	システムエラー。
103	10003	URL のデコード中にエラーが発生しました。指定された URL がエンコードされていることを確認してください。	元のテキストをデコードできませんでした。元のテキストが UrlEncode であるかどうかを確認してください。
104	10004	必須パラメーターが不足しています。	アプリケーション ID が指定されていない場合に返されるエラーメッセージ。
105	10005	指定された言語ペアはサポートされていません。	言語項目はサポートされていません。
106	10006	言語の検出中にエラーが発生しました。	システムが文字列を認識できなかった場合に返されるエラーメッセージ。
107	10007	翻訳中にエラーが発生しました。	翻訳に失敗した場合に返されるエラーメッセージ。
108	10008	指定された文字列が長すぎます。	文字数が長すぎます。
199	19999	不明なエラーが発生しました。	不明なエラーが発生しました。
109	10009	RAM ユーザーに権限がありません。	RAM ユーザーに権限がありません。
110	10010	アカウントでサービスが有効になっていません。	アカウントでサービスが有効になっていません。
111	10011	サブアカウントサービスの障害	サブアカウントサービスの障害
112	10012	翻訳サービスの呼び出しに失敗しました。	翻訳サービスの呼び出しに失敗しました。
113	10013	アカウントサービスが有効になっていないか、支払いが期限切れです。	アカウントサービスが有効になっていないか、支払いが期限切れです。

詳細については、「サービスエラーコード」をご参照ください。