Studio: generate image
studio_generate_imageGenerate a single image via the Studio model catalog (call list_studio_models for keys/pricing). SYNC — the asset URL comes back in the result. SPENDS CREDITS (per-model, see creditCost). Reference images can be passed as URLs (use import_asset_from_url / create_upload first if needed). negativePrompt applies only to models whose capabilities include supportsNegativePrompt (e.g. NOT BytePlus/Seedream); on other models it is ignored, not an error.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"prompt": "<prompt>"
},
"name": "studio_generate_image"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| prompt | Yes | ||
| quality | No | Only on models with supportsImageQuality; the allowed tiers are capabilities.imageQualities (xhigh/max: GPT Image 2.6 only). Credits vary by tier, see pricing.imageCreditsByQuality. | |
| modelKey | No | ||
| aspectRatio | No | ||
| outputFormat | No | Only on models with capabilities.imageOutputFormats; default png | |
| referenceMode | No | ||
| thinkingLevel | No | Reasoning effort, only on models with imageThinkingLevels (P-Image Ideogram; GPT Image 2.6 takes low/medium/high) | |
| negativePrompt | No | Ignored on models without supportsNegativePrompt (see list_studio_models). | |
| imageResolution | No | Output size, only on models with capabilities.imageResolutions. Credits vary by size, see pricing.imageCreditsByResolution. | |
| referenceImages | No | Reference image URLs |