リソース

よくある質問

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 を添えてサポートへお問い合わせください。

利用規模と対象のワークスペースを添えてお問い合わせください。

利用枠と待機時間をレスポンスで確認します。429 の場合は retry-after に従って送信頻度を調整してください。レート制限

ジョブの usage_summary で、そのジョブの消費量を確認できます。キーの所属先はアカウントとワークスペースで確認します。

HTTP クライアントを持つ言語から REST API に接続できます。クライアントライブラリには Python と JavaScript の例があります。

  1. 利用するワークスペースの API キーを用意します。
  2. クイックスタートで認証と生成を試します。
  3. API の仕組みで非同期処理を確認します。
  4. 利用できるモデルと入力形式を選びます。

クライアントのタイムアウトは、ジョブの停止を意味しません。ジョブ ID が分かる場合は状態を取得します。受付結果が分からない場合は同じ入力と冪等性キーで再試行します。ポーリング

解決しないときは