Skip to main content
POST
Enhance a prompt
Enhance a raw user prompt into a detailed, model-friendly prompt using the AI guide that matches the target model and inference type.
  • Set type (v2 dot notation) and model_slug to pick the right guide.
  • For images.edits and videos.animations, also send the source image (URL, data-URI, base64, or file).
  • Synchronous — the enhanced prompt is returned directly in the response body ({ prompt, negative_prompt }).
Required fields: prompt, type, model_slug (plus image for images.edits / videos.animations). The returned negative_prompt is provided for compatibility and is ignored by models that do not support negative prompts (e.g. FLUX.2 Klein).

Accepted type values

images.generations, images.edits, videos.generations, videos.animations, audio.speech, audio.music Only prompt-driven inference types have a booster. Upscaling, background removal, OCR, transcription and embeddings are not supported and are rejected with 422.

Example (image-to-image)

Then send the returned prompt to the matching generation endpoint (e.g. POST /api/v2/images/edits).

Authorizations

Authorization
string
header
required

Sanctum personal access token, sent as Authorization: Bearer <token>. The token is opaque — it carries no claims and no embedded expiry, so do not attempt to decode it. Issue and revoke tokens from your account dashboard.

Body

multipart/form-data
prompt
string
Minimum string length: 3
Example:

"A beautiful landscape with mountains"

negative_prompt
string | null
Minimum string length: 3
Example:

"blurry, low quality"

type
enum<string>

Inference type, v2 dot notation. Only prompt-driven types are boostable.

Available options:
images.generations,
images.edits,
videos.generations,
videos.animations,
audio.speech,
audio.music
Example:

"images.generations"

model_slug
string
Example:

"Flux1schnell"

image
file | null

Reference image. Required for images.edits/videos.animations. Supported formats: JPEG, PNG, BMP, GIF, WebP.

Response

Enhanced prompts returned successfully

prompt
string
negative_prompt
string | null