Krea 2 Medium Text to Image API

WaveSpeed AI Krea V2 Medium Text-to-Image

WaveSpeed AI Krea V2 Medium Text-to-Image generates high-quality images from natural-language prompts, with optional reference images for stronger style guidance. It is designed for prompt-based image generation workflows where you want flexible aspect ratios, controllable creativity, and the option to steer the final look with one or more visual references.

Why Choose This?

High-quality text-to-image generation
Create polished images from detailed natural-language prompts.
Reference-guided style control
Add up to 10 reference images to guide the visual style of the generated result.
Flexible aspect ratios
Choose from multiple preset aspect ratios for square, portrait, landscape, or cinematic compositions.
Creativity control
Adjust how loosely the model interprets the prompt with raw, low, medium, or high.
Multi-reference support
Use multiple references with individual strength values for more nuanced style influence.
Production-ready workflow
Suitable for concept art, marketing visuals, brand creatives, editorial imagery, and visual ideation.

Parameters

Parameter	Required	Description
prompt	Yes	Text description of the image to generate. Supports `1–5000` characters.
aspect_ratio	No	Output aspect ratio. Supported values: `1:1`, `4:3`, `3:2`, `16:9`, `2.35:1`, `4:5`, `2:3`, `9:16`. Default: `1:1`.
creativity	No	Controls how loosely the model interprets the prompt. Supported values: `raw`, `low`, `medium`, `high`. Default: `medium`.
reference	No	Optional reference images that guide the style of the generated image. Supports up to `10` items.

Reference Format

Each item in the reference array supports:

Field	Required	Description
image_url	Yes	Reference image URL.
strength	No	How strongly the reference image influences the generated image. Range: `-2` to `2`. Default: `1`.

How to Use

Write your prompt — describe the subject, style, lighting, composition, and mood you want.
Choose aspect ratio (optional) — select the format that best fits your target use case.
Set creativity (optional) — use raw or low for tighter prompt control, or medium / high for looser interpretation.
Add reference images (optional) — upload one or more images if you want stronger style guidance.
Adjust reference strength (optional) — tune each reference image’s influence individually.
Submit — run the model and download the generated image.

Example Prompt

A premium editorial portrait of a woman in soft window light, natural skin texture, elegant neutral wardrobe, cinematic depth of field, refined luxury-magazine styling

Pricing

Pricing is based on whether you use reference images.

Mode	Cost
Without reference images	$0.03
With one or more reference images	$0.035

Billing Rules

Base price is $0.03 per image
Adding reference images adds $0.005 to the request
The number of reference images does not change the surcharge beyond that single addition
aspect_ratio and creativity do not affect pricing
Each request returns one generated image

Best Use Cases

Prompt-based concept generation — Explore visual directions from text prompts alone.
Style-guided image creation — Use reference images to steer the output toward a desired aesthetic.
Editorial and fashion visuals — Build polished, art-directed imagery with better style control.
Brand creative development — Keep generated visuals closer to an existing visual language.
Marketing and campaign ideation — Generate premium-looking assets for pitches, mockups, and content planning.

Pro Tips

Use raw or low creativity when you want stricter prompt fidelity.
Use medium or high when you want more interpretive or stylized output.
Add reference images only when you want style guidance, since they increase the price slightly.
Start with a single strong reference before stacking multiple references.
Adjust strength carefully when combining several references, especially if their styles differ.
Be specific in your prompt about subject, lighting, composition, and mood for more controllable results.

Notes

prompt is required.
reference is optional and supports up to 10 images.
Each reference image can use a strength value from -2 to 2.
creativity defaults to medium.
aspect_ratio defaults to 1:1.
Pricing is fixed per request, with a small surcharge when reference images are used.

Related Models

WaveSpeed AI Krea V2 Large Text-to-Image — Higher-tier Krea text-to-image workflow with the same reference-guided structure.
WaveSpeed AI FLUX.2 Klein Base 9B Text-to-Image — Generate images from prompts with a simpler parameter set.
WaveSpeed AI FLUX.2 Klein Base 9B Text-to-Image LoRA — Generate images from prompts with custom LoRA support.

Krea v2 Medium Text To Image API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/wavespeed-ai/krea-v2-medium/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 Krea v2 Medium Text To Image below.

HTTP example

# Submit the prediction
curl -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/krea-v2-medium/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",
    "aspect_ratio": "1:1",
    "creativity": "medium"
}'

# 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("wavespeed-ai/krea-v2-medium/text-to-image", {
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "aspect_ratio": "1:1",
        "creativity": "medium"
});

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

Python example

# pip install wavespeed
import wavespeed

output = wavespeed.run(
    "wavespeed-ai/krea-v2-medium/text-to-image",
    {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "aspect_ratio": "1:1",
    "creativity": "medium"
}
)

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

Krea v2 Medium Text To Image API — Frequently asked questions

What is the Krea v2 Medium Text To Image API?

Krea v2 Medium Text To Image is a WaveSpeedAI model for image generation, exposed as a REST API on WaveSpeedAI. Krea 2 Medium Text to Image is a fast AI image generation model that creates high-quality images from text prompts with aspect ratio, creativity, and optional style reference controls. Ready-to-use REST inference API for creative design, marketing visuals, product mockups, brand assets, social media content, rapid ideation, 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 Krea v2 Medium 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/wavespeed-ai/krea-v2-medium-text-to-image.

How much does Krea v2 Medium Text To Image cost per run?

Krea v2 Medium Text To Image starts at $0.030 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 Krea v2 Medium Text To Image accept?

Key inputs: `prompt`, `aspect_ratio`, `creativity`, `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/wavespeed-ai/krea-v2-medium-text-to-image.

How do I get started with the Krea v2 Medium 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 Krea v2 Medium Text To Image outputs commercially?

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

ExamplesView all

Related Models

README

WaveSpeed AI Krea V2 Medium Text-to-Image

Why Choose This?

Parameters

Reference Format

How to Use

Example Prompt

Pricing

Billing Rules

Best Use Cases

Pro Tips

Notes

Related Models

Krea v2 Medium Text To Image API — Quick start

Krea v2 Medium Text To Image API — Frequently asked questions