Seedance 2.5 Now Live | Try in Video Generator →

wavespeed-ai/

HiDream-O1-Image is a unified, native image-generation model that produces high-resolution images up to 2K from a single text prompt — no external components required. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

text-to-image
Input

Idle

A luxury beauty portrait of an elegant young woman, flawless glowing skin, subtle natural makeup, holding a premium skincare bottle near her face, clean beige background, soft studio lighting, high-end commercial advertising style, close-up shot, refined composition, glossy skin texture, photorealistic, ultra-detailed, beauty campaign aesthetic

$0.04per run·~25 / $1

Next:

ExamplesView all

A luxury beauty portrait of an elegant young woman, flawless glowing skin, subtle natural makeup, holding a premium skincare bottle near her face, clean beige background, soft studio lighting, high-end commercial advertising style, close-up shot, refined composition, glossy skin texture, photorealistic, ultra-detailed, beauty campaign aesthetic

A luxury beauty portrait of an elegant young woman, flawless glowing skin, subtle natural makeup, holding a premium skincare bottle near her face, clean beige background, soft studio lighting, high-end commercial advertising style, close-up shot, refined composition, glossy skin texture, photorealistic, ultra-detailed, beauty campaign aesthetic

A warm lifestyle commercial portrait of a young woman holding a cup of coffee, relaxed natural smile, modern cafe environment, soft morning light, clean and cozy brand aesthetic, candid yet polished composition, photorealistic, highly detailed, premium lifestyle advertising style

A warm lifestyle commercial portrait of a young woman holding a cup of coffee, relaxed natural smile, modern cafe environment, soft morning light, clean and cozy brand aesthetic, candid yet polished composition, photorealistic, highly detailed, premium lifestyle advertising style

Related Models

README

HiDream-O1-Image (Text-to-Image)

HiDream-O1-Image is a unified, next-generation image-generation model. A single native model handles text-to-image, image editing, and subject-driven personalization — no external adapters, controllers, or pipelines required. The text-to-image endpoint produces sharp, detailed visuals at resolutions up to roughly 2K (2048×2048) straight from a text prompt.

Why Choose This?

  • Unified native model — One model, multiple modes (text-to-image / edit / personalization). No swapping or chaining required.
  • High-resolution output — Generate detailed images up to ~2048×2048 with strong composition and natural lighting.
  • Strong prompt adherence — Faithfully follows complex, multi-clause descriptions including style, mood, and on-image text.
  • Flexible aspect ratios — Supply any custom width/height up to the supported maximum (the model snaps to the closest supported resolution).
  • Multiple output formats — JPEG, PNG, or WEBP to match downstream pipelines.
  • Reproducibility — Use a fixed seed to recreate exact results.

Parameters

ParameterRequiredDescription
promptYesText description of the image you want to generate.
sizeNoOutput image size as WIDTH*HEIGHT (default: 2048*2048). The model snaps to the closest supported resolution.
output_formatNoOutput format: jpeg, png, or webp (default: jpeg).
seedNoRandom seed for reproducible generation.
enable_sync_modeNoAPI only — wait for the result and return it inline.
enable_base64_outputNoAPI only — return the image as a base64 string instead of a URL.

How to Use

  1. Write your prompt — describe subject, style, lighting, mood, and any on-image text.
  2. Choose size — pick an aspect ratio that fits your use case (e.g., 2048*2048 for square, 1536*2048 for portrait, 2048*1152 for landscape).
  3. Set output_format — JPEG for compact files, PNG for lossless, WEBP for balance.
  4. Set seed (optional) — pin a number to reproduce exact results.
  5. Run — submit the request and download the generated image.

Pricing

Flat rate per generated image.

OutputCost
Per image$0.04

Best Use Cases

  • Concept Art & Illustration — Translate text descriptions into detailed visual concepts.
  • Marketing & Social Media — Produce eye-catching visuals for posts, ads, and campaigns.
  • Product Visualization — Mock up product concepts and lifestyle imagery without a photo shoot.
  • Storyboarding — Quickly visualize scenes and characters for creative projects.
  • Editorial / Posters — Generate poster-grade images at high resolution.

Pro Tips

  • Be specific about subject, style, lighting, and composition — HiDream-O1 follows detailed prompts well.
  • For posters or banners, describe layout and any on-image text explicitly.
  • Pin a seed while iterating so you can A/B test prompt tweaks against a fixed baseline.
  • Match size to your final use case (square for thumbnails, 16:9 for banners, 9:16 for mobile).
  • Use png when you need lossless quality; use jpeg or webp to keep file sizes small.

Notes

  • Only prompt is required — every other field is optional.
  • Higher resolutions may slightly increase processing time.
  • Ensure prompts comply with content guidelines.

Related Models

Note:This website uses AI models provided by third parties. Documentation prices are for reference and may be outdated. The Generate button shows an estimate; the final task charge prevails.

Hidream O1 Image Text To Image API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/wavespeed-ai/hidream-o1-image/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 output values from data.outputs. Examples for Hidream O1 Image Text To Image below.

HTTP example
set -euo pipefail

: "${WAVESPEED_API_KEY:?Set WAVESPEED_API_KEY}"

REQUEST_BODY=$(cat <<'JSON'
{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "size": "2048*2048",
    "output_format": "jpeg"
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/hidream-o1-image/text-to-image" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d "$REQUEST_BODY")

TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL=$(printf '%s' "$TASK" | jq -r '.urls.get // empty')
if [ -z "$RESULT_URL" ]; then
  RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
fi

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
    -H "Authorization: Bearer $WAVESPEED_API_KEY")
  RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
  STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
  case "$STATUS" in
    completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
    failed|cancelled|timeout) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
    created|processing) sleep 2 ;;
    *) printf 'Unexpected status: %s
' "$STATUS" >&2; exit 1 ;;
  esac
done
Node.js example
const submitUrl = "https://api.wavespeed.ai/api/v3/wavespeed-ai/hidream-o1-image/text-to-image";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');

async function requestJson(url, options = {}) {
  const response = await fetch(url, options);
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "size": "2048*2048",
        "output_format": "jpeg"
}),
});
const task = body.data ?? body;
if (!task.id) throw new Error("Submission response did not contain a prediction id");
const resultUrl = task.urls?.get ||
  `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;

// 2. Poll until the prediction finishes.
while (true) {
  const resultBody = await requestJson(resultUrl, {
    headers: { "Authorization": `Bearer ${apiKey}` },
  });
  const result = resultBody.data ?? resultBody;
  if (result.status === "completed") {
    console.log(result.outputs);
    break;
  }
  if (["failed", "cancelled", "timeout"].includes(result.status)) throw new Error(JSON.stringify(result));
  if (!["created", "processing"].includes(result.status)) throw new Error("Unexpected status: " + result.status);
  await new Promise(resolve => setTimeout(resolve, 2000));
}
Python example
import json
import os
import time
from urllib.request import Request, urlopen

api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "size": "2048*2048",
    "output_format": "jpeg"
}

def request_json(url, data=None):
    request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
    with urlopen(request) as response:
        return json.load(response)

# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/wavespeed-ai/hidream-o1-image/text-to-image", json.dumps(payload).encode())
task = body.get("data", body)
if not task.get("id"):
    raise RuntimeError("Submission response did not contain a prediction id")
result_url = task.get("urls", {}).get("get") or f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"

# 2. Poll until the prediction finishes.
while True:
    result_body = request_json(result_url)
    result = result_body.get("data", result_body)
    status = result.get("status")
    if status == "completed":
        print(result.get("outputs", []))
        break
    if status in {"failed", "cancelled", "timeout"}:
        raise RuntimeError(result)
    if status not in {"created", "processing"}:
        raise RuntimeError(f"Unexpected status: {status}")
    time.sleep(2)

Hidream O1 Image Text To Image API — Frequently asked questions

What is the Hidream O1 Image Text To Image API?

Hidream O1 Image Text To Image is a WaveSpeedAI model for image generation, exposed as a REST API on WaveSpeedAI. HiDream-O1-Image is a unified, native image-generation model that produces high-resolution images up to 2K from a single text prompt — no external components required. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Hidream O1 Image 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/wavespeed-ai/hidream-o1-image-text-to-image.

How much does Hidream O1 Image Text To Image cost per run?

Hidream O1 Image Text To Image starts at $0.040 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 Hidream O1 Image Text To Image accept?

Key inputs: `prompt`, `size`, `enable_base64_output`, `enable_sync_mode`, `output_format`. 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/hidream-o1-image-text-to-image.

How long does Hidream O1 Image Text To Image take to generate?

Median end-to-end generation time on WaveSpeedAI is around 53 seconds per request, based on recent successful runs. Queue time varies with global demand; live status is visible in the prediction record.

Can I use Hidream O1 Image 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.