Skip to main content
Generate product photos, marketing visuals, and design concepts by describing what you want. Attach reference images for more control. All results are saved to your Pixelcut workspace.

​
Text-to-image

Use the generate_media tool with a prompt and model ID. Call models (action: list) first to find available model IDs:
The agent calls models to find a model, then generate_media with the chosen model ID and prompt.

​
Reference-based generation

Pass image URLs or asset IDs in the attachments parameter of generate_media. The model uses the attachment as a visual reference while composing the new scene:

​
Generation parameters

The generate_media tool accepts:

​
Browsing models

The models tool supports list, search, get, and recommend actions. Use recommend with a natural language description of your use case to get ranked suggestions:

​
Batch generation

Generate multiple variations in a single call by setting num_variations:
To produce the same concept across different aspect ratios, ask for separate runs:

​
Prompt engineering tips

Write prompts as if briefing a photographer: subject first, then environment, lighting, and mood.
When passing a brand_library_id, the model pulls brand colors, fonts, and style references automatically. Combine this with a descriptive prompt for brand-consistent output.