Op den Inhalt sprangen

Hidream O1 Image · Dev · Edit

Integréieren

Modell-ID 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"

Dës Ufro: 0,02 $ 20 API-Kreditter Op dëser Säit ausféieren

API-Schlëssel kréien
HiDream Bildbearbechtung Referenzinput

Destilléiert Dev-Variant fir Referenzbildbearbechtung, 28 Schrëtt a Guidance standardméisseg 0

HiDream · Bild

Äin éischt Resultat kënnt hei hin

Baut hei drënner eng Ufro a féiert se mat Ärem API-Schlëssel aus. Output gëtt an eis Späicherung kopéiert, fir ëmmer oder 7 Deeg gratis gespäichert.

Eng Ufro erstellen

D'Kontrolle ginn aus dem Modellschema generéiert. De Code an de Präis aktualiséiere sech, wann s du se ännerst.

•obligatoresch

Textinstruktioune fir Biller ze generéieren oder z'änneren, oder fir subjektdréiwen Personaliséierung.

•obligatoresch reference_image_urls
Fichier erofzéien, oder

Biller, déi als Referenze fir d'Änneren oder subjektdréiwen Personaliséierung geliwwert ginn.

image_size Standard {"height":2048,"width...

Wielt d'Bilddimensiounen; bei Output op Basis vu Referenzbiller gëtt dës Ufro un déi nootst vum Modell ënnerstëtzt Opléisung ugepasst, mat engem ongeféiere Maximum vun 2048 × 2048 Pixel.

num_images Standard 1

Unzuel vun de Biller, déi erstallt ginn.

Erweidert output_format · num_inference_steps · guidance_scale · seed · enable_safety_checker · keep_original_aspect
output_format Standard png

Dateiformat vum resultéierende Bild.

Standard 28

Zuel vun den Denoising-Iteratiounen, woubäi 28 Schrëtt dem Distillatiounszil vum Dev-Modell entspriechen.

Standard 0

Skala fir classifier-free guidance; Standard ass 0.0 fir den Dev-Modell.

Zoufällege Seed, deen d'Generatioun reproduzéierbar mécht.

POST /run/hidream-o1-image/dev/edit?wait=20 Präis → 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"

Dës Ufro ausféieren

Äre Schlëssel bleift an dësem Browser: e gëtt nëmmen un d'Doitong API geschéckt an nëmme gespäichert (localStorage), wann s du „Erënneren“ aktivéiers. En API-Schlëssel kréien

Iwwer Hidream O1 Image · Dev · Edit

Ännert oder personaliséiert Biller aus Referenzbiller (`reference_image_urls`) an engem Text-`prompt`, mam destilléierten Dev-Modell fir 28 Schrëtt an enger Guidance-Skala vu standardméisseg 0. D'Ausgab geet bis ongeféier 2048x2048 iwwer Gréisstepresets oder personaliséiert Dimensiounen. Gëtt 1 bis 4 Biller als PNG, JPEG oder WebP zréck, an `keep_original_aspect` behält d'Form vun enger eenzeger Referenz.

Parameteren

Schéck entweder den kanoneschen Numm oder den natierlechen Numm, net béid. Kanonesch Nimm

NummTyp StandardErlaabt Beschreiwung
promptobligatoresch
Typstring
Textinstruktioune fir Biller ze generéieren oder z'änneren, oder fir subjektdréiwen Personaliséierung.
reference_image_urlsobligatoresch images
Typurl[] · image
Biller, déi als Referenze fir d'Änneren oder subjektdréiwen Personaliséierung geliwwert ginn.
image_sizeoptional
Typobject
Standard{"height":2048,"width":2048}
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Wielt d'Bilddimensiounen; bei Output op Basis vu Referenzbiller gëtt dës Ufro un déi nootst vum Modell ënnerstëtzt Opléisung ugepasst, mat engem ongeféiere Maximum vun 2048 × 2048 Pixel.
num_inference_stepsoptional
Typinteger
Standard28
1 – 28
Zuel vun den Denoising-Iteratiounen, woubäi 28 Schrëtt dem Distillatiounszil vum Dev-Modell entspriechen.
guidance_scaleoptional
Typnumber
Standard0
0 – 20
Skala fir classifier-free guidance; Standard ass 0.0 fir den Dev-Modell.
seedoptional
Typinteger | null
Zoufällege Seed, deen d'Generatioun reproduzéierbar mécht.
num_imagesoptional num_outputs
Typinteger
Standard1
1 – 4
Unzuel vun de Biller, déi erstallt ginn.
output_formatoptional
Typenum
Standardpng
jpegpngwebp
Dateiformat vum resultéierende Bild.
enable_safety_checkeroptional
Typboolean
Standardtrue
Steiert, ob generéiert Biller eng Sécherheetskontroll duerchlafen.
keep_original_aspectoptional
Typboolean
Standardfalse
Beibehale vum Aspektverhältnis bei Generatioun mat enger eenzeger Referenz: den Output entsprécht de Proportioune vun där Referenz nëmmen, wann genee ee Bild geliwwert gëtt.
obligatoresch Kanoneschen Numm, och akzeptéiert

Fichierparameter akzeptéieren eng ëffentlech https:// URL, eng data: URI bis zu 10 MB oder de file_url vun engem Upload. Fichieren

Output

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"
  }
}
Är Fichieren, Är WielAll outputs[].url ass eng Kopie an eiser Späicherung: fir ëmmer gespäichert (bezuelbar pro GB-Mount) oder 7 Deeg gratis, jee no Ärer Kontastellung oder ?storage=.
D'selwecht Struktur bei all Modelltype, url, content_type, width, height an duration, fir Biller, Video an Audio gläichermoossen. output ass dem Modell säin eegent Resultatobjet.
Output-Felder
images
array of object {url, content_type, file_name, file_size, width, height}Biller, déi duerch d'Generatioun erstallt goufen.
seed
integerSeed-Wäert, deen während der Generatioun applizéiert gouf.
has_nsfw_concepts
array of booleanStatus vum Sécherheetschecker fir all generéiert Bild.
prompt
stringPrompt, dee fir d'Generatioun vum Output benotzt gouf.
timings
objectZäitmiessunge fir d'Generatioun.

Fir AI-Agenten: dës Säit als Markdown ass ënner https://doitong.com/lb/developers/models/hidream-o1-image/dev/edit.md. All Modeller a Guiden: https://doitong.com/developers/llms.txt