Langkau ke kandungan

ControlNet SDXL

Integrasikan

ID model fast-sdxl-controlnet-canny
# 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/fast-sdxl-controlnet-canny?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",
    "control_image_url": "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"

Permintaan ini: ≈$0.015 15 kredit API · ≈ ₽1.60 Jalankan pada halaman ini

Dapatkan kunci API
Stability AI Teks ke Imej Pantas #diffusion#controlnet#manipulation

Teks-ke-imej SDXL berpandukan imej kawalan untuk penjanaan dengan komposisi terkunci

Stability AI · Imej

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

•diperlukan

Terangkan imej yang anda mahu dijana dengan sedetail mungkin untuk mendapatkan hasil terbaik.

•diperlukan
Lepaskan fail, atau

URL yang menunjuk kepada imej kawalan.

image_size

Dimensi output, ditentukan secara automatik daripada imej kawalan apabila tiada saiz dibekalkan.

num_images lalai 1

Bilangan imej yang diminta untuk penjanaan.

Lanjutan negative_prompt · safety_checker_version · format · request_id · controlnet_conditioning_scale · num_inference_steps · guidance_scale · seed · enable_safety_checker · expand_prompt · loras · embeddings
lalai

Prompt negatif yang menyatakan butiran imej untuk dikecualikan, termasuk warna, objek, pemandangan atau ciri halus. Contohnya misai, kabur atau resolusi rendah.

safety_checker_version lalai v1

Pilih antara pemeriksa keselamatan ViT tersuai (`v2`) dan pemeriksa CompVis (`v1`, lalai).

format lalai jpeg

Format fail untuk imej yang terhasil.

lalai

Pengecam permintaan untuk mengaitkan respons dengan permintaan yang menghasilkannya.

lalai 0.5

Kekuatan pengkondisian yang digunakan oleh ControlNet.

lalai 35

Bilangan langkah inferens yang perlu dijalankan.

lalai 7.5

Kekuatan pematuhan prompt untuk pemilihan imej, dinyatakan sebagai CFG (Classifier Free Guidance).

Seed untuk menghasilkan semula imej dalam Stable Diffusion. Imej boleh dihasilkan semula dengan tepat pada setiap larian dengan mengekalkan versi model, prompt dan seed tanpa perubahan.

lalai []

Pemberat LoRA yang dipilih untuk digunakan, diberikan sebagai senarai.

lalai []

Embedding yang dipilih untuk digunakan, diberikan sebagai senarai.

POST /run/fast-sdxl-controlnet-canny?wait=20 sebut harga → $0.015
# 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/fast-sdxl-controlnet-canny?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",
    "control_image_url": "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"

Jalankan permintaan ini

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang ControlNet SDXL

Menjana imej daripada `prompt` serta `control_image_url` wajib yang mengawal susun atur. `controlnet_conditioning_scale` berjulat dari 0 hingga 1 (lalai 0.5). Saiz output disimpulkan daripada imej kawalan melainkan `image_size` ditetapkan. Menyokong sehingga 8 imej bagi setiap panggilan, sehingga 70 langkah, LoRA dan pembenaman.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
promptdiperlukan
Jenisstring
Terangkan imej yang anda mahu dijana dengan sedetail mungkin untuk mendapatkan hasil terbaik.
control_image_urldiperlukan
Jenisurl · image
URL yang menunjuk kepada imej kawalan.
controlnet_conditioning_scalepilihan
Jenisnumber
Lalai0.5
0 – 1
Kekuatan pengkondisian yang digunakan oleh ControlNet.
negative_promptpilihan
Jenisstring
Lalai
Prompt negatif yang menyatakan butiran imej untuk dikecualikan, termasuk warna, objek, pemandangan atau ciri halus. Contohnya misai, kabur atau resolusi rendah.
image_sizepilihan
Jenisobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensi output, ditentukan secara automatik daripada imej kawalan apabila tiada saiz dibekalkan.
num_inference_stepspilihan
Jenisinteger
Lalai35
1 – 70
Bilangan langkah inferens yang perlu dijalankan.
seedpilihan
Jenisinteger | null
Seed untuk menghasilkan semula imej dalam Stable Diffusion. Imej boleh dihasilkan semula dengan tepat pada setiap larian dengan mengekalkan versi model, prompt dan seed tanpa perubahan.
guidance_scalepilihan
Jenisnumber
Lalai7.5
0 – 20
Kekuatan pematuhan prompt untuk pemilihan imej, dinyatakan sebagai CFG (Classifier Free Guidance).
num_imagespilihan num_outputs
Jenisinteger
Lalai1
1 – 8
Bilangan imej yang diminta untuk penjanaan.
loraspilihan
Jenisobject[]
Lalai[]
Pemberat LoRA yang dipilih untuk digunakan, diberikan sebagai senarai.
loras[].forcepilihan
Jenisboolean
Lalaifalse
Sama ada penggunaan embedding diwajibkan: true menjadikannya wajib.
loras[].pathdiperlukan
Jenisstring
Sumber pemberat LoRA, diberikan sebagai pengecam model HF yang merujuk kepada pemberat safetensors atau sebagai fail safetensors yang ditemui melalui URL atau laluan.
loras[].scalepilihan
Jenisnumber
Lalai1
0 – 1
Pengganda yang digunakan pada berat LoRA sebelum digabungkan dengan model asas.
embeddingspilihan
Jenisobject[]
Lalai[]
Embedding yang dipilih untuk digunakan, diberikan sebagai senarai.
embeddings[].pathdiperlukan
Jenisstring
Pemberat embedding yang ditentukan melalui URL atau laluan fail.
embeddings[].tokenspilihan
Jenisstring[]
Senarai token embedding, dengan penamaan automatik apabila diabaikan: setiap vektor dalam fail embedding menerima token daripada jujukan <s0>, <s1>, ... .
enable_safety_checkerpilihan
Jenisboolean
Lalaitrue
Pengaktifan pemeriksa keselamatan; true mendayakan pemeriksaan.
safety_checker_versionpilihan
Jenisenum
Lalaiv1
v1v2
Pilih antara pemeriksa keselamatan ViT tersuai (`v2`) dan pemeriksa CompVis (`v1`, lalai).
expand_promptpilihan
Jenisboolean
Lalaifalse
Pengembangan prompt dengan prompt tambahan, didayakan apabila true.
formatpilihan
Jenisenum
Lalaijpeg
jpegpng
Format fail untuk imej yang terhasil.
request_idpilihan
Jenisstring
Lalai
Pengecam permintaan untuk mengaitkan respons dengan permintaan yang menghasilkannya.
diperlukan Nama kanonik, turut diterima

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "fast-sdxl-controlnet-canny",
  "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": 15,
    "usd": "0.015",
    "charged": 15,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "control_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",
        "width": 1024,
        "height": 768,
        "content_type": "image/jpeg"
      }
    ],
    "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"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
images
array of object {url, width, height, content_type}Maklumat fail untuk imej yang dijana.
timings
object
seed
integerSeed penjanaan imej, termasuk nilai yang dipilih secara rawak jika input tidak membekalkan seed; jika tidak, nilai yang dibekalkan diulang.
has_nsfw_concepts
array of booleanMenunjukkan sama ada konsep NSFW muncul dalam imej yang dijana.
prompt
stringPrompt yang digunakan semasa penjanaan imej.

Lebih banyak model: Teks ke Imej

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/fast-sdxl-controlnet-canny.md. Semua model dan panduan: https://doitong.com/developers/llms.txt