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. Start polling the result endpoint around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. On completed, read URLs from data.outputs. Examples for Uni v1 Text To Image below.

HTTP example

# Submit the prediction
curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -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"
}'

# Wait at least 2 seconds, then poll. Safe GET requests may be retried.
curl --fail-with-body --connect-timeout 10 --max-time 30 \
  --retry 4 --retry-all-errors --retry-delay 1 \
  -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# Start at 2 seconds and increase the interval for long-running tasks.
# Stop on completed, failed, cancelled, or timeout.

Node.js example

// npm install wavespeed
const { Client } = require('wavespeed');

const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
const client = new Client(apiKey);

try {
  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"
}, {
    timeout: 3600,
    pollInterval: 2.0,
  });
  console.log(result.outputs);
} catch (error) {
  console.error('Generation failed:', error);
  process.exitCode = 1;
}

Python example

# pip install wavespeed
import os
from wavespeed import Client

client = Client(api_key=os.environ["WAVESPEED_API_KEY"])

try:
    output = 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"
},
        timeout=3600.0,
        poll_interval=2.0,
    )
    print(output["outputs"])
except Exception as error:
    raise SystemExit(f"Generation failed: {error}") from error

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 result endpoint starting around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. The playground generates production-oriented Python, JavaScript, and cURL examples with timeouts, transient-error handling, and safe GET retries. 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.

ПримерыСмотреть всё

Похожие модели

README