よくある質問
接続先と認証方法は?
https://api.orchestor.io に Authorization: Bearer YOUR_API_KEY を送信します。キーはサーバー側で保管してください。認証
生成結果がすぐに返らないのはなぜですか?
生成は非同期です。受付時の data.job.id を保存し、ポーリングまたは Webhook で完了を確認します。result_ready が true になったら結果を取得します。リクエストとライフサイクル
どのモデルやエンドポイントを使えばよいですか?
画像生成、画像編集、動画生成など、入力と出力に合うモデルを選びます。入力形式、解像度、動画の長さも確認してください。
生成したファイルはいつまで保存されますか?
結果の artifacts からファイルを取得し、長期保存が必要なものは自分のストレージへ保存してください。保持条件は料金とデータ保持で確認します。
失敗した生成は課金されますか?
ジョブの状態と残高・使用量を確認してください。HTTP エラーやエラー名だけでは、予約・精算の状態を判断できません。料金とデータ保持
コンテンツが拒否された場合は?
ジョブの error.category、public_reason、next_action を確認します。generation_rejected などの拒否理由を読み、入力とモデルの制約を見直してください。エラーと再試行
コンテンツが拒否された場合の料金は?
拒否理由だけから返金や予約解除を判断せず、ジョブと使用量を確認します。解決しない場合はジョブ ID を添えてサポートへお問い合わせください。
請求書払いについて相談できますか?
利用規模と対象のワークスペースを添えてお問い合わせください。
API のレート制限は?
利用枠と待機時間をレスポンスで確認します。429 の場合は retry-after に従って送信頻度を調整してください。レート制限
API の利用状況はどこで確認できますか?
ジョブの usage_summary で、そのジョブの消費量を確認できます。キーの所属先はアカウントとワークスペースで確認します。
どのプログラミング言語を使えますか?
HTTP クライアントを持つ言語から REST API に接続できます。クライアントライブラリには Python と JavaScript の例があります。
最初に何をすればよいですか?
生成に時間がかかりすぎる場合は?
クライアントのタイムアウトは、ジョブの停止を意味しません。ジョブ ID が分かる場合は状態を取得します。受付結果が分からない場合は同じ入力と冪等性キーで再試行します。ポーリング
解決しないときは
- •サポート:技術的な問題、アカウント、料金の確認。
- •クイックスタート:最初のリクエストを確認。
- •API リファレンス:エンドポイントの仕様を確認。