Browse ModelsWavespeed AINucleus Image Text To Image

Nucleus Image Text To Image

Nucleus Image Text To Image

Playground

Try it on WavespeedAI!

Nucleus Image generates high-quality images from text prompts with flexible aspect ratios, adjustable inference steps, and classifier-free guidance. Supports negative prompts, reproducible seeds, and multiple output formats. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Nucleus Image Text-to-Image

Nucleus Image Text-to-Image generates high-quality images from text prompts with precise control over inference steps, guidance scale, and aspect ratio. An affordable, flexible text-to-image model built for creative and production workflows.


Why Choose This?

  • Fine-grained generation control Adjust inference steps (1–100) and guidance scale (0–20) to tune the balance between creativity and prompt adherence.

  • Negative prompt support Specify what to exclude from the output for more precise control over the result.

  • Multiple aspect ratio presets Choose from 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, or 2:3 to match any platform or format.

  • Batch generation Generate up to 2 images per run for quick side-by-side comparison.

  • Reproducible results Use the seed parameter to lock in a specific output for consistent iteration.

  • Output format choice Export in PNG or JPEG based on your delivery requirements.


Parameters

ParameterRequiredDescription
promptYesText description of the image subject, style, and mood.
negative_promptNoElements to exclude from the generated image.
aspect_ratioNoOutput aspect ratio. Options: 1:1 (default), 16:9, 9:16, 4:3, 3:4, 3:2, 2:3.
num_imagesNoNumber of images to generate per run: 1 (default) or 2.
num_inference_stepsNoNumber of inference steps. Range: 1–100. Default: 50.
guidance_scaleNoClassifier-free guidance scale. Range: 0–20. Default: 8.
output_formatNoOutput file format: png (default) or jpeg.
seedNoRandom seed for reproducible results.

How to Use

  1. Write your prompt — describe the subject, scene, style, lighting, and mood.
  2. Add negative prompt (optional) — specify elements you want to exclude.
  3. Select aspect ratio — choose the format that fits your target platform.
  4. Set num_images (optional) — generate 1 or 2 images per run.
  5. Adjust inference steps and guidance scale (optional) — higher steps for more detail, higher guidance for stricter prompt adherence.
  6. Choose output format — png for lossless, jpeg for smaller file size.
  7. Set seed (optional) — fix the seed to reproduce a specific result.
  8. Submit — generate and download your image.

Pricing

Just $0.01 per image.


Best Use Cases

  • Rapid prototyping — Generate visual concepts quickly at very low cost for iteration and ideation.
  • Social media content — Create platform-optimized images across multiple aspect ratios.
  • High-volume workflows — Affordable per-image pricing makes it ideal for large-scale generation pipelines.
  • Creative exploration — Tune inference steps and guidance scale to explore different visual styles from the same prompt.
  • Developer integrations — Embed flexible, low-cost image generation into any app or workflow.

Pro Tips

  • Higher num_inference_steps (50–100) produces more detailed and refined results; lower values (10–20) are faster for quick drafts.
  • Increase guidance_scale for stricter prompt adherence; lower values allow more creative variation.
  • Use negative_prompt to avoid common artifacts like blurry faces, extra limbs, or unwanted styles.
  • Generate 2 images per run to quickly compare variations before committing to a final render.
  • Fix the seed while adjusting other parameters to isolate the effect of each change.

Notes

  • Only prompt is required; all other parameters are optional.
  • Maximum 2 images per generation run.
  • Please ensure your content complies with WaveSpeed AI’s usage policies.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result


# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/nucleus-image/text-to-image" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "aspect_ratio": "1:1",
    "num_images": 1,
    "num_inference_steps": 50,
    "guidance_scale": 8,
    "output_format": "png",
    "enable_base64_output": false
}'

# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"

Parameters

Task Submission Parameters

Request Parameters

ParameterTypeRequiredDefaultRangeDescription
promptstringYes-The prompt to use for generating the image.
negative_promptstringNo-The negative prompt to use for generation.
aspect_ratiostringNo1:11:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3The output aspect ratio. Nucleus-Image supports a fixed set of aspect-ratio presets.
num_imagesintegerNo11 ~ 2The number of images to generate.
num_inference_stepsintegerNo501 ~ 100The number of inference steps to perform.
guidance_scalenumberNo80.0 ~ 20.0The classifier-free guidance scale.
output_formatstringNopngjpeg, pngThe format of the generated image.
enable_base64_outputbooleanNofalse-If enabled, the output will be encoded into a BASE64 string instead of a URL. This property is only available through the API.
seedintegerNo--1 ~ 2147483647Seed for reproducible generation.

Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayArray of URLs to the generated content (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.has_nsfw_contentsarrayArray of boolean values indicating NSFW detection for each output
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

ParameterTypeRequiredDefaultDescription
idstringYes-Task ID

Result Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
dataobjectThe prediction data object containing all details
data.idstringUnique identifier for the prediction, the ID of the prediction to get
data.modelstringModel ID used for the prediction
data.outputsstringArray of URLs to the generated content (empty when status is not completed).
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds
© 2025 WaveSpeedAI. All rights reserved.