クリエイティブ
Beta

creative_generate_image

接続先のワークスペースで画像生成ジョブを開始します。

操作: 書き込み。読み取りと書き込みを許可する OAuth の認可が必要です。

パラメーター

パラメーター型必須説明
bodyobject必須画像生成の入力。
body.modelstring必須creative_image_models_list が返したモデル ID。
body.promptstring必須作成する画像、または編集する内容。
body.modestring任意すぐにジョブを受け取る場合は、既定の async を使います。
body.image_urlsarray of strings任意対応モデルで使う参照画像の公開 HTTPS URL。
body.aspect_ratiostring任意モデルが対応する出力の縦横比。
idempotency_keystring必須操作ごとに一意のキーを指定します。同じ入力で再試行する際は同じキーを使います。
approval_receiptstring任意計画とともに返る確認用の値。利用者が承認した後に指定します。

生成は外部プロバイダーを呼び出し、クリエイティブクレジットを消費する場合があります。最初の呼び出しは計画を返します。承認後に approval_receipt を添えて同じ入力を送信してください。data.job.id を保存し、creative_jobs_wait に渡します。同じキーと入力で再試行すると、同じジョブが返ります。creative_image_models_get でモデルの料金と対応入力を確認できます。

依頼例

白い背景に青い陶器の花瓶を置いた正方形の画像を 1 枚生成してください。