CLI

creative image

orc creative image は、画像モデルの一覧と詳細を返し、画像生成ジョブを作成します。生成は非同期です。image generate は job.id を返し、--wait を付けると完了まで待って成果物を表示します。

使えるモデル ID と入力は image models list で確認します。モデルごとの入力と料金の形状はモデルにまとまっています。

使い方

terminal
orc creative image generate --model gpt-image-2 --prompt "白い背景の赤い立方体" --wait --json

画像を生成し、完了まで待って成果物を表示します。

サブコマンド

models list

画像モデルを一覧表示

terminal
orc creative image models list [options]

models get

画像モデルを取得

terminal
orc creative image models get <model-id> [options]

generate

画像を生成

terminal
orc creative image generate [options]

固有のオプション

--idempotency-key

同じ入力の再送で同じジョブを返すキー。1〜255 文字の印字可能 ASCII。同じキーで異なる入力を送ると 409 です。

型: string。任意。

terminal
orc creative image generate --idempotency-key <value>
--model

(required) カタログに掲載されたモデル ID を指定します。利用可能な入力と料金は、呼び出すワークスペースのカタログ行で確認してください。; enum: higgsfield-soul|soul-2.0|gpt-image-2.5|gpt-image-2.5-sunburst|gpt-image-2.6|gpt-image-2.6-sunburst|gpt-image-2|nano-banana-2.1|nano-banana-2-lite|nano-banana-2|ideogram-vector|ideogram-4-5-precise-edit|seedream-5.5|minimax-h3-image|flux-3-image|gpt-image-1.5|nano-banana-pro|seedream-5-lite|seedream-4-5-edit|grok-image|seedream-v4|flux-2-pro|flux-2-flex|ideogram-v3|recraft-v4|qwen-image-layered|qwen-image-angles|ideogram-v4.5|nano-banana|flux-kontext-max|wan-2.2|recraft-v4.1|seedream-5-flash|z-image|flux-2-max|kling-image-o1|kling-image-3-omni|seedream-5-pro|higgsfield-soul-standard|higgsfield-soul-cinema|grok-imagine-2|recraft-v4.1-utility|kling-image-3|higgsfield-ai-influencer|higgsfield-ads-studio

型: string。任意。

terminal
orc creative image generate --model <value>
--prompt

(required) 生成する内容、または編集で変更したい内容を記述する文章。

型: string。任意。

terminal
orc creative image generate --prompt <value>
--character-element-id

Soul 2 で使用する、このワークスペースの学習済みキャラクター要素の ID。

型: string。任意。

terminal
orc creative image generate --character-element-id <value>
--image-urls

編集や参照に使う画像の HTTPS URL。入力は認証なしで取得できる必要があります。; csv

型: string。任意。

terminal
orc creative image generate --image-urls <value>
--mask-url

編集する領域を指定するマスク画像の HTTPS URL。対応モデルで使用します。

型: string。任意。

terminal
orc creative image generate --mask-url <value>
--aspect-ratio

出力の幅と高さの比。auto は入力画像に合わせます。モデルの対応値を確認してください。; enum: auto|1:1|16:9|9:16|4:3|3:4|3:2|2:3|4:5|5:4|9:8|1:2|2:1|1:3|3:1|1:4|4:1|1:8|8:1|9:21|21:9|10:16|16:10|20:9|19.5:9|9:19.5|9:20|6:10|14:10|10:14

型: string。任意。

terminal
orc creative image generate --aspect-ratio <value>
--image-size

プリセット、WIDTHxHEIGHT、または width と height のオブジェクト。aspect_ratio より優先されます。

型: string。任意。

terminal
orc creative image generate --image-size <value>
--quality

モデルが受け付ける生成品質。対応する値はカタログで確認します。

型: string。任意。

terminal
orc creative image generate --quality <value>
--resolution

出力の解像度。モデルが対応する値をカタログで確認します。; enum: 0.5K|1K|2K|4K|720p|1080p

型: string。任意。

terminal
orc creative image generate --resolution <value>
--num-images

一つのジョブで生成する画像数。共通スキーマの範囲内でもモデル固有の上限が適用されます。

型: number。任意。

terminal
orc creative image generate --num-images <value>
--output-format

成果物のファイル形式。対応する値はモデルによって異なります。; enum: png|jpeg|jpg|webp|gif|svg

型: string。任意。

terminal
orc creative image generate --output-format <value>
--metadata

利用者の追跡用データ。ジョブと関連付けて保存し、モデルには送りません。; (JSON object, e.g. '{"custom_id":"x"}')

型: string。任意。

terminal
orc creative image generate --metadata <value>
--mode

async は即時応答、webhook は終端通知、sync と subscribe は時間を区切って完了を待ちます。; enum: async|sync|subscribe|webhook

型: string。任意。

terminal
orc creative image generate --mode <value>
--webhook-url

終端イベントを受け取る公開 HTTPS URL(2048 文字以内、既定のポート)。async または webhook モードで指定し、sync とは併用できません。localhost、プライベート、ループバック、リンクローカルのアドレス宛ては指定できません。ジョブが完了、失敗、取消のいずれかになると、ワークスペースの署名シークレットで署名した通知を 1 件送ります。; max 2048 chars

型: string。任意。

terminal
orc creative image generate --webhook-url <value>
--wait-timeout-seconds

HTTP 応答を待つ秒数。0〜30。時間を過ぎてもジョブは継続します。

型: number。任意。

terminal
orc creative image generate --wait-timeout-seconds <value>
--project-id

ジョブまたは配置先を関連付けるプロジェクトの ID。; max 200 chars

型: string。任意。

terminal
orc creative image generate --project-id <value>
--model-params

モデル固有設定。通常は省略または空オブジェクト。higgsfield-ai-influencer は tier(normal、freak、total)と selection(グループ ID から最大 4 個の選択 ID への対応)を指定できます。; (JSON object, e.g. '{"custom_id":"x"}')

型: string。任意。

terminal
orc creative image generate --model-params <value>
--background

GPT Image 2.5 系の背景指定。auto、transparent、opaque。対応モデルだけに指定します。; enum: auto|transparent|opaque

型: string。任意。

terminal
orc creative image generate --background <value>
--rendering-speed

生成速度と品質の配分。TURBO、BALANCED、QUALITY から対応モデルの値を選びます。; enum: TURBO|BALANCED|QUALITY

型: string。任意。

terminal
orc creative image generate --rendering-speed <value>
--complexity

描画前の計画量。low、medium、high。GPT Image 2.6 系で使用し、既定は high です。quality とは別の設定です。; enum: low|medium|high

型: string。任意。

terminal
orc creative image generate --complexity <value>
--frame-count

GIF のフレーム数。GPT Image 2.6 の GIF 出力で 2〜16、既定は 9。image_size は各フレームのサイズです。

型: number。任意。

terminal
orc creative image generate --frame-count <value>
--frame-duration-ms

GIF の 1 フレームの表示時間。20〜2,000 ミリ秒を 10 ミリ秒単位に丸めます。既定は 200。

型: number。任意。

terminal
orc creative image generate --frame-duration-ms <value>

使用例

利用できる画像モデルを一覧します。

terminal
orc creative image models list --json

利用できる画像モデルを一覧します。

1 つのモデルの対応入力と料金を確認します。

terminal
orc creative image models get gpt-image-2 --json

1 つのモデルの対応入力と料金を確認します。

参照画像を使って生成します。

terminal
orc creative image generate --model gpt-image-2 --prompt "同じ構図で夕方の光に" --image-urls https://example.com/input.png --wait

参照画像を使って生成します。

同じ入力を安全に再送します。

terminal
orc creative image generate --model gpt-image-2 --prompt "白い背景の赤い立方体" --idempotency-key render-001

同じ入力を安全に再送します。

必要な権限

CLI の認証(orc auth login または ORCHESTOR_API_KEY)と、対象 Workspace へのアクセスが必要です。 ジョブの作成には書き込み権限が必要です。

グローバルオプション

orc creative image では、次のグローバルオプションを使用できます。

各オプションの詳細と使用例は、グローバルオプションを参照してください。