Hidream I1 Dev
Playground
Try it on WavespeedAI!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 — wavespeed-ai/hidream-i1-dev
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
| Output | Price |
|---|---|
| Per image | $0.012 |
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
# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/hidream-i1-dev" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
"size": "1024*1024",
"seed": -1,
"output_format": "jpeg",
"enable_base64_output": false
}'
# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"
Parameters
Task Submission Parameters
Request Parameters
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| prompt | string | Yes | - | The positive prompt for the generation. | |
| size | string | No | 1024*1024 | 256 ~ 1536 per dimension | The size of the generated media in pixels (width*height). |
| seed | integer | No | -1 | -1 ~ 2147483647 | The random seed to use for the generation. -1 means a random seed will be used. |
| output_format | string | No | jpeg | jpeg, png, webp | The format of the output image. |
| enable_base64_output | boolean | No | false | - | If enabled, the output will be encoded into a BASE64 string instead of a URL. This property is only available through the API. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data.id | string | Unique identifier for the prediction, Task Id |
| data.model | string | Model ID used for the prediction |
| data.outputs | array | Array of URLs to the generated content (empty when status is not completed) |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.has_nsfw_contents | array | Array of boolean values indicating NSFW detection for each output |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |
Result Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| id | string | Yes | - | Task ID |
Result Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data | object | The prediction data object containing all details |
| data.id | string | Unique identifier for the prediction, the ID of the prediction to get |
| data.model | string | Model ID used for the prediction |
| data.outputs | string | Array of URLs to the generated content (empty when status is not completed). |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |