Przejdź do treści

Hidream O1 Image · Dev · Edit

Integracja

Identyfikator modelu hidream-o1-image/dev/edit
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hidream-o1-image/dev/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

To żądanie: 0,02 $ 20 kredytów API Uruchom na tej stronie

Uzyskaj klucz API
HiDream Edycja obrazów Dane referencyjne

Destylowany wariant dev do edycji obrazów referencyjnych, z 28 krokami i domyślną wartością guidance 0

HiDream · Obraz

Tutaj pojawi się pierwszy wynik

Zbuduj poniżej żądanie i uruchom je za pomocą klucza API. Wyniki są kopiowane do naszej przestrzeni dyskowej i przechowywane bezterminowo lub 7 dni bezpłatnie.

Zbuduj żądanie

Elementy sterujące są generowane ze schematu modelu. Kod i cena aktualizują się podczas ich zmiany.

•wymagane

Instrukcje tekstowe dotyczące generowania lub edycji obrazów albo personalizacji opartej na obiekcie.

•wymagane reference_image_urls
Upuść plik lub

Obrazy dostarczone jako odniesienia do edycji lub personalizacji opartej na obiekcie.

image_size domyślnie {"height":2048,"width...

Wybierz wymiary obrazu; w przypadku wyników opartych na obrazach referencyjnych żądanie jest dopasowywane do najbliższej rozdzielczości obsługiwanej przez model, z przybliżonym maksimum 2048 × 2048 pikseli.

num_images domyślnie 1

Liczba obrazów do wygenerowania.

Zaawansowane output_format · num_inference_steps · guidance_scale · seed · enable_safety_checker · keep_original_aspect
output_format domyślnie png

Format pliku wynikowego obrazu.

domyślnie 28

Liczba iteracji odszumiania; 28 kroków odpowiada docelowemu poziomowi destylacji modelu dev.

domyślnie 0

Skala guidance bez klasyfikatora; domyślnie 0.0 dla modelu dev.

Losowe ziarno zapewniające powtarzalność generowania.

POST /run/hidream-o1-image/dev/edit?wait=20 wycena → 0,02 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hidream-o1-image/dev/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Uruchom to żądanie

Klucz pozostaje w tej przeglądarce: jest wysyłany tylko do Doitong API i zapisywany (localStorage) tylko po zaznaczeniu opcji Zapamiętaj. Uzyskaj klucz API

Informacje o Hidream O1 Image · Dev · Edit

Edytuje lub personalizuje obrazy na podstawie obrazów referencyjnych (`reference_image_urls`) i tekstowego `prompt`, używając destylowanego modelu dev dostrojonego do 28 kroków z domyślną skalą guidance 0. Wynik osiąga około 2048x2048 za pomocą presetów rozmiaru lub niestandardowych wymiarów. Zwraca od 1 do 4 obrazów jako PNG, JPEG lub WebP, a `keep_original_aspect` zachowuje kształt pojedynczego obrazu referencyjnego.

Parametry

Wyślij nazwę kanoniczną albo natywną, nie obie. Nazwy kanoniczne

NazwaTyp DomyślneDozwolone Opis
promptwymagane
Typstring
Instrukcje tekstowe dotyczące generowania lub edycji obrazów albo personalizacji opartej na obiekcie.
reference_image_urlswymagane images
Typurl[] · image
Obrazy dostarczone jako odniesienia do edycji lub personalizacji opartej na obiekcie.
image_sizeopcjonalne
Typobject
Domyślne{"height":2048,"width":2048}
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Wybierz wymiary obrazu; w przypadku wyników opartych na obrazach referencyjnych żądanie jest dopasowywane do najbliższej rozdzielczości obsługiwanej przez model, z przybliżonym maksimum 2048 × 2048 pikseli.
num_inference_stepsopcjonalne
Typinteger
Domyślne28
1 – 28
Liczba iteracji odszumiania; 28 kroków odpowiada docelowemu poziomowi destylacji modelu dev.
guidance_scaleopcjonalne
Typnumber
Domyślne0
0 – 20
Skala guidance bez klasyfikatora; domyślnie 0.0 dla modelu dev.
seedopcjonalne
Typinteger | null
Losowe ziarno zapewniające powtarzalność generowania.
num_imagesopcjonalne num_outputs
Typinteger
Domyślne1
1 – 4
Liczba obrazów do wygenerowania.
output_formatopcjonalne
Typenum
Domyślnepng
jpegpngwebp
Format pliku wynikowego obrazu.
enable_safety_checkeropcjonalne
Typboolean
Domyślnetrue
Określa, czy wygenerowane obrazy przechodzą kontrolę bezpieczeństwa.
keep_original_aspectopcjonalne
Typboolean
Domyślnefalse
Zachowanie proporcji dla generowania z pojedynczym obrazem referencyjnym: wynik zachowuje proporcje tego obrazu tylko wtedy, gdy podano dokładnie jeden obraz.
wymagane Nazwa kanoniczna, również akceptowana

Parametry plików przyjmują publiczny URL https://, identyfikator URI data: do 10 MB albo file_url przesłanego pliku. Pliki

Wynik

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hidream-o1-image/dev/edit",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 20,
    "usd": "0.02",
    "charged": 20,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "reference_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string",
    "timings": {}
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Twoje pliki, Twój wybórKażdy outputs[].url to kopia w naszej przestrzeni dyskowej: przechowywana bezterminowo (opłata za GB-miesiąc) lub 7 dni bezpłatnie, zgodnie z ustawieniem konta lub ?storage=.
Taki sam format w każdym modelutype, url, content_type, width, height i duration — tak samo dla obrazów, filmów i dźwięku. output to własny obiekt wyniku modelu.
Pola wyniku
images
array of object {url, content_type, file_name, file_size, width, height}Obrazy utworzone podczas generowania.
seed
integerWartość ziarna stosowana podczas generowania.
has_nsfw_concepts
array of booleanStan flagi kontrolera bezpieczeństwa dla każdego wygenerowanego obrazu.
prompt
stringPrompt użyty do wygenerowania wyniku.
timings
objectPomiary czasu generowania.

Dla agentów AI: ta strona w formacie Markdown jest dostępna pod adresem https://doitong.com/pl/developers/models/hidream-o1-image/dev/edit.md. Wszystkie modele i przewodniki: https://doitong.com/developers/llms.txt