ਸਮੱਗਰੀ ਵੱਲ ਜਾਓ

Z Image Turbo Controlnet

ਇੰਟੀਗ੍ਰੇਟ ਕਰੋ

ਮਾਡਲ id 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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

ਇਹ ਬੇਨਤੀ: ≈$0.013 13 API ਕ੍ਰੈਡਿਟ ਇਸ ਪੰਨੇ ’ਤੇ ਚਲਾਓ

API ਕੁੰਜੀ ਲਵੋ
Alibaba · ਚਿੱਤਰ

ਤੁਹਾਡਾ ਪਹਿਲਾ ਨਤੀਜਾ ਇੱਥੇ ਹੋਵੇਗਾ

ਹੇਠਾਂ ਬੇਨਤੀ ਬਣਾਓ ਅਤੇ ਆਪਣੀ API ਕੁੰਜੀ ਨਾਲ ਚਲਾਓ। ਆਉਟਪੁੱਟ ਸਾਡੇ ਸਟੋਰੇਜ ਵਿੱਚ ਕਾਪੀ ਕੀਤੇ ਜਾਂਦੇ ਹਨ ਅਤੇ ਹਮੇਸ਼ਾ ਲਈ ਜਾਂ ਮੁਫ਼ਤ ਵਿੱਚ 7 ਦਿਨ ਤੱਕ ਰੱਖੇ ਜਾਂਦੇ ਹਨ।

ਰਿਕਵੈਸਟ ਬਣਾਓ

ਕੰਟਰੋਲ ਮਾਡਲ ਸਕੀਮਾ ਤੋਂ ਤਿਆਰ ਹੁੰਦੇ ਹਨ। ਤੁਸੀਂ ਬਦਲਾਅ ਕਰਦੇ ਹੀ ਕੋਡ ਅਤੇ ਕੀਮਤ ਅੱਪਡੇਟ ਹੋ ਜਾਂਦੇ ਹਨ।

•ਲੋੜੀਂਦਾ

ਚਿੱਤਰ ਸਿਰਜਣਾ ਨੂੰ ਦਿਸ਼ਾ ਦੇਣ ਵਾਲਾ ਪ੍ਰੌਂਪਟ।

•ਲੋੜੀਂਦਾ image_url
ਫ਼ਾਈਲ ਛੱਡੋ, ਜਾਂ

ControlNet ਸਿਰਜਣਾ ਲਈ ਇਨਪੁੱਟ ਵਜੋਂ ਵਰਤਿਆ ਜਾਣ ਵਾਲਾ ਚਿੱਤਰ URL।

image_size ਡਿਫ਼ਾਲਟ auto

ਸਿਰਜੇ ਗਏ ਚਿੱਤਰ ਦੇ ਮਾਪ।

num_images ਡਿਫ਼ਾਲਟ 1

ਸਿਰਜਣਾ ਲਈ ਮੰਗੀ ਗਈ ਚਿੱਤਰਾਂ ਦੀ ਗਿਣਤੀ।

ਉੱਨਤ output_format · acceleration · preprocess · num_inference_steps · control_scale · control_start · control_end · seed · enable_safety_checker · enable_prompt_expansion
output_format ਡਿਫ਼ਾਲਟ png

ਨਤੀਜੇ ਵਾਲੇ ਚਿੱਤਰ ਦਾ ਫ਼ਾਈਲ ਫਾਰਮੈਟ।

acceleration ਡਿਫ਼ਾਲਟ regular

ਪ੍ਰੋਸੈਸਿੰਗ 'ਤੇ ਲਾਗੂ ਕੀਤਾ ਗਿਆ ਐਕਸੈਲੇਰੇਸ਼ਨ ਪੱਧਰ।

preprocess ਡਿਫ਼ਾਲਟ none

ਚਿੱਤਰ 'ਤੇ ਲਾਗੂ ਕੀਤੀ ਜਾਣ ਵਾਲੀ preprocessing ਵਿਧੀ, ਜਾਂ ਕੋਈ preprocessing ਨਹੀਂ।

ਡਿਫ਼ਾਲਟ 8

ਚਲਾਏ ਜਾਣ ਵਾਲੇ ਇਨਫ਼ਰੈਂਸ ਕਦਮਾਂ ਦੀ ਗਿਣਤੀ।

ਡਿਫ਼ਾਲਟ 0.75

ControlNet ਦੁਆਰਾ ਲਾਗੂ ਕੀਤੀ ਕੰਡੀਸ਼ਨਿੰਗ ਦੀ ਤਾਕਤ।

ਡਿਫ਼ਾਲਟ 0

ControlNet conditioning ਲਈ ਸ਼ੁਰੂਆਤੀ ਬਿੰਦੂ।

ਡਿਫ਼ਾਲਟ 0.8

ControlNet conditioning ਲਈ ਅੰਤਿਮ ਬਿੰਦੂ।

ਦੁਹਰਾਏ ਜਾ ਸਕਣ ਵਾਲੇ ਚਿੱਤਰਾਂ ਲਈ ਸੀਡ: ਜਦੋਂ ਮਾਡਲ ਦਾ ਵਰਜਨ ਇੱਕੋ ਜਿਹਾ ਹੋਵੇ, ਤਾਂ ਇੱਕੋ ਪ੍ਰੌਂਪਟ ਅਤੇ ਸੀਡ ਇੱਕੋ ਚਿੱਤਰ ਤਿਆਰ ਕਰਦੇ ਹਨ।

POST /run/z-image/turbo/controlnet?wait=20 ਕੋਟ → $0.013
# 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/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

ਇਹ ਬੇਨਤੀ ਚਲਾਓ

ਤੁਹਾਡੀ key ਇਸ ਬ੍ਰਾਊਜ਼ਰ ਵਿੱਚ ਰਹਿੰਦੀ ਹੈ: ਇਹ ਸਿਰਫ਼ Doitong API ਨੂੰ ਭੇਜੀ ਜਾਂਦੀ ਹੈ ਅਤੇ ਸਿਰਫ਼ ਤਾਂ ਹੀ (localStorage) ਵਿੱਚ ਸੁਰੱਖਿਅਤ ਹੁੰਦੀ ਹੈ ਜੇ ਤੁਸੀਂ Remember ਚੁਣੋ। API ਕੁੰਜੀ ਪ੍ਰਾਪਤ ਕਰੋ

Z Image Turbo Controlnet ਬਾਰੇ

`prompt` ਤੋਂ ਤਿਆਰ ਕਰਦਾ ਹੈ, ਜਦਕਿ ਇੱਕ ਕੰਟਰੋਲ ਚਿੱਤਰ (`image_url`) ਬਣਤਰ ਨੂੰ ਦਿਸ਼ਾ ਦਿੰਦਾ ਹੈ। `preprocess` canny ਕਿਨਾਰੇ, ਡੈਪਥ ਜਾਂ ਪੋਜ਼ ਕੱਢ ਸਕਦਾ ਹੈ, ਜਾਂ none ਵਰਤ ਸਕਦਾ ਹੈ। `control_scale`, `control_start` ਅਤੇ `control_end` ਕੰਡੀਸ਼ਨਿੰਗ ਦੀ ਤੀਬਰਤਾ ਅਤੇ ਲਾਗੂ ਹੋਣ ਦਾ ਸਮਾਂ ਨਿਰਧਾਰਤ ਕਰਦੇ ਹਨ। ਵੱਧ ਤੋਂ ਵੱਧ 4 ਚਿੱਤਰਾਂ, 8 ਸਟੈਪਾਂ ਅਤੇ ਸਵੈਚਲਿਤ `image_size` ਦਾ ਸਮਰਥਨ ਕਰਦਾ ਹੈ।

ਪੈਰਾਮੀਟਰ

ਕੈਨੋਨਿਕਲ ਨਾਮ ਜਾਂ ਨੇਟਿਵ ਨਾਮ ਵਿੱਚੋਂ ਕੋਈ ਇੱਕ ਭੇਜੋ, ਦੋਵੇਂ ਨਹੀਂ। ਕੈਨੋਨਿਕਲ ਨਾਮ

ਨਾਮਕਿਸਮ ਡਿਫ਼ਾਲਟਮਨਜ਼ੂਰਸ਼ੁਦਾ ਵੇਰਵਾ
promptਲੋੜੀਂਦਾ
ਕਿਸਮstring
ਚਿੱਤਰ ਸਿਰਜਣਾ ਨੂੰ ਦਿਸ਼ਾ ਦੇਣ ਵਾਲਾ ਪ੍ਰੌਂਪਟ।
image_sizeਵਿਕਲਪਿਕ
ਕਿਸਮobject
ਡਿਫ਼ਾਲਟauto
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9auto
ਸਿਰਜੇ ਗਏ ਚਿੱਤਰ ਦੇ ਮਾਪ।
num_inference_stepsਵਿਕਲਪਿਕ
ਕਿਸਮinteger
ਡਿਫ਼ਾਲਟ8
1 – 8
ਚਲਾਏ ਜਾਣ ਵਾਲੇ ਇਨਫ਼ਰੈਂਸ ਕਦਮਾਂ ਦੀ ਗਿਣਤੀ।
seedਵਿਕਲਪਿਕ
ਕਿਸਮinteger | null
ਦੁਹਰਾਏ ਜਾ ਸਕਣ ਵਾਲੇ ਚਿੱਤਰਾਂ ਲਈ ਸੀਡ: ਜਦੋਂ ਮਾਡਲ ਦਾ ਵਰਜਨ ਇੱਕੋ ਜਿਹਾ ਹੋਵੇ, ਤਾਂ ਇੱਕੋ ਪ੍ਰੌਂਪਟ ਅਤੇ ਸੀਡ ਇੱਕੋ ਚਿੱਤਰ ਤਿਆਰ ਕਰਦੇ ਹਨ।
num_imagesਵਿਕਲਪਿਕ num_outputs
ਕਿਸਮinteger
ਡਿਫ਼ਾਲਟ1
1 – 4
ਸਿਰਜਣਾ ਲਈ ਮੰਗੀ ਗਈ ਚਿੱਤਰਾਂ ਦੀ ਗਿਣਤੀ।
enable_safety_checkerਵਿਕਲਪਿਕ
ਕਿਸਮboolean
ਡਿਫ਼ਾਲਟtrue
ਸੁਰੱਖਿਆ ਜਾਂਚ, ਜੋ ਅਸੁਰੱਖਿਅਤ ਚਿੰਨ੍ਹਿਤ ਚਿੱਤਰਾਂ ਦੀ ਥਾਂ ਕਾਲੇ ਚਿੱਤਰ ਵਾਪਸ ਕਰਦੀ ਹੈ। true ਜਾਂਚ ਚਾਲੂ ਕਰਦਾ ਹੈ; false ਇਸਨੂੰ ਸਿਰਫ਼ ਅਧਿਕਾਰਤ ਖਾਤਿਆਂ ਲਈ ਬੰਦ ਕਰਦਾ ਹੈ, ਜਦਕਿ ਬਿਨਾਂ ਅਧਿਕਾਰ ਵਾਲੀਆਂ ਬੇਨਤੀਆਂ ਦੀ ਜਾਂਚ ਹਰ ਹਾਲਤ ਵਿੱਚ ਹੁੰਦੀ ਹੈ।
output_formatਵਿਕਲਪਿਕ
ਕਿਸਮenum
ਡਿਫ਼ਾਲਟpng
jpegpngwebp
ਨਤੀਜੇ ਵਾਲੇ ਚਿੱਤਰ ਦਾ ਫ਼ਾਈਲ ਫਾਰਮੈਟ।
accelerationਵਿਕਲਪਿਕ
ਕਿਸਮenum
ਡਿਫ਼ਾਲਟregular
noneregularhigh
ਪ੍ਰੋਸੈਸਿੰਗ 'ਤੇ ਲਾਗੂ ਕੀਤਾ ਗਿਆ ਐਕਸੈਲੇਰੇਸ਼ਨ ਪੱਧਰ।
enable_prompt_expansionਵਿਕਲਪਿਕ
ਕਿਸਮboolean
ਡਿਫ਼ਾਲਟfalse
ਨਿਯੰਤਰਿਤ ਕਰਦਾ ਹੈ ਕਿ ਪ੍ਰੌਂਪਟ ਵਿਸਥਾਰ ਸਮਰਥਿਤ ਹੈ ਜਾਂ ਨਹੀਂ।
image_urlਲੋੜੀਂਦਾ image
ਕਿਸਮurl · image
ControlNet ਸਿਰਜਣਾ ਲਈ ਇਨਪੁੱਟ ਵਜੋਂ ਵਰਤਿਆ ਜਾਣ ਵਾਲਾ ਚਿੱਤਰ URL।
control_scaleਵਿਕਲਪਿਕ
ਕਿਸਮnumber
ਡਿਫ਼ਾਲਟ0.75
0 – 1
ControlNet ਦੁਆਰਾ ਲਾਗੂ ਕੀਤੀ ਕੰਡੀਸ਼ਨਿੰਗ ਦੀ ਤਾਕਤ।
control_startਵਿਕਲਪਿਕ
ਕਿਸਮnumber
ਡਿਫ਼ਾਲਟ0
0 – 1
ControlNet conditioning ਲਈ ਸ਼ੁਰੂਆਤੀ ਬਿੰਦੂ।
control_endਵਿਕਲਪਿਕ
ਕਿਸਮnumber
ਡਿਫ਼ਾਲਟ0.8
0 – 1
ControlNet conditioning ਲਈ ਅੰਤਿਮ ਬਿੰਦੂ।
preprocessਵਿਕਲਪਿਕ
ਕਿਸਮenum
ਡਿਫ਼ਾਲਟnone
nonecannydepthpose
ਚਿੱਤਰ 'ਤੇ ਲਾਗੂ ਕੀਤੀ ਜਾਣ ਵਾਲੀ preprocessing ਵਿਧੀ, ਜਾਂ ਕੋਈ preprocessing ਨਹੀਂ।
ਲੋੜੀਂਦਾ ਕੈਨੋਨਿਕਲ ਨਾਮ, ਇਹ ਵੀ ਸਵੀਕਾਰਿਆ ਜਾਂਦਾ ਹੈ

ਫ਼ਾਈਲ ਪੈਰਾਮੀਟਰ ਜਨਤਕ https:// URL, 10 MB ਤੱਕ ਦਾ data: URI, ਜਾਂ ਅੱਪਲੋਡ ਦੇ file_url ਨੂੰ ਸਵੀਕਾਰਦੇ ਹਨ। ਫ਼ਾਈਲਾਂ

ਆਉਟਪੁੱਟ

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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ਤੁਹਾਡੀਆਂ ਫ਼ਾਈਲਾਂ, ਤੁਹਾਡੀ ਚੋਣਹਰ outputs[].url ਸਾਡੇ ਸਟੋਰੇਜ ਵਿੱਚ ਇੱਕ ਕਾਪੀ ਹੈ: ਹਮੇਸ਼ਾ ਲਈ ਰੱਖੀ ਜਾਂਦੀ ਹੈ (ਪ੍ਰਤੀ GB-ਮਹੀਨਾ ਭੁਗਤਾਨ) ਜਾਂ 7 ਦਿਨ ਤੱਕ ਮੁਫ਼ਤ, ਤੁਹਾਡੀ ਖਾਤਾ ਸੈਟਿੰਗ ਜਾਂ ?storage= ਅਨੁਸਾਰ।
ਹਰ ਮਾਡਲ ’ਤੇ ਇੱਕੋ ਜਿਹਾ ਰੂਪਤਸਵੀਰਾਂ, ਵੀਡੀਓ ਅਤੇ ਆਡੀਓ ਸਭ ਲਈ type, url, content_type, width, height ਅਤੇ duration। output ਮਾਡਲ ਦਾ ਆਪਣਾ ਨਤੀਜਾ ਆਬਜੈਕਟ ਹੈ।
ਆਉਟਪੁੱਟ ਦੇ ਫ਼ੀਲਡ
images
array of object {url, content_type, file_name, file_size, width, height}ਤਿਆਰ ਕੀਤੇ ਚਿੱਤਰਾਂ ਦੀ ਫ਼ਾਈਲ ਜਾਣਕਾਰੀ।
timings
objectਸਿਰਜਣਾ ਪ੍ਰਕਿਰਿਆ ਲਈ ਸਮਾਂ-ਸੰਬੰਧੀ ਜਾਣਕਾਰੀ।
seed
integerਚਿੱਤਰ-ਸਿਰਜਣਾ ਸੀਡ, ਜਿਸ ਵਿੱਚ ਇਨਪੁੱਟ ਵਿੱਚ ਸੀਡ ਨਾ ਦੇਣ 'ਤੇ ਬੇਤਰਤੀਬ ਚੁਣੀ ਗਈ ਕੀਮਤ ਸ਼ਾਮਲ ਹੁੰਦੀ ਹੈ; ਨਹੀਂ ਤਾਂ ਦਿੱਤੀ ਕੀਮਤ ਦੁਹਰਾਈ ਜਾਂਦੀ ਹੈ।
has_nsfw_concepts
array of booleanਦੱਸਦਾ ਹੈ ਕਿ ਸਿਰਜੇ ਗਏ ਚਿੱਤਰਾਂ ਵਿੱਚ NSFW ਧਾਰਨਾਵਾਂ ਮੌਜੂਦ ਹਨ ਜਾਂ ਨਹੀਂ।
prompt
stringਚਿੱਤਰ ਸਿਰਜਣਾ ਦੌਰਾਨ ਵਰਤਿਆ ਜਾਣ ਵਾਲਾ ਪ੍ਰੌਂਪਟ।

ਹੋਰ ਮਾਡਲ: ਚਿੱਤਰ ਸੰਪਾਦਨ

AI ਏਜੰਟਾਂ ਲਈ: ਇਹ ਪੰਨਾ Markdown ਵਜੋਂ ਇੱਥੇ ਹੈ https://doitong.com/pa/developers/models/z-image/turbo/controlnet.md. ਸਾਰੇ ਮਾਡਲ ਅਤੇ ਗਾਈਡ: https://doitong.com/developers/llms.txt