OpenAI 互換インターフェイスまたは DashScope API を介して Qwen-MT を呼び出すための入出力パラメーターです。
リファレンス: Machine Translation (Qwen-MT)
OpenAI 互換
- シンガポールリージョン
- 米国 (バージニア) リージョン
- 中国 (北京) リージョン
base_url (SDK 用): https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1HTTP エンドポイント: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completionsまず、API キーを作成し、それを環境変数として設定します。OpenAI SDK を使用する場合は、SDK をインストールします。
リクエストボディ |
|
model string (必須)モデル名。サポートされているモデル: qwen-mt-plus、qwen-mt-flash、qwen-mt-lite。 | |
messages array (必須)モデルにコンテキストを提供するメッセージの配列。ユーザーメッセージのみがサポートされています。
メッセージタイプ ユーザーメッセージ object (必須)翻訳する文を含むユーザーメッセージ。
プロパティ content string (必須)翻訳する文。role string (必須)ユーザーメッセージのロールです。値は user に設定する必要があります。 | |
ストリーム boolean (任意) デフォルト値は false です。ストリーミング出力モードを有効にします。有効値:
qwen-mt-flash と qwen-mt-lite は増分的にデータを返します (各チャンクには新しいコンテンツのみが含まれます)。qwen-mt-plus は非増分的にデータを返します (各チャンクには現在までのシーケンス全体が含まれます)。この動作は変更できません。例:II didnI didn'tI didn't laughI didn't laugh after... | |
stream_options object (任意)ストリーミング出力の設定項目。このパラメーターは、stream が true に設定されている場合にのみ有効になります。
プロパティ include_usage boolean (任意、デフォルトは false)。最後のデータチャンクにトークン消費量情報を含めます。有効値:
| |
max_tokens integer (任意)生成するトークンの最大数。出力がこの値を超えると、応答は切り捨てられます。デフォルト値と最大値は、モデルの最大出力長です。詳細については、「モデルの選択」をご参照ください。 | |
seed integer (任意)再現性のある結果を得るための乱数シードです。同じ seed とパラメーターを使用すると、一貫した出力が得られます。有効値: [0, 2<sup>31</sup>-1]。 | |
temperature float (任意) デフォルトは 0.65 です。生成されるテキストの多様性をコントロールするサンプリング温度。値が大きいほど多様なテキストが生成され、値が小さいほど決定論的なテキストが生成されます。有効値: [0, 2)temperature と top_p はどちらもテキストの多様性をコントロールします。どちらか一方のみを設定してください。 | |
top_p float (任意) デフォルトは 0.8 です。生成されるテキストの多様性をコントロールする核サンプリングの確率しきい値。値が大きいほど多様なテキストが生成され、値が小さいほど決定論的なテキストが生成されます。有効値: (0, 1.0]temperature と top_p はどちらもテキストの多様性をコントロールします。どちらか一方のみを設定してください。 | |
top_k integer (任意) デフォルトは 1 です。生成中のサンプリングにおける候補セットのサイズ。たとえば、これを 50 に設定すると、スコア上位 50 のトークンのみがサンプリングプールを形成します。値が大きいほどランダム性が増し、小さいほど決定論的になります。値が None または 100 より大きい場合、top_k は無効になり、top_p のみが有効になります。値は 0 以上である必要があります。非標準の OpenAI パラメーターです。Python SDK: extra_body オブジェクトに配置します extra_body={"top_k": xxx}。Node.js SDK または HTTP 呼び出し: トップレベルパラメーターとして渡します。 | |
repetition_penalty float (任意) デフォルトは 1.0 です。連続するシーケンスでの繰り返しに対するペナルティ。値が大きいほど繰り返しが減少します。値 1.0 はペナルティを適用しません。0 より大きい必要があり、厳密な上限はありません。非標準の OpenAI パラメーターです。Python SDK: extra_body オブジェクトに配置します extra_body={"repetition_penalty": xxx}。Node.js SDK または HTTP 呼び出し: トップレベルパラメーターとして渡します。 | |
translation_options object (必須)翻訳パラメーター。
プロパティ source_lang string (必須)ソース言語の完全な英語名です。詳細については、「サポートされている言語」をご参照ください。これを auto に設定すると、モデルが自動的に入力言語を検出します。target_lang string (必須)ターゲット言語の完全な英語名。詳細については、「サポートされている言語」をご参照ください。terms arrays (任意)用語介入機能を使用する際に設定する用語の配列。
プロパティ source string (必須)ソース言語の用語。target string (必須)ターゲット言語の用語。arrays (任意)翻訳メモリ機能を使用する際に設定する翻訳メモリの配列。
プロパティ source string (必須)ソース言語の文。target string (必須)ターゲット言語の文。string (任意)ドメインプロンプティング機能を使用する際に設定するドメインプロンプト。ドメインプロンプトは英語である必要があります。 extra_body={"translation_options": xxx}。Node.js SDK または HTTP 呼び出し: トップレベルパラメーターとして渡します。 |
チャット応答オブジェクト (非ストリーミング出力) | |
id string一意のリクエスト ID。 | |
choices arrayモデルが生成したコンテンツの配列。
プロパティ finish_reason stringモデルがコンテンツの生成を停止した理由。指定可能な値:
integerchoices 配列内の現在のオブジェクトのインデックス。message objectモデルの出力メッセージ。
プロパティ content string翻訳結果。refusal string現在、null に固定されています。role stringメッセージのロール。 assistant に固定されています。audio object現在、null に固定されています。function_call object現在、null に固定されています。tool_calls array現在、null に固定されています。 | |
created integerリクエストが作成されたときの UNIX タイムスタンプ。 | |
model stringリクエストに使用されたモデル。 | |
object string常に chat.completion です。 | |
service_tier string現在は null に固定されています。 | |
system_fingerprint string現在は null に固定されています。 | |
usage objectリクエストのトークン消費量。
プロパティ completion_tokens integerモデル出力のトークン数。prompt_tokens integer入力のトークン数。total_tokens integer消費されたトークンの合計で、prompt_tokens + completion_tokens と等しくなります。completion_tokens_details object現在、null に固定されています。prompt_tokens_details object現在、null に固定されています。 |
チャット応答チャンクオブジェクト (ストリーミング出力) | |
id string呼び出しの一意の ID。各チャンクオブジェクトは同じ ID を持ちます。 | |
choices arrayモデルによって生成されたコンテンツの配列です。include_usageがtrueに設定されている場合、この配列は最後のチャンクでは空になります。
プロパティ delta objectストリーミングモードで返される出力コンテンツ。
プロパティ content string翻訳結果。qwen-mt-flash と qwen-mt-lite は増分更新を提供します。qwen-mt-plus は非増分更新を提供します。function_call object現在は null に固定されています。refusal object現在は null に固定されています。role stringメッセージオブジェクトのロール。これは最初のチャンクにのみ値を持ちます。stringモデルは次の 3 つの理由のいずれかで生成を停止します:
integerchoices 配列内の現在の応答のインデックス。 | |
created integerリクエストが作成されたときの UNIX タイムスタンプ。各チャンクは同じタイムスタンプを持ちます。 | |
model stringリクエストに使用されたモデル。 | |
object string常に chat.completion.chunk です。 | |
service_tier string現在、null に固定されています。 | |
system_fingerprint string現在 null に固定されています。 | |
usage objectリクエストで消費されたトークン数。これは、include_usage が true の場合にのみ、最後のチャンクで返されます。
プロパティ completion_tokens integerモデル出力のトークン数。prompt_tokens integer入力トークンの数。total_tokens integerトークンの総数。prompt_tokens と completion_tokens の合計です。completion_tokens_details object現在、null に固定されています。prompt_tokens_details object現在、null に固定されています。 |
DashScope
- シンガポール
- バージニア
- 北京
HTTP エンドポイント:
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generationSDK 呼び出しのリージョン設定:- Python コード
- Java コード
API キーを作成し、その API キーを環境変数としてエクスポートする必要があります。DashScope SDK を使用する場合は、DashScope SDK をインストールします。
リクエストボディ |
|
model string (必須)モデル名。サポートされているモデル: qwen-mt-plus、qwen-mt-flash、qwen-mt-lite。 | |
messages array (必須)モデルにコンテキストを提供するメッセージの配列。ユーザーメッセージのみがサポートされています。
メッセージタイプ ユーザーメッセージ object (必須)翻訳する文を含むユーザーメッセージ。
プロパティ content string (必須)翻訳する文。role string (必須)ユーザーメッセージのロール。user に設定する必要があります。 | |
max_tokens integer (任意)生成するトークンの最大数。出力がこの値を超えると、応答は切り捨てられます。デフォルト値と最大値は、モデルの最大出力長です。詳細については、「モデルの選択」をご参照ください。Java SDK では、パラメーターは maxTokens*です。*HTTP 呼び出しの場合、max_tokens を parameters オブジェクトに配置します。 | |
seed integer (任意)再現性のある結果を得るための乱数シードです。同じ seed とパラメーターを使用すると、一貫した出力が生成されます。有効値: [0, 2<sup>31</sup>-1]。HTTP 呼び出しを行う場合、seed を parameters オブジェクトに配置します。 | |
temperature float (任意) デフォルトは 0.65 です。生成されるテキストの多様性をコントロールするサンプリング温度。値が大きいほど多様なテキストが生成され、値が小さいほど決定論的なテキストが生成されます。有効値: [0, 2)temperature と top_p はどちらもテキストの多様性をコントロールします。どちらか一方のみを設定してください。HTTP 呼び出しを行う場合、temperature を parameters オブジェクトに配置します。 | |
top_p float (任意) デフォルトは 0.8 です。生成されるテキストの多様性をコントロールする核サンプリングの確率しきい値。値が大きいほど多様なテキストが生成され、値が小さいほど決定論的なテキストが生成されます。有効値: (0, 1.0]temperature と top_p はどちらもテキストの多様性をコントロールします。どちらか一方のみを設定してください。Java SDK では、パラメーターは topPparameters オブジェクトです。 | |
repetition_penalty float (任意) デフォルトは 1.0 です。連続するシーケンスでの繰り返しに対するペナルティ。値が大きいほど繰り返しが減少します。値 1.0 はペナルティを適用しません。0 より大きい必要があり、厳密な上限はありません。Java SDK では、パラメーターは repetitionPenalty*です。*HTTP 呼び出しの場合、repetition_penalty を parameters オブジェクトに追加します。 | |
top_k integer (任意) デフォルトは 1 です。生成中のサンプリングにおける候補セットのサイズ。たとえば、これを 50 に設定すると、スコア上位 50 のトークンのみがサンプリングプールを形成します。値が大きいほどランダム性が増し、小さいほど決定論的になります。値が None または 100 より大きい場合、top_k は無効になり、top_p のみが有効になります。値は 0 以上である必要があります。Java SDK では、パラメーターは topK*です。*HTTP 呼び出しを行う場合、parameters オブジェクトで top_k を設定します。 | |
stream boolean (任意)ストリーミング出力モードを有効にします。有効値:
qwen-mt-flash と qwen-mt-lite は増分的にデータを返します (各チャンクには新しいコンテンツのみが含まれます)。qwen-mt-plus は非増分的にデータを返します (各チャンクには現在までのシーケンス全体が含まれます)。この動作は変更できません。例:II didnI didn'tI didn't laughI didn't laugh after... このパラメーターは Python SDK でのみサポートされています。Java SDK でストリーミング出力を実装するには、 | |
translation_options object (必須)翻訳パラメーター。
プロパティ source_lang string (必須)ソース言語の正式な英語名です。詳細については、「対応言語」をご参照ください。これを auto に設定した場合、モデルが自動的に入力言語を検出します。target_lang string (必須)ターゲット言語の完全な英語名。詳細については、「サポートされている言語」をご参照ください。terms arrays (任意)用語介入機能を使用する際に設定する用語の配列。
プロパティ source string (必須)ソース言語の用語。target string (必須)ターゲット言語の用語。arrays (任意)翻訳メモリ機能を使用する際に設定する翻訳メモリの配列。
プロパティ source string (必須)ソース言語の文。target string (必須)ターゲット言語の文。string (任意)ドメインプロンプティング機能を使用する際に設定するドメインプロンプト。ドメインプロンプトは英語である必要があります。
Java SDK では、パラメーターは |
チャット応答オブジェクト (ストリーミング出力と非ストリーミング出力で共通)Python SDK の呼び出しが失敗すると | |
status_code stringリクエストのステータスコード。200 は成功を示し、その他の値は失敗を示します。Java SDK はこのパラメーターを返しません。呼び出しが失敗した場合、例外がスローされます。例外メッセージには、status_code と message の内容が含まれます。 | |
request_id string一意のリクエスト ID。Java SDK では、返されるパラメーターは requestId | |
code stringエラーコード。成功時は空です。このパラメーターは Python SDK のみが返します。 | |
output object呼び出し結果。
プロパティ text string現在、null に固定されています。finish_reason stringモデルがコンテンツの生成を停止した理由。有効値:
arrayモデルの出力。
プロパティ finish_reason string有効値:
objectモデルの出力メッセージ。
プロパティ role string出力メッセージのロール。assistant に固定されています。content string翻訳結果。stringこのリクエストに使用されたモデル。 | |
usage objectリクエストのトークン使用量。
プロパティ input_tokens integer入力トークンの数。output_tokens integer出力トークンの数。total_tokens integer合計トークン数。input_tokens + output_tokens と等しくなります。 |
エラーコード
モデル呼び出しが失敗した場合、Python SDK は DashScopeError をスローします。e.code/e.message/e.request_id でエラー情報を取得できます。問題解決については「エラーコード」をご参照ください。