Qwen3.8-Max クイックスタート — チャット、エージェント、コーディングワークフロー

Qwen3.8-Max クイックスタート — チャット、エージェント、コーディングワークフロー

Qwen3.8-Max は、Novita AI 上でモデル ID qwen/qwen3.8-max、OpenAI 互換のアクセス先 https://api.novita.ai/openai、1,000,000 トークンのコンテキストウィンドウ、最大 131,072 トークンの出力上限で利用可能です。クイックスタートの答えをひとことで言うなら、チャット、エージェント、コーディングワークフローで、保持するコンテキストが非常に大きい場合に真価を発揮するモデルであり、まずは短いテキストのみのリクエストから始め、その後長いプロンプトやツール使用、マルチモーダル入力へとスケールさせるのが良いでしょう。提供状況と料金の概要については、Qwen3.8-Max on Novita AI: 2.4T MoE、1M コンテキスト、ローンチ料金 をご覧ください。

Qwen3.8-Max API のセットアップ

まずは以下の 4 つの設定項目を確認します。

項目
API キー Novita AI の API キーを NOVITA_API_KEY に保存
OpenAI 互換のベース URL https://api.novita.ai/openai
チャット補完エンドポイント POST https://api.novita.ai/openai/v1/chat/completions
モデル ID qwen/qwen3.8-max

シェルでキーをエクスポートします。

export NOVITA_API_KEY="your_api_key"

すでに OpenAI SDK を使用している場合、統合に必要な変更はわずかです。クライアントコードはそのままに、ベース URL を Novita AI に向け、モデルを qwen/qwen3.8-max に変更するだけです。

Qwen3.8-Max の料金、制限、機能

コード内では正確なモデル ID を使用してください。ユーザー向けの表記では、表示名「Qwen3.8 Max」を使用します。

項目 現在の Novita の値
表示名 Qwen3.8 Max
API モデル ID qwen/qwen3.8-max
モデルファミリー Qwen
モデルページの説明 コーディングと知識作業向けの 2.4T パラメータ MoE フラグシップモデル
エンドポイントファミリー chat/completionsanthropicresponses
入力モダリティ テキスト、画像、動画
出力モダリティ テキスト
コンテキストウィンドウ 1,000,000 トークン
最大出力トークン 131,072
機能 サーバーレス API、推論、構造化出力、関数呼び出し
表示されるレートティア T1 30 RPM / 50,000,000 TPM ~ T5 6000 RPM / 50,000,000 TPM

2026 年 8 月 5 日 時点で、Novita は qwen/qwen3.8-max に対して以下の価格を掲載しています。

トークンタイプ 掲載価格
入力トークン 1M トークンあたり $2
キャッシュ読み取り入力トークン 1M トークンあたり $0.25
出力トークン 1M トークンあたり $6

これらの数値は計画を立てるには十分ですが、盲目的に予算を組むには不十分です。1M コンテキストのモデルは、大きすぎるプロンプトを繰り返し送信したり、補完を長く実行させたりすると、すぐに高額になる可能性があります。本番稼働や顧客向けのコストコミットメントの前には、Qwen3.8 Max モデルページNovita AI 料金ページ を必ず再確認してください。

最初の cURL リクエスト

まずは短いテキストのみのリクエストから始めます。これにより、ツール呼び出し、画像、長いプロンプトを扱う前に、認証、ルーティング、レスポンスの解析を確認できます。

curl "https://api.novita.ai/openai/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${NOVITA_API_KEY}" \
  -d '{
    "model": "qwen/qwen3.8-max",
    "messages": [
      {
        "role": "system",
        "content": "あなたは簡潔なエンジニアリングアシスタントです。"
      },
      {
        "role": "user",
        "content": "マルチリポジトリのAPI移行における主なリスクを5つの箇条書きで要約してください。"
      }
    ],
    "temperature": 0.2,
    "max_tokens": 400
  }'

成功したレスポンスは、choicesmessage.contentusage を含む標準的なチャット補完形式を返します。

このスモークテストを使用して、以下を確認します。

  • API キーが有効であること
  • モデル ID が受け入れられること
  • クライアントが choices[0].message.content を読み取れること
  • トークン使用量を最初からログに記録していること

Python の例

OpenAI Python SDK は、Novita のベース URL を設定することで Novita AI で動作します。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["NOVITA_API_KEY"],
    base_url="https://api.novita.ai/openai",
)

response = client.chat.completions.create(
    model="qwen/qwen3.8-max",
    messages=[
        {"role": "system", "content": "あなたは簡潔なエンジニアリングアシスタントです。"},
        {
            "role": "user",
            "content": "このロールアウト計画をレビューし、最初にテストすべき運用上のリスクを3つ指摘してください。"
        },
    ],
    temperature=0.2,
    max_tokens=400,
)

print(response.choices[0].message.content)
print(response.usage)

本番環境では max_tokens を明示的に指定してください。Qwen3.8-Max は非常に長い回答を生成できるため、難しいタスクには有用ですが、補完に制約をかけないままにしておくと、簡単に費用が超過する可能性があります。

チャットワークフローパターン

チャット製品において、Qwen3.8-Max が最も有用なのは、会話履歴が実際に大きい場合や、アシスタントが複数の長いドキュメントを作業記憶に保持する必要がある場合です。短い Q&A や軽量なサポートがワークロードの場合は、より小規模なモデルの方が安価で調整が容易な可能性があります。

実用的なチャットロールアウトのパターンは次のようになります。

  1. テキストのみのプロンプトと控えめな max_tokens 制限から始める。
  2. 実際のシステムプロンプトとポリシーテキストを追加する。
  3. 理論上の最大値 1M ではなく、実際の製品を反映した長い履歴の会話をテストする。
  4. 使用量を拡大する前に、レイテンシ、トランケーションの動作、平均補完長を測定する。

避けるべき主な間違いは、1M のコンテキストウィンドウを情報損失を防ぐための「容量の上限」ではなく、「目標」として扱うことです。大きなコンテキストは、情報損失を防ぐ場合に有用であり、自動的に効率的になるわけではありません。

エージェントワークフローパターン

Novita は関数呼び出しと構造化出力をサポート機能として掲載しており、Qwen3.8-Max は、ツール選択と大規模な状態保持を必要とするエージェントワークフローに適した候補です。

モデルが散文で回答する代わりにアクションを選択すべき場合は、関数呼び出しを使用します。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["NOVITA_API_KEY"],
    base_url="https://api.novita.ai/openai",
)

tools = [
    {
        "type": "function",
        "function": {
            "name": "search_repo",
            "description": "リポジトリ内のファイルやシンボルを検索します。",
            "parameters": {
                "type": "object",
                "properties": {
                    "query": {"type": "string"},
                    "path": {"type": "string"}
                },
                "required": ["query"]
            }
        }
    }
]

response = client.chat.completions.create(
    model="qwen/qwen3.8-max",
    messages=[
        {"role": "system", "content": "あなたはリポジトリ分析エージェントです。"},
        {
            "role": "user",
            "content": "リトライバックオフが実装されている場所を見つけ、ハードコードされたスリープ値があれば特定してください。"
        },
    ],
    tools=tools,
    tool_choice="auto",
    temperature=0.1,
)

message = response.choices[0].message
print(message.tool_calls or message.content)

Qwen3.8-Max はすべてのエージェントに適したデフォルトというわけではありません。エージェントが大量のイシュースレッド、設計ノート、リポジトリサマリー、長いツールトレースをコンテキストに保持する必要がある場合に特に適しています。エージェントが主にタイトなツールループで短いタスクを処理する場合は、より安価なモデルと併せてテストすることをお勧めします。

コーディングワークフローパターン

コーディングタスクにおいて、Qwen3.8-Max は汎用的なデフォルトとしてではなく、長いコンテキストを必要とする専門家として扱うのが最適です。リポジトリ全体の規模、アーキテクチャノート、以前のパッチ、テストの失敗などをすべて同時に把握する必要がある場合に、最も効果を発揮します。

以下のようなワークロードに使用します。

  • リポジトリ全体のリファクタリング計画
  • 大規模な PR レビューと要約
  • 複数ファイルにまたがるデバッグ
  • 長い設計ドキュメントを用いた移行分析
  • 周囲の多くのコンテキストに依存するコード生成タスク

最初に試す簡単なコーディングプロンプトの例:

このサービス境界の変更をレビューし、破壊的なAPIリスクを特定し、コードを書く前に最も安全な最小のパッチシーケンスを提案してください。

生の API 呼び出しではなくターミナルエージェントのセットアップが必要な場合は、このモデルを How to Use Codex with Novita AI Models: Complete Setup Guide と組み合わせて使用してください。Qwen に特化したコーディングエンドポイントの比較については、Qwen3 Coder Next API on Novita AI for Coding Agents をご覧ください。

マルチモーダル入力

Novita は、Qwen3.8-Max の入力モダリティとしてテキスト、画像、動画をサポートしていると記載しています。つまり、スクリーンショットレビュー、ドキュメント理解、動画対応分析などのワークフローを、同じモデルファミリーでテストできます。

OpenAI 互換のメッセージ形式を使用した基本的な画像入力の例:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["NOVITA_API_KEY"],
    base_url="https://api.novita.ai/openai",
)

response = client.chat.completions.create(
    model="qwen/qwen3.8-max",
    messages=[
        {"role": "system", "content": "あなたはUIレビューアシスタントです。"},
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "このダッシュボードのスクリーンショットで、最も明らかなユーザビリティの問題を説明してください。"
                },
                {
                    "type": "image_url",
                    "image_url": {"url": "https://example.com/dashboard.png"}
                }
            ]
        }
    ],
    max_tokens=500,
)

print(response.choices[0].message.content)

マルチモーダル入力は、テキストのみのベースラインとは別にテストしてください。ペイロードのサポートはエンドポイントファミリーやクライアントライブラリのバージョンによって異なる可能性があるため、実際にデプロイするリクエストの正確な形状を検証してください。

よくある間違い

最も一般的なセットアップエラーは単純なものです。

  • 表示名を qwen/qwen3.8-max の代わりに使用する
  • SDK のベース URL を間違える
  • 小さなリクエストが動作することを確認する前に、巨大なプロンプトを送信する
  • 長いコンテキストモデルで max_tokens を制約なしのままにする
  • 掲載されているコンテキスト制限が、すべてのタスクが最大に近いコンテキストを使用すべきだという意味だと誤解する

5 番目の誤解は、本番環境で最も深刻な影響を及ぼすことが多いものです。大きなウィンドウは重要なコンテキストを保持できるようにするものであり、プロンプトの予算管理が不要になるわけではありません。

本番稼働前のチェックリスト

Qwen3.8-Max に重要なトラフィックを流す前に、以下のケースをテストしてください。

  • 認証とレイテンシベースライン確認のための短いテキストのみのプロンプト
  • 実際の作業サイズでの長いコンテキストプロンプト
  • 正しい答えがツール呼び出しである関数呼び出しプロンプト
  • 製品が画像や動画入力を使用する場合のマルチモーダルプロンプト
  • 無効なキー、タイムアウト、サイズ超過リクエストなどの障害ケース

また、以下も追跡します。

  • 平均プロンプトトークン数
  • 平均補完トークン数
  • 長く安定したプロンプトを再利用する場合のキャッシュ読み取り使用量
  • 想定する同時実行ティアでのレイテンシ
  • 合成ベンチマークだけでなく、実際のワークフローにおける回答品質

FAQ

Qwen3.8-Max は Novita AI で利用できますか?

はい。2026 年 8 月 5 日時点で、Novita は Qwen3.8-Max をサーバーレスモデルとして、API モデル ID qwen/qwen3.8-max で掲載しています。

最初にどのエンドポイントを使うべきですか?

POST https://api.novita.ai/openai/v1/chat/completions から始めてください。これは最初のリクエストとして最もシンプルなパスであり、標準的な OpenAI スタイルのクライアントフローと一致します。

Qwen3.8-Max はツールの使用をサポートしていますか?

はい。Novita はモデルページで、関数呼び出しと構造化出力をサポート機能としてリストしています。

Qwen3.8-Max はすべてのコーディングタスクに最適なデフォルトですか?

いいえ。非常に大きなコンテキストを保持する必要があるワークフローで最も強力です。小規模なコーディングタスクの場合は、フラッグシップオプションが自動的に最良の運用選択であると想定するのではなく、より安価なモデルと比較する必要があります。

おすすめ記事

確認日: 2026 年 8 月 5 日。出典: Qwen3.8 Max モデルページNovita チャット補完 API リファレンスNovita ドキュメントインデックス