Hyper3Dで生成に失敗したのはなぜですか?
生成に失敗した場合は、入力、APIパラメータ、アカウントのアクセス権、クレジット、タスクのステータスを確認します。問題が解決しない場合は、サポートに必要な情報を集めましょう。
Hyper3Dで生成に失敗したのはなぜですか?
Hyper3Dでの生成は、タスクの受け付け前、処理中、またはクライアントによる結果の取得中に失敗することがあります。原因やクレジットの扱いは、どの段階で失敗したかによって異なります。再試行する前に、エラーの全文とタスク識別子を保存してください。
よくある原因
- 画像または3D入力が破損している、サポートされていない、ほぼ透明である、小さすぎる、または被写体がはっきりしていない。
- プロンプトまたはアップロードされたコンテンツが、現在のコンテンツ規則や安全基準により処理できない。
- APIパラメータ、ファイルURL、形式、またはオプションの組み合わせが、選択したエンドポイントに対して無効である。
- 選択したウォレットに利用可能なクレジット、モデルへのアクセス権、または必要なサブスクリプション権限がない。
- サービス、アップロード、ネットワーク、またはキューの一時的な問題により処理が中断された。
試してほしいこと
- 同じリクエストを繰り返し送信するのではなく、エラーの全文を確認します。
- 画像の場合は、被写体がはっきりしており、前景が透明ではない画像を使用し、サポートされている形式と安定したURLを使います。テキストの場合は、矛盾する指示を整理します。
- API呼び出しの場合は、エンドポイントの最新のパラメータ名と許容値を確認します。そのうえで、初期の保留状態を失敗と判断せず、返されたタスクUUIDを使って最終ステータスになるまでポーリングします。
- 正しい個人用またはTeam Walletを選択し、利用可能なクレジット、凍結中のクレジット、Historyを確認します。
- エラーが一時的なものと思われる場合に限り、少し時間を置いて一度だけ再試行します。
クレジットと失敗したタスク
Web版では、対応するワークフローで結果確認フローが採用されています。プレビューや再生成は無料の場合があり、結果の確定時にクレジットが消費されます。未使用の凍結クレジットは、表示されたタイマーの終了後に解放されます。APIタスクについては、レスポンスのconsumed値とウォレットの記録を確認してください。公開ドキュメントでは、最終的に失敗したすべてのタスクに一律の返金対応が適用されるとは保証されていません。
サポートに問い合わせる場合
有効な同じ入力で繰り返し失敗する場合や、最終的に失敗したタスクに予期しない課金が残っている場合は、Feedbackまたはhello@help.hyper3d.aiにお問い合わせください。タスクUUID(またはアセットへのリンク)、エンドポイントまたはモデル、リクエスト時刻、最終ステータス、エラーの全文、ウォレットの種類、クレジットの記録、安全なサンプル入力をお知らせください。APIキー、パスワード、非公開の決済情報は送信しないでください。