PAI モデルギャラリーで、モデルデプロイ、トレーニングの失敗、サービスエラー、デバッグの問題をトラブルシューティングします。
Q:モデル評価で深い思考が有効になっているか確認する方法を教えてください。
モデルの説明ページで、デフォルトのデプロイ設定を確認してください。すべてのモデルは、デフォルトのデプロイ設定を使用して評価されます。
Q:トレーニング後にモデルをデプロイする方法を教えてください。
[PAI-Model Gallery] > [タスク管理] に移動します。
完了したトレーニングタスクを見つけ、クリックして詳細ページを開きます。
右上隅の[デプロイ]をクリックします。

Q:失敗したトレーニングタスクをトラブルシューティングする方法を教えてください。
トレーニングタスクが失敗した場合は、タスク診断またはログを確認してください。一般的な原因として、データセットの形式が正しくないことが挙げられます。
エラーの詳細を確認する方法は 2 つあります。
タスク診断: [PAI-Model Gallery] で、[タスク管理] > [トレーニングタスク] に移動します。失敗したタスクをクリックして、その [タスク詳細] ページを開きます。[失敗] ステータスにカーソルを合わせると、エラーの概要が表示されます。

タスクログ: [タスク管理] > [トレーニングタスク] で、[タスクログ] タブを選択すると、完全なエラーメッセージが表示されます。

主なエラーメッセージと解決策は次のとおりです。
エラー種別
エラーメッセージ
解決策
入出力エラー
ValueError: output channel ${your OSS uri} must be directory
出力パスがファイルではなくディレクトリであることを確認してください。
ValueError: train must be a file
入力パスがディレクトリではなくファイルを指していることを確認してください。
FileNotFoundError
指定した入力パスに有効なファイルが存在することを確認してください。
JSONDecodeError
JSON ファイルの形式が正しいことを確認してください。
ValueError: Input data must be a json file or a jsonl file!
ファイルが JSON または JSONL 形式であることを確認してください。
KeyError: ${some key name}
モデルのドキュメントを確認し、データセット内のすべてのキーと値のペアが要件で指定された形式に一致していることを確認してください。このエラーは JSON データセットで発生することがよくあります。
ValueError: Unrecognized model in /ml/input/data/model/.
PyTorch がモデルファイル形式を認識できません。
UnicodeDecoderError
ファイルで正しい文字エンコーディングが使用されていることを確認してください。
Input/output error
入力パスに対する読み取り権限と、出力パスに対する書き込み権限があることを確認してください。
NotADirectoryError: [Errno 20] Not a directory:
指定したパスがディレクトリであることを確認してください。
ハイパーパラメータ設定
ERROR:torch.distributed.elastic.multiprocessing.api:failed (exitcode: -9) local_rank: 0 (pid: 51) of binary: /usr/bin/python (and there are no related subprocess logs)
モデルの読み込み時にメモリ不足 (OOM) エラーが発生しています。より大きなメモリを持つインスタンスタイプを選択してください。
torch.cuda.OutOfMemoryError: CUDA out of memory
GPU メモリが不足しています。より大容量の VRAM を搭載した GPU インスタンスを選択するか、
lora_dimやbatch_sizeのようなメモリ消費量の多いハイパーパラメーターを減らしてください。ValueError: No closing quotation
system promptまたは別の文字列パラメーターに、閉じていない引用符 (") が含まれているため、トレーニングコマンドの生成ができません。すべての引用符が正しくペアになっていることを確認してください。インスタンスタイプのリソース構成
Exception: Current loss scale already at minimum - cannot decrease scale anymore. Exiting run
精度の問題です。モデルは BF16 形式を使用しており、Ampere 以降のアーキテクチャ (例:A10、A100) の GPU が必要です。古い GPU でトレーニングするとパラメータが FP16 に変換され、このアンダーフローエラーが発生する場合があります。
RuntimeError: CUDA error: uncorrectable ECC error encountered
GPU インスタンスのハードウェア障害です。トレーニングタスクを再試行してください。再度失敗する場合は、別のインスタンスタイプまたはリージョンを試してください。
MemoryError: WARNING Insufficient free disk space
ディスク容量が不足しています。より大きなディスク容量を持つインスタンスタイプを選択してください。
ユーザー制限エラー
failed to compose dlc job specs, resource limiting triggered, you are trying to use more GPU resources than the threshold
GPU クォータを超過しています。トレーニングタスクはデフォルトで同時に 2 GPU までに制限されています。実行中のタスクが完了するまで待つか、チケットを送信してクォータ増加を申請してください。
Q:デプロイ済みモデルでオンラインデバッグを実行する方法を教えてください。
モデルを PAI-EAS 上のサービスとしてデプロイした後、組み込みのオンラインデバッグツールを使用できます。
デプロイされたサービスの検索: [PAI-Model Gallery] > [タスク管理] > [デプロイタスク] に移動します。 PAI-EAS コンソールにリダイレクトされ、そこでデプロイされたサービスを表示できます。

デバッグツールを開く: PAI-EAS ページで目的のサービスを探し、 [操作] 列で [オンラインデバッグ] をクリックします。

リクエストの設定と送信:
PAI-Model Gallery のモデル詳細ページで、必要なリクエスト形式を確認します。たとえば、BladeLLM を使用してデプロイされたモデルは、特定の JSON ボディを含む
/v1/chat/completionsへの POST リクエストを想定している場合があります。

オンラインデバッグ UI で、パス (例:
/v1/chat/completions) を [Request URL] に追記します。
モデル説明ページの例に従って [Request Body] を入力し、[Send Request] をクリックします。
Q:デプロイしたモデルを呼び出すと "503 no healthy upstream" エラーが返るのはなぜですか?
503 Service Unavailable エラーと no healthy upstream というメッセージは、サービスインスタンスのリソースが不足し、新しいリクエストを処理できないことを示します。

原因:インスタンスリソース (CPU、メモリ、または GPU メモリ) が使い切られており、新しいリクエストを処理する余力がありません。
解決策:リソース種別に応じて対応が異なります。
パブリックリソース:共有リソースプールが一時的に過負荷になっています。オフピーク時間帯に再試行するか、別のリージョンまたは別のインスタンス仕様に再デプロイしてください。
専用リソース (EAS Resource Group):リソースグループのスケールが不足しています。グループに十分な CPU、メモリ、GPU メモリがあることを確認してください。リソースバッファは 20% 以上を維持してください。
Q:トレーニング中に "SupportsDistributedTraining false, please set InstanceCount=1" エラーが表示されるのはなぜですか?
原因: 選択したモデルは分散トレーニングをサポートしていませんが、タスクは複数のノード (
InstanceCount > 1) で実行するように設定されています。解決策:トレーニングタスクの設定で[ノード数]を
1に設定し、タスクを再起動します。
Q:Model API が 404 - {'detail': 'Not Found'} を返すのはなぜですか?
考えられる原因は次のとおりです。
モデルサービスは API コールをサポートしていません。モデルギャラリーからデプロイされた一部のモデルは、サービス詳細ページの [Web アプリ] ボタンによる Web ベースの対話にのみ対応しています。これらのモデルは OpenAI 互換の API エンドポイントを提供しておらず、OpenAI SDK を使用して呼び出すことはできません。たとえば、
PAI-DistilQwen2.5-7B-Instructです。リクエストパスが不完全または不正です。たとえば、チャット API エンドポイントは、通常
{domain}/api/predict/{service_name}/v1/chat/completionsの形式です。
モデル選定 FAQ
Q:PAI-DistilQwen2.5-7B-Instruct と DeepSeek-R1-Distill-Qwen-7B の違いは何ですか?
PAI-DistilQwen2.5-7B-Instruct と DeepSeek-R1-Distill-Qwen-7B はいずれも Qwen2.5-7B から蒸留されていますが、用途が異なります。
観点 | PAI-DistilQwen2.5-7B-Instruct | DeepSeek-R1-Distill-Qwen-7B |
ベースモデル | Qwen2.5-7B-Instruct | Qwen2.5-7B + DeepSeek-R1 |
蒸留手法 | ブラックボックスのデータ蒸留 + ホワイトボックスのロジット蒸留 | 知識蒸留 (推論能力の転移) |
ユースケース | 一般的な指示追従 | 数学および推論タスク |
主な特長 | 元のモデルと比べて、指示追従能力が大幅に向上しています。 | 数学問題では、プロンプトに段階的な推論指示を含めてください。 |
Q:Fun-CosyVoice と従来の CosyVoice の違いは何ですか?
Fun-CosyVoice 3.0 は、大規模言語モデル (LLM) に基づく高度な音声合成 (TTS) システムです。前世代の CosyVoice 2.0 と比べて、内容の一貫性、話者の類似性、韻律の自然さが向上しています。
Q:Qwen3 埋め込みモデルの違いは何ですか?
次の表で、Qwen3 埋め込みモデルを比較します。
モデル | モデルの重み | VRAM 使用量 | 最大埋め込み次元 | ユースケース |
Qwen3-Embedding-0.6B | 1.12 GiB | 2-4 GB | 1024 | 軽量な検索、メモリ重視 |
Qwen3-Embedding-4B | 7.55 GiB | 10-14 GB | 2560 | 標準的なセマンティック検索 |
Qwen3-Embedding-8B | 14.11 GiB | 18-24 GB | 4096 | 高精度、複雑なセマンティクス |
ユースケースに基づいて、適切なモデルと GPU を選択してください。
シナリオ | 推奨モデル | 推奨 GPU | 予算 |
個人開発/POC | 0.6B | RTX 3060 / Laptop | Low |
SME API | 4B | A10 (24G) | Medium |
エンタープライズ本番運用 | 8B | A100 40G/80G | High |
超大規模ベクトルデータベース | 0.6B または 4B | A10 x multi-instance | Medium |
高精度セマンティック検索 | 8B | H100 (80G) | Very high |
モデルギャラリーは、Qwen3 埋め込みモデルのワンクリックデプロイをサポートします。以下の点に注意してください。
--max-model-lenが指定されていない場合、vLLM はデフォルトでモデルのconfig.jsonからmax_position_embeddingsを読み取ります。このパラメーターは、入力トークンの最大数を直接制限します。制限を超えた入力は、切り捨てられるか、エラーが発生します。埋め込みモデルは自己回帰生成を実行しませんが、vLLM は完全な KV キャッシュを事前割り当てするため、VRAM が浪費されます。実際のビジネス要件に基づいて、より小さい
--max-model-lenを明示的に設定することをお勧めします。これにより、過剰割り当てによるリソースの無駄を回避しつつ、VRAM 使用量を大幅に削減し、同時実行性を向上させることができます。