Hidream I1 Dev

Hidream I1 Dev

Playground

HiDream-I1 is an open-source, 17B-parameter image generative foundation model that delivers state-of-the-art image quality in seconds. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

HiDream I1 Dev is a fast, cost-efficient text-to-image model for generating high-quality images from prompts. It’s well-suited for concept art, marketing creatives, mascots, and prompt-driven typography-in-image needs (e.g., short words on signs or objects). You can specify exact output dimensions, set a seed for reproducibility, and choose the output format for easy downstream use.

Key capabilities

• Text-to-image generation from a single prompt
• Good for stylized characters, product concepts, and marketing visuals
• Supports prompt-specified text rendering inside the image (best for short phrases)
• Custom output size (set width/height directly)
• Seed control for reproducible generations
• URL output or BASE64 output (API only)

Use cases

• Mascot and character creation (e.g., branded animals, sticker-style art)
• Social creatives and ad variations from one prompt
• Concept exploration (composition, props, outfits, themes)
• Quick brand mockups (logos/words on props, posters, boards)
• Batch generation with consistent framing via fixed seed + size

Pricing

Parameters

• prompt (required): what to generate (subject + scene + style + any visible text)
• width / height: output size (e.g., 1024×1024)
• seed: random seed (-1 for random; set for reproducible results)
• output_format: output format (e.g., jpeg)
• enable_base64_output: return BASE64 instead of URL (API only)

Prompting guide

For images that include readable text, keep the on-image text short and unambiguous, and specify where it appears.

Template: Subject + action + setting + style. Include the text “…” on [object] in [color/material], clearly readable.

Example prompts

• A cat wearing sunglasses holding a skateboard. The skateboard has the word “HiDream” written in red spray paint, clearly readable. Street photography style, high detail, strong contrast, 1024×1024.
• A clean product poster: a glossy sneaker on a studio background, with “HiDream” as small text on the shoe tag, minimalist design, soft shadows, crisp lighting.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result

set -euo pipefail

export WAVESPEED_API_KEY="your-api-key"

REQUEST_BODY=$(cat <<'JSON'
{
  "prompt": "A cinematic ocean wave at sunrise, highly detailed",
  "size": "1024*1024",
  "seed": -1,
  "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-i1-dev" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}")

TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; 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 type == "object" and has("data") then .data else . end')
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  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

Parameters

Task Submission Parameters

Request Parameters

Response Parameters

Result Request Parameters

Result Response Parameters