Lompat ke konten

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,58 Jalankan di halaman ini

Dapatkan kunci API
Stability AI Teks ke Gambar Cepat #diffusion#controlnet#manipulation

Text-to-image SDXL yang dipandu gambar kontrol untuk generasi dengan komposisi terkunci

Stability AI · Gambar

Hasil pertama Anda akan muncul di sini

Buat permintaan di bawah ini dan jalankan dengan kunci API Anda. Output disalin ke penyimpanan kami, disimpan selamanya atau 7 hari gratis.

Buat permintaan

Kontrol dibuat dari skema model. Kode dan harga diperbarui saat Anda mengubahnya.

•wajib

Jelaskan gambar yang ingin dibuat sedetail mungkin untuk memperoleh hasil terbaik.

•wajib
Jatuhkan file, atau

URL yang mengarah ke gambar kontrol.

image_size

Dimensi output, ditentukan secara otomatis dari gambar kontrol saat ukuran tidak diberikan.

num_images bawaan 1

Jumlah gambar yang diminta untuk dibuat.

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
bawaan

Negative prompt yang menentukan detail gambar untuk dikecualikan, termasuk warna, objek, pemandangan, atau fitur yang lebih halus. Contohnya kumis, buram, atau resolusi rendah.

safety_checker_version bawaan v1

Pilih antara pemeriksa keamanan ViT khusus (`v2`) dan pemeriksa CompVis (`v1`, bawaan).

format bawaan jpeg

Format file untuk gambar hasil.

bawaan

Pengenal permintaan untuk menghubungkan respons dengan permintaan yang menghasilkannya.

bawaan 0.5

Kekuatan conditioning yang diterapkan oleh ControlNet.

bawaan 35

Jumlah langkah inferensi yang dijalankan.

bawaan 7.5

Kekuatan kepatuhan terhadap prompt untuk pemilihan gambar, dinyatakan sebagai CFG (Classifier Free Guidance).

Seed untuk mereproduksi gambar dalam Stable Diffusion. Gambar dapat direproduksi secara persis pada setiap proses dengan mempertahankan versi model, prompt, dan seed.

bawaan []

Bobot LoRA yang dipilih untuk digunakan, diberikan sebagai daftar.

bawaan []

Embedding yang dipilih untuk digunakan, diberikan sebagai daftar.

POST /run/fast-sdxl-controlnet-canny?wait=20 estimasi 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

Key Anda tetap berada di browser ini: key hanya dikirim ke Doitong API dan disimpan (localStorage) hanya jika Anda mencentang Ingat. Dapatkan kunci API

Tentang ControlNet SDXL

Menghasilkan gambar dari `prompt` serta `control_image_url` wajib yang mengarahkan tata letak. `controlnet_conditioning_scale` berkisar dari 0 hingga 1 (default 0.5). Ukuran output diambil dari gambar kontrol kecuali `image_size` ditetapkan. Mendukung hingga 8 gambar per panggilan, hingga 70 langkah, LoRA, dan embedding.

Parameter

Kirim nama kanonis atau nama asli, bukan keduanya. Nama kanonis

NamaTipe BawaanDiizinkan Deskripsi
promptwajib
Tipestring
Jelaskan gambar yang ingin dibuat sedetail mungkin untuk memperoleh hasil terbaik.
control_image_urlwajib
Tipeurl · image
URL yang mengarah ke gambar kontrol.
controlnet_conditioning_scaleopsional
Tipenumber
Bawaan0.5
0 – 1
Kekuatan conditioning yang diterapkan oleh ControlNet.
negative_promptopsional
Tipestring
Bawaan
Negative prompt yang menentukan detail gambar untuk dikecualikan, termasuk warna, objek, pemandangan, atau fitur yang lebih halus. Contohnya kumis, buram, atau resolusi rendah.
image_sizeopsional
Tipeobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensi output, ditentukan secara otomatis dari gambar kontrol saat ukuran tidak diberikan.
num_inference_stepsopsional
Tipeinteger
Bawaan35
1 – 70
Jumlah langkah inferensi yang dijalankan.
seedopsional
Tipeinteger | null
Seed untuk mereproduksi gambar dalam Stable Diffusion. Gambar dapat direproduksi secara persis pada setiap proses dengan mempertahankan versi model, prompt, dan seed.
guidance_scaleopsional
Tipenumber
Bawaan7.5
0 – 20
Kekuatan kepatuhan terhadap prompt untuk pemilihan gambar, dinyatakan sebagai CFG (Classifier Free Guidance).
num_imagesopsional num_outputs
Tipeinteger
Bawaan1
1 – 8
Jumlah gambar yang diminta untuk dibuat.
lorasopsional
Tipeobject[]
Bawaan[]
Bobot LoRA yang dipilih untuk digunakan, diberikan sebagai daftar.
loras[].forceopsional
Tipeboolean
Bawaanfalse
Apakah penggunaan embedding wajib: true menjadikannya wajib.
loras[].pathwajib
Tipestring
Sumber bobot LoRA, diberikan sebagai pengenal model HF yang mengarah ke bobot safetensors atau sebagai file safetensors yang ditemukan melalui URL atau path.
loras[].scaleopsional
Tipenumber
Bawaan1
0 – 1
Pengali yang diterapkan pada bobot LoRA sebelum digabungkan ke model dasar.
embeddingsopsional
Tipeobject[]
Bawaan[]
Embedding yang dipilih untuk digunakan, diberikan sebagai daftar.
embeddings[].pathwajib
Tipestring
Bobot embedding yang ditentukan melalui URL atau path file.
embeddings[].tokensopsional
Tipestring[]
Daftar token embedding, dengan penamaan otomatis jika dihilangkan: setiap vektor dalam file embedding menerima token dari urutan <s0>, <s1>, ... .
enable_safety_checkeropsional
Tipeboolean
Bawaantrue
Aktivasi pemeriksa keamanan; true mengaktifkan pemeriksaan.
safety_checker_versionopsional
Tipeenum
Bawaanv1
v1v2
Pilih antara pemeriksa keamanan ViT khusus (`v2`) dan pemeriksa CompVis (`v1`, bawaan).
expand_promptopsional
Tipeboolean
Bawaanfalse
Perluasan prompt dengan prompt tambahan, diaktifkan saat true.
formatopsional
Tipeenum
Bawaanjpeg
jpegpng
Format file untuk gambar hasil.
request_idopsional
Tipestring
Bawaan
Pengenal permintaan untuk menghubungkan respons dengan permintaan yang menghasilkannya.
wajib Nama kanonis, juga diterima

Parameter file menerima URL publik https://, URI data: hingga 10 MB, atau file_url dari unggahan. File

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"
  }
}
File Anda, pilihan AndaSetiap outputs[].url adalah salinan di penyimpanan kami: disimpan selamanya (dikenai biaya per GB-bulan) atau 7 hari gratis, sesuai setelan akun atau ?storage=.
Struktur sama di setiap modeltype, url, content_type, width, height, dan duration, untuk gambar, video, dan audio. output adalah objek hasil milik model.
Field output
images
array of object {url, width, height, content_type}Informasi file untuk gambar yang dihasilkan.
timings
object
seed
integerSeed pembuatan gambar, termasuk nilai yang dipilih secara acak jika input tidak menyertakan seed; jika tidak, nilai yang diberikan akan diulang.
has_nsfw_concepts
array of booleanMenunjukkan apakah konsep NSFW muncul dalam gambar yang dihasilkan.
prompt
stringPrompt yang digunakan selama pembuatan gambar.

Model lainnya: Teks ke Gambar

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