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

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

制限

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

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

デバッグ

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

リクエストパラメーター

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

応答パラメーター

パラメーター	タイプ	例	メッセージ
Code	Integer	200	エラーコード
Data	Struct		応答。
Translated	String	Hello	翻訳された文字列。
WordCount	String	10	総単語数
DetectedLanguage	String	zh	ソース言語が auto として渡された場合に、言語識別によって特定されたソース言語コードです
Message	String	success	返されるメッセージ。
RequestId	String	86D18195-D89C-4C8C-9DC4-5FCE789CE6D5	リクエストの ID。

例

リクエストの例

http(s)://[Endpoint]/?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	アカウントサービスが有効化されていないか、支払いが延滞しています。	アカウントサービスが有効化されていないか、支払いが延滞しています。

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