チャット補完の作成 (qwen-mt-turbo)

プロンプトを入力すると、モデルは1つまたは複数の予測される補完（Completion）を返します。また、各位置における代替トークン（Tokens）の確率を返すことも可能です。このAPIは主に、モデルとの対話や機械翻訳などの自然言語処理タスクに使用されます。

公式リファレンス： Alibaba Cloud Model Studio (百錬) - 機械翻訳モデル

エンドポイント情報

• 通信プロトコル： HTTP/HTTPS
• リクエストメソッド： POST
• エンドポイントURL： https://api.codingplanx.ai/v1/chat/completions

リクエストヘッダー (Headers)

リクエストパラメータ (Request Body)

リクエストボディの形式は application/json です。

リクエスト例 (機械翻訳のシナリオ)

{
  "model": "qwen-mt-turbo",
  "messages": [
    {
      "role": "user",
      "content": "看完这个视频我没有笑"
    }
  ],
  "translation_options": {
    "source_lang": "auto",
    "target_lang": "English"
  }
}

(注: translation_options は qwen-mt-turbo 翻訳モデル特有の拡張パラメータです)

レスポンスパラメータ (Response Body)

レスポンスフォーマットは application/json です。

レスポンス例 (200 OK)

{
    "id": "chatcmpl-123",
    "object": "chat.completion",
    "created": 1677652288,
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "\r
\r
Hello there, how may I assist you today?"
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 9,
        "completion_tokens": 12,
        "total_tokens": 21
    }
}

---

よくある質問 (FAQ)

1. qwen-mt-turbo モデルは主にどのようなシナリオで使用されますか？

qwen-mt-turbo は、機械翻訳（Machine Translation）に特化して深く最適化されたモデルです。標準的なChat Completions（チャット補完）APIを使用しますが、翻訳対象のテキストを渡し、ソース言語とターゲット言語を設定することで、非常に高品質な翻訳結果を提供します。

2. タイプライター効果（ストリーミング出力）を実装するにはどうすればよいですか？

リクエストボディで stream パラメータを true に設定します。この場合、APIは完全なJSONレスポンスを一度に返すのではなく、Server-Sent Events (SSE) プロトコルを介してデータチャンク（data chunks）を継続的にプッシュします。コンテンツの生成が完了すると、ストリームの終了を示す data: [DONE] が返されます。

3. 401 Unauthorized エラーが発生するのはなぜですか？

リクエストヘッダーの Authorization フィールドを確認してください。フォーマットが Bearer <あなたの_API_KEY> になっていること（Bearer と API Key の間にスペースが1つあることに注意）、およびその API Key が有効な状態であり、該当モデルを呼び出す権限を持っていることを確認してください。

4. temperature と top_p はどのように設定すべきですか？

どちらのパラメータも、モデル出力のランダム性を制御するために使用されます。公式の推奨としては、どちらか一方のみを変更し、もう一方はデフォルト値のままにすることです。翻訳や質疑応答の結果をより厳密で固定されたものにしたい場合は、temperature を低く（例: 0.1 - 0.2）設定することをお勧めします。より創造的なコンテンツを生成したい場合は、高く（例: 0.8）設定してください。

5. リクエスト例にある translation_options は必須ですか？

これは qwen-mt-turbo などの専用翻訳モデルがサポートする拡張設定であり、ソース言語（source_lang）とターゲット言語（target_lang）を明示的に指定するために使用されます。messages 内の content を通じて自然言語のプロンプトで翻訳を指示することも可能ですが、translation_options を使用することで、翻訳の指示がより明確になり、結果が安定します。翻訳以外の基本的な会話に使用する場合は、このパラメータを渡す必要はありません。