Creative Generation
画像を生成
model でモデルを指定します。async と webhook は即座にジョブを返し、sync と subscribe は最大 30 秒待機します。次のポーリングまで next_poll_after_seconds 秒待ちます。同じ Idempotency-Key と入力の再送は同じジョブを返し、異なる入力は 409 になります。
POST
/v1/creative/image-router/generate
curl --request POST 'https://api.orchestor.io/v1/creative/image-router/generate' \ --header "Authorization: Bearer $ORCHESTOR_API_KEY" \ --header 'Content-Type: application/json' \ --header 'Idempotency-Key: 9816bc88-9791-43a1-86c2-876dc7c544e8' \ --data-raw '{"model": "gpt-image-2", "prompt": "白い背景の上に置いた青い陶器の花瓶", "aspect_ratio": "1:1", "mode": "async"}'{ "data": { "request_id": "job_7513b52d-3669-4ffe-b317-8b02000715eb", "job": { "id": "job_7513b52d-3669-4ffe-b317-8b02000715eb", "type": "image_generation", "status": "queued", "model": "gpt-image-2", "idempotency_key": "9816bc88-9791-43a1-86c2-876dc7c544e8", "communication_mode": "async", "created_at": "2026-11-06T00:00:00Z", "updated_at": "2026-11-06T00:00:00Z", "started_at": null, "completed_at": null, "canceled_at": null, "result": null, "error": null, "usage_summary": null, "webhook_delivery": null, "input": { "model": "gpt-image-2", "prompt": "白い背景の上に置いた青い陶器の花瓶", "aspect_ratio": "1:1", "mode": "async" } }, "status_url": "https://api.orchestor.io/v1/creative/jobs/job_7513b52d-3669-4ffe-b317-8b02000715eb/status", "result_url": "https://api.orchestor.io/v1/creative/jobs/job_7513b52d-3669-4ffe-b317-8b02000715eb/result", "events_url": "https://api.orchestor.io/v1/creative/jobs/job_7513b52d-3669-4ffe-b317-8b02000715eb/events", "cancel_url": "https://api.orchestor.io/v1/creative/jobs/job_7513b52d-3669-4ffe-b317-8b02000715eb/cancel", "cancelable": true, "next_action": "poll_status", "next_poll_after_seconds": 2, "recommended_poll_interval_seconds": 2, "retry_after_seconds": null, "result_ready": false, "terminal": false, "idempotency_hit": false, "usage": { "credits": 5, "usd": "0.05" }, "generation_limits": null }}Authorizations
Authentication details
bearer
Headers
Bodyapplication/jsonrequired
以下の入力を JSON で送信します。モデル固有の項目はカタログの対応条件も確認してください。
{ "model": "gpt-image-2", "prompt": "白い背景の上に置いた青い陶器の花瓶", "aspect_ratio": "1:1", "mode": "async"}- Additional properties
- Not allowed
カタログに掲載されたモデル ID を指定します。利用可能な入力と料金は、呼び出すワークスペースのカタログ行で確認してください。
Allowed
higgsfield-soulsoul-2.0gpt-image-2.5gpt-image-2.5-sunburstgpt-image-2.6gpt-image-2.6-sunburstgpt-image-2nano-banana-2.1nano-banana-2-litenano-banana-2ideogram-vectorideogram-4-5-precise-editseedream-5.5minimax-h3-imageflux-3-imagegpt-image-1.5nano-banana-proseedream-5-liteseedream-4-5-editgrok-imageseedream-v4flux-2-proflux-2-flexideogram-v3recraft-v4qwen-image-layeredqwen-image-anglesideogram-v4.5nano-bananaflux-kontext-maxwan-2.2recraft-v4.1seedream-5-flashz-imageflux-2-maxkling-image-o1kling-image-3-omniseedream-5-prohiggsfield-soul-standardhiggsfield-soul-cinemagrok-imagine-2recraft-v4.1-utilitykling-image-3higgsfield-ai-influencerhiggsfield-ads-studioResponse
application/json
生成の受付結果。job.id を保存し、result_ready が false の場合は status_url を指定間隔で取得してください。
Headers
{ "data": { "request_id": "job_7513b52d-3669-4ffe-b317-8b02000715eb", "job": { "id": "job_7513b52d-3669-4ffe-b317-8b02000715eb", "type": "image_generation", "status": "queued", "model": "gpt-image-2", "idempotency_key": "9816bc88-9791-43a1-86c2-876dc7c544e8", "communication_mode": "async", "created_at": "2026-11-06T00:00:00Z", "updated_at": "2026-11-06T00:00:00Z", "started_at": null, "completed_at": null, "canceled_at": null, "result": null, "error": null, "usage_summary": null, "webhook_delivery": null, "input": { "model": "gpt-image-2", "prompt": "白い背景の上に置いた青い陶器の花瓶", "aspect_ratio": "1:1", "mode": "async" } }, "status_url": "https://api.orchestor.io/v1/creative/jobs/job_7513b52d-3669-4ffe-b317-8b02000715eb/status", "result_url": "https://api.orchestor.io/v1/creative/jobs/job_7513b52d-3669-4ffe-b317-8b02000715eb/result", "events_url": "https://api.orchestor.io/v1/creative/jobs/job_7513b52d-3669-4ffe-b317-8b02000715eb/events", "cancel_url": "https://api.orchestor.io/v1/creative/jobs/job_7513b52d-3669-4ffe-b317-8b02000715eb/cancel", "cancelable": true, "next_action": "poll_status", "next_poll_after_seconds": 2, "recommended_poll_interval_seconds": 2, "retry_after_seconds": null, "result_ready": false, "terminal": false, "idempotency_hit": false, "usage": { "credits": 5, "usd": "0.05" }, "generation_limits": null }}