トラブルシューティング

Qwen Image Edit の使用中に発生する可能性のある一般的な問題と、それらを解決する方法について説明します。

認証エラー

無効な API キー

API キーが正しく設定されていることを確認してください。キーが無効な場合、または期限切れの場合は、新しいキーを生成する必要がある場合があります。

サポートされていないリージョン

API リクエストが、サポートされているリージョンに送信されていることを確認してください。サポートされているリージョンのリストについては、API リファレンスを参照してください。

クォータとレート制限

クレジット不足

アカウントに十分なクレジットがあることを確認してください。クレジットが不足している場合は、追加のクレジットを購入する必要がある場合があります。

レート制限超過

短期間に送信するリクエストが多すぎると、レート制限に達する可能性があります。リクエストの間に遅延を実装するか、バッチ処理を使用して、レート制限を超えないようにしてください。

画像関連の問題

画像が大きすぎる

処理する画像のサイズが、API の制限を超えていないことを確認してください。大きな画像は、処理前にサイズ変更または圧縮する必要がある場合があります。

サポートされていない画像形式

API がサポートしている画像形式 (例: JPEG、PNG) を使用していることを確認してください。サポートされている形式のリストについては、API リファレンスを参照してください。

ネットワークの問題

接続タイムアウト

ネットワーク接続が安定していることを確認してください。ファイアウォールまたはプロキシ設定が、API への接続をブロックしている可能性があります。

ネットワークエラー

一時的なネットワークの問題が発生している可能性があります。しばらく待ってから、リクエストを再試行してください。

処理の失敗

処理に失敗しました

画像処理が失敗した場合は、入力画像が有効であり、API の要件を満たしていることを確認してください。詳細については、API の応答を確認してください。

コンテンツが検出されません

編集しようとしているコンテンツ (テキストや要素など) が画像内で明確に識別できることを確認してください。コンテンツが不明瞭または小さすぎる場合、API がそれを検出できない可能性があります。

パフォーマンスの問題

処理が遅い

処理が遅い場合は、次のことを検討してください。

画像サイズを最適化する。
バッチ処理を使用する。
より高速なネットワーク接続を使用する。

メモリ不足

大きな画像を処理する場合、メモリ不足エラーが発生する可能性があります。システムに十分なメモリがあることを確認するか、より小さな画像を処理することを検討してください。

デバッグツール

詳細なログ

API クライアントで詳細なログを有効にして、リクエストとレスポンスに関する詳細情報を取得します。これにより、問題の根本原因を特定するのに役立ちます。

リクエストインターセプター

リクエストインターセプターを使用して、API リクエストが正しく形成され、必要なすべてのヘッダーとパラメーターが含まれていることを確認します。

ヘルスチェック

API のヘルスチェックエンドポイントを使用して、サービスが正常に動作していることを確認します。

サポート

上記の手順で問題が解決しない場合は、サポートチームにお問い合わせください。問題の診断に役立つように、関連するすべてのエラーメッセージ、リクエスト ID、およびログを提供してください。