CLI
orc creative
orc creative は、Creative API(/v1/creative)をターミナルから呼び出すコマンドです。画像、動画、音声を生成し、ジョブの状態と成果物を確認できます。CI やスクリプトからも、同じコマンドで生成を実行できます。
インストール
terminal
curl -fsSL https://orchestor.io/install | shWindows と npm でのインストールはインストールを参照してください。
クイックスタート
サインインします。
terminal
orc auth login画像を生成し、完了まで待って成果物を表示します。
terminal
orc creative image generate --model gpt-image-2 --prompt "白い背景の赤い立方体" --waitCI やスクリプトでは、API キーを ORCHESTOR_API_KEY に設定します。API キーは保存済みのサインインより優先されます。ブラウザのダッシュボードセッションは /v1/creative では使えません。
terminal
export ORCHESTOR_API_KEY="<API キー>"生成の流れ
生成は非同期のジョブです。
orc creative image models listなどでモデルを選びます。image generate、video generate、tts generate、voice changeでジョブを作成します。同じ入力を安全に再送するときは--idempotency-keyを付けます。--waitを付けると、ジョブがCOMPLETED、FAILED、CANCELEDのいずれかになるまで待ち、完了したら成果物を表示します。--timeoutと--poll-intervalで待ち方を調整できます。--waitを付けない場合は、orc creative jobs status <id>で状態を、orc creative jobs result <id>で成果物を取得します。完了を--webhook-urlで受け取ることもできます。
手元のファイルを入力に使うときは、orc creative files upload-url create でアップロード先を発行し、返された公開 URL を入力に指定します。
コマンド
| コマンド | 内容 |
|---|---|
orc creative image | 画像モデルの確認と画像生成 |
orc creative video | 動画モデルの確認と動画生成 |
orc creative tts | 音声合成のモデルと声の確認、音声生成 |
orc creative voice | 音声や動画の声の変換 |
orc creative jobs | ジョブの状態、成果物、履歴の確認と取り消し |
orc creative files | 入力ファイルのアップロード先の発行 |
orc creative webhooks | Webhook の署名シークレットの取得と更新 |
すべてのコマンドで --json や --workspace などのグローバルオプションを使えます。
モデル
使えるモデルと単価は Workspace によって変わります。生成の前に models list で確認してください。
terminal
orc creative image models list
orc creative video models list
orc creative tts models listモデルごとの入力パラメータと料金の形状はモデルにまとまっています。