Preskoči na vsebino

Z Image Turbo Controlnet

Integracija

ID modela z-image/turbo/controlnet
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/z-image/turbo/controlnet?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",
    "image": "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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Ta zahteva: ≈0,013 $ 13 API kreditov · ≈ 1,37 ₽ Zaženi na tej strani

Pridobi ključ API
Alibaba · Slika

Tukaj bo vaš prvi rezultat

Spodaj sestavite zahtevo in jo zaženite s svojim ključem API. Izhodi se kopirajo v našo shrambo, kjer se hranijo za vedno ali 7 dni brezplačno.

Ustvari zahtevo

Kontrolniki se ustvarijo iz sheme modela. Koda in cena se posodobita, ko ju spreminjate.

•obvezno

Poziv, ki usmerja generiranje slike.

•obvezno image_url
Spustite datoteko ali

URL slike, uporabljene kot vhod za generiranje ControlNet.

image_size privzeto auto

Dimenzije generirane slike.

num_images privzeto 1

Število slik, zahtevanih za generiranje.

Napredno output_format · acceleration · preprocess · num_inference_steps · control_scale · control_start · control_end · seed · enable_safety_checker · enable_prompt_expansion
output_format privzeto png

Oblika datoteke končne slike.

acceleration privzeto regular

Raven pospeševanja, uporabljena pri obdelavi.

preprocess privzeto none

Metoda predhodne obdelave, uporabljena za sliko, ali brez predhodne obdelave.

privzeto 8

Število korakov sklepanja, ki jih je treba izvesti.

privzeto 0.75

Moč pogojevanja, uporabljenega s ControlNet.

privzeto 0

Začetna točka za pogojevanje ControlNet.

privzeto 0.8

Končna točka za pogojevanje ControlNet.

Seed za ponovljive slike: enak poziv in seed ustvarita enako sliko, če različica modela ostane nespremenjena.

POST /run/z-image/turbo/controlnet?wait=20 cena → 0,013 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/z-image/turbo/controlnet?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",
    "image": "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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Zaženi to zahtevo

Vaš ključ ostane v tem brskalniku: pošlje se samo v Doitong API in shrani v localStorage samo, če označite možnost Zapomni si. Pridobi ključ API

O modelu Z Image Turbo Controlnet

Ustvari sliko iz `prompt`, pri čemer kontrolna slika (`image_url`) usmerja strukturo. `preprocess` lahko izlušči robove canny, globino ali pozo oziroma uporabi none. Parametri `control_scale`, `control_start` in `control_end` določajo moč in čas uporabe pogojevanja. Podpira do 4 slike, 8 korakov in samodejni `image_size`.

Parametri

Pošlji kanonično ali izvorno ime, ne obeh. Kanonična imena

ImeVrsta PrivzetoDovoljeno Opis
promptobvezno
Vrstastring
Poziv, ki usmerja generiranje slike.
image_sizeneobvezno
Vrstaobject
Privzetoauto
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9auto
Dimenzije generirane slike.
num_inference_stepsneobvezno
Vrstainteger
Privzeto8
1 – 8
Število korakov sklepanja, ki jih je treba izvesti.
seedneobvezno
Vrstainteger | null
Seed za ponovljive slike: enak poziv in seed ustvarita enako sliko, če različica modela ostane nespremenjena.
num_imagesneobvezno num_outputs
Vrstainteger
Privzeto1
1 – 4
Število slik, zahtevanih za generiranje.
enable_safety_checkerneobvezno
Vrstaboolean
Privzetotrue
Varnostno preverjanje, ki namesto slik, označenih kot nevarne, vrne črne slike. Vrednost true omogoči preverjanje; false ga onemogoči samo za pooblaščene račune, zahteve brez pooblastila pa se preverjajo ne glede na to.
output_formatneobvezno
Vrstaenum
Privzetopng
jpegpngwebp
Oblika datoteke končne slike.
accelerationneobvezno
Vrstaenum
Privzetoregular
noneregularhigh
Raven pospeševanja, uporabljena pri obdelavi.
enable_prompt_expansionneobvezno
Vrstaboolean
Privzetofalse
Določa, ali je razširjanje poziva omogočeno.
image_urlobvezno image
Vrstaurl · image
URL slike, uporabljene kot vhod za generiranje ControlNet.
control_scaleneobvezno
Vrstanumber
Privzeto0.75
0 – 1
Moč pogojevanja, uporabljenega s ControlNet.
control_startneobvezno
Vrstanumber
Privzeto0
0 – 1
Začetna točka za pogojevanje ControlNet.
control_endneobvezno
Vrstanumber
Privzeto0.8
0 – 1
Končna točka za pogojevanje ControlNet.
preprocessneobvezno
Vrstaenum
Privzetonone
nonecannydepthpose
Metoda predhodne obdelave, uporabljena za sliko, ali brez predhodne obdelave.
obvezno Kanonično ime, prav tako sprejeto

Parametri datotek sprejmejo javni https:// URL, podatkovni URI data: do 10 MB ali file_url naložene datoteke. Datoteke

Izhod

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "z-image/turbo/controlnet",
  "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": 13,
    "usd": "0.013",
    "charged": 13,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_url": "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
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string"
  },
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Vaše datoteke, vaša izbiraVsak outputs[].url je kopija v naši shrambi: hrani se za vedno (plačilo na GB-mesec) ali 7 dni brezplačno, glede na nastavitev računa ali ?storage=.
Enaka struktura pri vsakem modelutype, url, content_type, width, height in duration za slike, videoposnetke in zvok. output je lasten objekt rezultata modela.
Polja izhoda
images
array of object {url, content_type, file_name, file_size, width, height}Podatki o datotekah ustvarjenih slik.
timings
objectPodatki o času postopka generiranja.
seed
integerSeme za generiranje slike, vključno z naključno izbrano vrednostjo, če vhod ni vseboval semena; sicer ponovi podano vrednost.
has_nsfw_concepts
array of booleanOznačuje, ali se v generiranih slikah pojavljajo koncepti NSFW.
prompt
stringPoziv, uporabljen pri generiranju slike.

Več modelov: Urejanje slik

Za agente AI: ta stran je v obliki Markdown na voljo na https://doitong.com/sl/developers/models/z-image/turbo/controlnet.md. Vsi modeli in vodniki: https://doitong.com/developers/llms.txt