Ana içeriğe geç
YeniSeedance 2.5 yayında→
ModelRunner
hidream avatarı

HiDream I1 Dev API

hidream/i1-dev

HiDream’in 17B açık görsel modelinin 28 adımlık orta kademe sürümüyle, kalite ve hız arasında güçlü bir denge kurarak metin prompt’undan yüksek kaliteli görseller üretin.

görsel megapikseli başına 0.03
OpenAPI

Model girdisi

Input

The prompt to generate an image from.

The size of the generated image. Use a preset string (e.g. 'landscape_16_9') or a custom {width, height} object.

Min: 1 - Max: 4

The number of images to generate. Each generated image is billed.

The format of the generated image.

Additional Settings

Customize your input with more control.

Describe what you do NOT want to appear in the image.

Min: 1 - Max: 50

The number of inference steps to perform. Defaults to 28 for a balanced quality/speed result; more steps can improve detail at the cost of speed.

The same seed and the same prompt given to the same version of the model will output the same image every time.

Safety checker can only be disabled on API call

You need to be logged in to run this model and view results.
Log in

Model çıktısı

Output

Generated image output
Generated in 7.733 seconds
Logs (1 lines)

Örnek istekler

Örnekler

Example output 1Example output 2Example output 3Example output 4

HiDream I1 Dev API

HiDream I1 Dev is a text-to-image AI model by hidream. On ModelRunner it runs through a REST API or via MCP from any AI assistant, at $0.03 per megapixel.

POST https://queue.modelrunner.run/hidream/i1-dev

cURL

# Submit a request to the queue. Input fields go at the top level of the
# body. The optional reserved "metadata" object holds your own flat string
# tags — stored on the request, never sent to the model; filter later with
# GET https://queue.modelrunner.run/requests?metadata=<url-encoded JSON>.
curl -X POST https://queue.modelrunner.run/hidream/i1-dev \
  -H "Authorization: Key $MRUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Retro-futuristic 1970s space station interior, curved glossy white panels, warm amber accent lighting, two astronauts…",
    "image_size": "landscape_16_9",
    "num_images": 1,
    "output_format": "jpeg",
    "negative_prompt": "",
    "num_inference_steps": 28,
    "enable_safety_checker": true,
    "metadata": {
      "project": "my-project"
    }
  }'
# → { "request_id": "...", "status_url": "...", "response_url": "..." }

# Poll status_url until "COMPLETED", then fetch the result
curl "https://queue.modelrunner.run/hidream/i1-dev/requests/$REQUEST_ID/status" \
  -H "Authorization: Key $MRUN_API_KEY"
curl "https://queue.modelrunner.run/hidream/i1-dev/requests/$REQUEST_ID" \
  -H "Authorization: Key $MRUN_API_KEY"

JavaScript

import { modelrunner } from "@modelrunner/client";

const result = await modelrunner.subscribe("hidream/i1-dev", {
  input: {
    "prompt": "Retro-futuristic 1970s space station interior, curved glossy white panels, warm amber accent lighting, two astronauts…",
    "image_size": "landscape_16_9",
    "num_images": 1,
    "output_format": "jpeg",
    "negative_prompt": "",
    "num_inference_steps": 28,
    "enable_safety_checker": true
  },
});
console.log(result);

Python

import os
import requests

headers = {"Authorization": f"Key {os.environ['MRUN_API_KEY']}"}

submitted = requests.post(
    "https://queue.modelrunner.run/hidream/i1-dev",
    headers=headers,
    json={
      "prompt": "Retro-futuristic 1970s space station interior, curved glossy white panels, warm amber accent lighting, two astronauts…",
      "image_size": "landscape_16_9",
      "num_images": 1,
      "output_format": "jpeg",
      "negative_prompt": "",
      "num_inference_steps": 28,
      "enable_safety_checker": true
    },
).json()

# Poll submitted["status_url"] until "COMPLETED", then:
result = requests.get(submitted["response_url"], headers=headers).json()

Input parameters

Input parameters of HiDream I1 Dev
NameTypeRequiredDescription
promptstringyesThe prompt to generate an image from.
image_sizeenumnoThe size of the generated image. Use a preset string (e.g. 'landscape_16_9') or a custom {width, height} object. One of: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. Default: "square_hd".
num_imagesintegernoThe number of images to generate. Each generated image is billed. Default: 1.
output_formatenumnoThe format of the generated image. One of: jpeg, png. Default: "jpeg".
negative_promptstringnoDescribe what you do NOT want to appear in the image. Default: "".
num_inference_stepsintegernoThe number of inference steps to perform. Defaults to 28 for a balanced quality/speed result; more steps can improve detail at the cost of speed. Default: 28.
seedintegernoThe same seed and the same prompt given to the same version of the model will output the same image every time.
enable_safety_checkerbooleannoIf set to true, the safety checker will be enabled. Default: true.

Machine-readable: OpenAPI schema · llms.txt

Use HiDream I1 Dev from Claude & Cursor (MCP)

Point Claude Code, Claude Desktop, Cursor, or any MCP client at the ModelRunner MCP server and HiDream I1 Dev becomes a tool your assistant can call directly — it authorizes via OAuth (no API key in config) and runs this model with the run_model tool using the endpoint hidream/i1-dev.

MCP client config (Claude Desktop, Cursor)

{
  "mcpServers": {
    "modelrunner": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.modelrunner.run/mcp"]
    }
  }
}

Claude Code

claude mcp add --transport http modelrunner https://mcp.modelrunner.run/mcp

Then ask your assistant, for example: “Run hidream/i1-dev on ModelRunner to generate image”. MCP setup guide.

Model Detayları

Model Detayları

HiDream I1 Dev, bir metin prompt’unu kalite ile hız arasında güçlü bir denge kurarak yüksek kaliteli bir görsele dönüştürür. HiDream.ai’ın 17 milyar parametreli açık görsel temel modelinin orta kademe varyantıdır ve varsayılan olarak 28 inference adımıyla çalışır — Fast kademesinden daha fazla ayrıntı, Full kademesinden daha düşük maliyet. Betimleyici bir prompt verin, bir boyut seçin; model bir ila dört bitmiş görsel döndürür.

## En uygun olduğu işler - Maksimum sadakate para ödemeden iyi ayrıntı istediğiniz genel text-to-image üretimi - Bir metin açıklamasından yapay zekâ sanatı, illüstrasyonlar ve stilize sahneler - Hızlı bir taslaktan daha özenli olması gereken konsept çizimler ve ürün render’ları - Kısa bir yazılı brief’ten üretilen pazarlama ve sosyal medya görselleri - `num_images` (1-4) ile tek seferde birkaç varyasyon üretmek

## Şu durumlarda başka bir model seçin - En hızlı ve en ucuz taslağı istiyorsanız ve biraz ayrıntıdan ödün verebiliyorsanız — hız için optimize edilmiş 16 adımlık varyant `hidream/i1-fast` kullanın - Maksimum sadakat ve en yüksek ayrıntı gerekiyorsa — 50 adımlık tam kaliteli varyant `hidream/i1-full` kullanın (Dev’de olmayan LoRA desteğini de sunar) - Stili yönlendirmek için özel bir LoRA eklemek istiyorsanız — Dev kademesinde LoRA desteği yoktur; `hidream/i1-full` kullanın - Sıfırdan üretmek yerine mevcut bir fotoğrafı düzenlemek ya da yeniden tarzlamak istiyorsanız — bir görsel düzenleme modeli kullanın - Logo ya da tabelalar için görsel içinde güvenilir biçimde okunaklı metin gerekiyorsa — tipografi için ayarlanmış bir model kullanın - Video gerekiyorsa — bir text-to-video ya da image-to-video modeli kullanın

## İpuçları - Net ve betimleyici prompt’lar yazın; istenmeyen öğeleri dışarıda bırakmak için `negative_prompt` kullanın - Bu kademe dengeli bir sonuç için varsayılan olarak 28 adım kullanır; daha yüksek sadakat için `num_inference_steps` değerini (en fazla 50) yükseltin, daha hızlı ve ucuz bir taslak için düşürün - `image_size` bir hazır ayar (`square_hd`, `portrait_16_9`, `landscape_4_3`, ...) ya da özel bir `{width, height}` nesnesi alır; faturalandırma çıktı megapikseli başına yapılır, yani büyük görseller daha pahalıya gelir - `num_images` ile üretilen her görsel ayrı faturalandırılır

```js import { modelrunner } from "@modelrunner/client";

const result = await modelrunner.subscribe("hidream/i1-dev", { input: { prompt: "a red apple on a white table, studio lighting", image_size: "square_hd", num_images: 1, output_format: "jpeg", }, }); ```