Luma Uni v1 Text to Image API

Luma UNI V1 Text-to-Image

Luma UNI V1 Text-to-Image generates images from natural-language prompts with optional reference-image guidance, flexible aspect ratios, and selectable output formats. It is suitable for concept art, stylized marketing visuals, sci-fi scenes, product ideas, and other prompt-driven image generation workflows.

Why Choose This?

Prompt-based image generation
Turn natural-language descriptions into polished visual outputs.
Optional reference-image guidance
Add one or more reference images when you want stronger visual steering.
Flexible aspect ratios
Choose a size preset that fits square, portrait, or landscape layouts.
Simple workflow
Write a prompt, choose a size, optionally add references, and generate the final image.
Production-ready API
Suitable for creative ideation, social visuals, campaign drafts, and design exploration.

Parameters

Parameter	Required	Description
prompt	Yes	Text description of the image you want to generate.
size	No	Output image size preset, such as `1:1`.
output_format	No	Output image format, such as `jpeg`.
reference	No	Optional reference images for visual guidance.

How to Use

Write your prompt — describe the subject, environment, lighting, composition, and mood you want.
Choose size (optional) — select the aspect ratio that best fits your intended output.
Choose output format (optional) — select the file format that best fits your workflow.
Add references (optional) — upload one or more reference images if you want stronger style or subject guidance.
Submit — run the model and download the generated image.

Example Prompt

A futuristic cyberpunk megacity at night, towering skyscrapers covered with holographic advertisements, flying vehicles, wet streets reflecting neon lights, dense atmosphere, cinematic lighting, ultra detailed, realistic, 35mm photography, high contrast, volumetric fog, 16:9

Pricing

Pricing includes a fixed base image charge plus an extra fee for each reference image.

Mode	Cost
Without reference images	$0.042
With 1 reference image	$0.045
With 2 reference images	$0.048
With 3 reference images	$0.051

Billing Rules

Every request starts with a base price of $0.042 per image
Each added reference image adds $0.003
size and output_format do not affect pricing

Best Use Cases

Concept art — Explore visual directions and scene ideas quickly.
Style-guided generation — Use references when you want the output closer to a target visual language.
Marketing creatives — Generate campaign visuals, social graphics, and concept ads.
Product ideation — Produce stylized product or environment concepts from prompts.
Creative prototyping — Quickly compare prompt-only and reference-guided outputs.

Pro Tips

Use reference images only when you want stronger control, since they increase the price slightly.
Keep prompts specific about subject, lighting, mood, and scene composition.
Use jpeg for lightweight delivery unless your workflow requires a different format.
Start without references first, then add them only if you need extra guidance.
Match the prompt and references in style if you want a more coherent result.

Notes

prompt is required.
Pricing depends on the number of reference images.
The returned result is a generated image.
Better prompts usually improve visual coherence and controllability.

Related Models

Luma image generation workflows — Useful when you need different generation styles or model behavior.
Prompt-based image generation models — Useful when you want alternative quality, cost, or visual tradeoffs.

Uni v1 Text To Image API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/luma/uni-v1/text-to-image with your input as JSON. The endpoint returns a prediction id; poll the prediction endpoint until status flips to completed, then read the output URL from data.outputs[0]. Examples for Uni v1 Text To Image below.

HTTP example

# Submit the prediction
curl -X POST "https://api.wavespeed.ai/api/v3/luma/uni-v1/text-to-image" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "size": "16:9",
    "output_format": "jpeg"
}'

# Response includes a prediction id. Poll for the result:
curl -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# When status is "completed", read the output from data.outputs[0].

Node.js example

// npm install wavespeed
const WaveSpeed = require('wavespeed');

const client = new WaveSpeed(); // reads WAVESPEED_API_KEY from env

const result = await client.run("luma/uni-v1/text-to-image", {
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "size": "16:9",
        "output_format": "jpeg"
});

console.log(result.outputs[0]); // → URL of the generated output

Python example

# pip install wavespeed
import wavespeed

output = wavespeed.run(
    "luma/uni-v1/text-to-image",
    {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "size": "16:9",
    "output_format": "jpeg"
}
)

print(output["outputs"][0])  # → URL of the generated output

Uni v1 Text To Image API — Frequently asked questions

What is the Uni v1 Text To Image API?

Uni v1 Text To Image is a Luma model for image generation, exposed as a REST API on WaveSpeedAI. Luma Uni v1 Text to Image is a fast AI image generation model that creates high-fidelity images from prompts with flexible aspect ratios, visual style control, and optional reference-image guidance. Ready-to-use REST inference API for creative design, marketing visuals, product mockups, brand assets, social media content, concept art, and professional text-to-image workflows with simple integration, no coldstarts, and affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Uni v1 Text To Image API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID; poll the prediction endpoint until status flips to "completed", then read the output URL from the result. The playground generates a ready-to-paste code sample in Python, JavaScript, or cURL for whatever inputs you've set. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/luma/luma-uni-v1-text-to-image.

How much does Uni v1 Text To Image cost per run?

Uni v1 Text To Image starts at $0.042 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Uni v1 Text To Image accept?

Key inputs: `prompt`, `size`, `output_format`, `reference`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/luma/luma-uni-v1-text-to-image.

How do I get started with the Uni v1 Text To Image API?

Sign up for a free WaveSpeedAI account to claim starter credits, copy your API key from /accesskey, then call the endpoint shown in the API tab of the playground. The playground also auto-generates a code sample in Python, JavaScript, or cURL for the parameters you've set.

Can I use Uni v1 Text To Image outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (Luma). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

EsempiVedi tutto

Modelli correlati

README