Generate Image

For background removal/replacement, restoration, upscaling, masked edits, or format conversion, use edit-image. Continue here for prompt/reference-guided generation.

Create or edit an image with Simplified and retain an asset ID when the result will be reused. Use the current generation tool schema as the request contract; model catalogs describe availability and limits, not a reason to substitute provider-specific field names.

Workflow

1. Resolve workspace/teamspace scope when needed using simplified-workspace. Carry its space_id into related calls.
2. Resolve existing references with manage-assets: search names/tags with api_listAssets if available, or use supplied IDs/URLs. Check asset readiness with api_getAsset before generating.
3. Select a compatible model from api_listImageModels, or api_getModelFields(type: "image") if that is the discovery tool exposed in this client. Inspect api_getImageModelFields or the available model-fields tool for limits/options when the request requires a particular resolution, quality, reference count, or provider. Honor explicit model choices when supported. Model IDs and credit costs can change; do not guess them.
4. Build the nested request below. Use storage: "asset" for reusable outputs; use transient only for an explicitly temporary result. The current schema recommends/defaults to asset storage; pass the choice explicitly.
5. Call api_generateImage when the user requests generation. Generation spends credits: clarify once when cost, quantity, or intent is ambiguous. Do not add a confirmation when the user already authorized that generation.
6. Wait for the tool's response, inspect its actual status, and report the result. Current apikit waits for completion; do not start a second job or manually poll while the call is still active.

Current request contract