Мазмұнға өту

SDXL ControlNet Union

Интеграциялау

Модель идентификаторы sdxl-controlnet-union
# 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/sdxl-controlnet-union?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"
  }'

# 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,014 $ 14 API кредиті Осы бетте іске қосу

API кілтін алу
Stability AI Мәтіннен кескінге #diffusion#controlnet#composition

openpose, тереңдік картасы, teed, canny, normal және сегментация басқару кескіндерінің алтауына дейін бағытталатын SDXL мәтіннен кескін генерациясы

Stability AI · Кескін

Алғашқы нәтижеңіз осында пайда болады

Төменде сұрау құрып, оны API кілтіңізбен іске қосыңыз. Шығыстар сақтау орнымызға көшіріліп, мәңгі немесе 7 күн тегін сақталады.

Сұрау жасау

Басқару элементтері модель схемасынан жасалады. Оларды өзгерткен сайын код пен баға жаңартылады.

•міндетті

Генерацияланатын кескінді сипаттаңыз; ең жақсы нәтиже үшін мүмкіндігінше егжей-тегжейлі жазыңыз.

image_size

Өлшем берілмегенде басқару кескінінен автоматты түрде анықталатын шығыс өлшемдері.

num_images әдепкі 1

Генерацияға сұралған кескіндер саны.

Қосымша negative_prompt · openpose_image_url · depth_image_url · teed_image_url · canny_image_url · normal_image_url · segmentation_image_url · safety_checker_version · format · request_id · controlnet_conditioning_scale · num_inference_steps · guidance_scale · seed · enable_safety_checker · expand_prompt · openpose_preprocess · depth_preprocess · teed_preprocess · canny_preprocess · normal_preprocess · segmentation_preprocess · loras · embeddings
әдепкі

Кескіннен алып тасталатын түстерді, нысандарды, көріністерді немесе ұсақ белгілерді көрсететін теріс нұсқау. Мысалдар: мұрт, бұлыңғырлық немесе төмен ажыратымдылық.

Файлды тастаңыз немесе

Басқару кескініне сілтеме жасайтын URL.

Файлды тастаңыз немесе

Басқару кескініне сілтеме жасайтын URL.

Файлды тастаңыз немесе

Басқару кескініне сілтеме жасайтын URL.

Файлды тастаңыз немесе

Басқару кескініне сілтеме жасайтын URL.

Файлды тастаңыз немесе

Басқару кескініне сілтеме жасайтын URL.

Файлды тастаңыз немесе

Басқару кескініне сілтеме жасайтын URL.

safety_checker_version әдепкі v1

Арнаулы ViT қауіпсіздік тексергішін (`v2`) немесе CompVis тексергішін (`v1`, әдепкі) таңдаңыз.

format әдепкі jpeg

Нәтижедегі кескіннің файл пішімі.

әдепкі

Жауапты оны жасаған сұраумен байланыстыруға арналған сұрау идентификаторы.

әдепкі 0.5

ControlNet қолданатын шарттандыру күші.

әдепкі 35

Орындалатын инференс қадамдарының саны.

әдепкі 7.5

Кескін таңдау кезіндегі нұсқауға сәйкестік күші CFG (Classifier Free Guidance) ретінде көрсетіледі.

Stable Diffusion кескіндерін қайталауға арналған seed. Модель нұсқасын, нұсқауды және seed мәнін өзгеріссіз сақтау арқылы кескінді әр іске қосқанда дәл қайталауға болады.

әдепкі []

Пайдалану үшін таңдалған LoRA салмақтары тізім ретінде беріледі.

әдепкі []

Пайдалану үшін таңдалған эмбеддингтер тізім ретінде беріледі.

POST /run/sdxl-controlnet-union?wait=20 бағасы → 0,014 $
# 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/sdxl-controlnet-union?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"
  }'

# 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"

Осы сұрауды іске қосу

Кілтіңіз осы браузерде қалады: ол тек Doitong API-ге жіберіледі және Remember параметрін белгілеcеңіз ғана localStorage ішінде сақталады. API кілтін алу

SDXL ControlNet Union туралы

`prompt` арқылы бағытталатын SDXL кескіндерін openpose, тереңдік картасы, teed, canny, normal немесе сегментация сияқты басқару кескіндерімен генерациялайды; олардың әрқайсысында жеке алдын ала өңдеу ауыстырғышы бар. `controlnet_conditioning_scale` 0-ден 1-ге дейін. Кескін өлшемі басқару кескінінен алынуы мүмкін. LoRA, эмбеддингтерді, 1-ден 8-ге дейінгі кескінді және jpeg немесе png шығысын қолдайды.

Параметрлер

Канондық атауды немесе төл атауды жіберіңіз, екеуін қатар жібермеңіз. Канондық атаулар

АтауыТүрі ӘдепкіРұқсат етілген Сипаттама
promptміндетті
Түріstring
Генерацияланатын кескінді сипаттаңыз; ең жақсы нәтиже үшін мүмкіндігінше егжей-тегжейлі жазыңыз.
controlnet_conditioning_scaleміндетті емес
Түріnumber
Әдепкі0.5
0 – 1
ControlNet қолданатын шарттандыру күші.
negative_promptміндетті емес
Түріstring
Әдепкі
Кескіннен алып тасталатын түстерді, нысандарды, көріністерді немесе ұсақ белгілерді көрсететін теріс нұсқау. Мысалдар: мұрт, бұлыңғырлық немесе төмен ажыратымдылық.
image_sizeміндетті емес
Түріobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Өлшем берілмегенде басқару кескінінен автоматты түрде анықталатын шығыс өлшемдері.
num_inference_stepsміндетті емес
Түріinteger
Әдепкі35
1 – 70
Орындалатын инференс қадамдарының саны.
seedміндетті емес
Түріinteger | null
Stable Diffusion кескіндерін қайталауға арналған seed. Модель нұсқасын, нұсқауды және seed мәнін өзгеріссіз сақтау арқылы кескінді әр іске қосқанда дәл қайталауға болады.
guidance_scaleміндетті емес
Түріnumber
Әдепкі7.5
0 – 20
Кескін таңдау кезіндегі нұсқауға сәйкестік күші CFG (Classifier Free Guidance) ретінде көрсетіледі.
num_imagesміндетті емес num_outputs
Түріinteger
Әдепкі1
1 – 8
Генерацияға сұралған кескіндер саны.
lorasміндетті емес
Түріobject[]
Әдепкі[]
Пайдалану үшін таңдалған LoRA салмақтары тізім ретінде беріледі.
loras[].forceміндетті емес
Түріboolean
Әдепкіfalse
Эмбеддингті пайдалану міндетті ме: true оны міндетті етеді.
loras[].pathміндетті
Түріstring
LoRA салмағының көзі: safetensors салмақтарына сәйкестендірілетін HF модель идентификаторы немесе URL не жол арқылы орналасқан safetensors файлы.
loras[].scaleміндетті емес
Түріnumber
Әдепкі1
0 – 1
Негізгі модельге біріктірілмес бұрын LoRA салмағына қолданылатын көбейткіш.
embeddingsміндетті емес
Түріobject[]
Әдепкі[]
Пайдалану үшін таңдалған эмбеддингтер тізім ретінде беріледі.
embeddings[].pathміндетті
Түріstring
URL немесе файл жолы арқылы көрсетілген эмбеддинг салмақтары.
embeddings[].tokensміндетті емес
Түріstring[]
Эмбеддинг токендерінің тізімі. Көрсетілмесе, автоматты атау қолданылады: эмбеддинг файлындағы әр векторға <s0>, <s1>, ... реттілігінен токен беріледі.
enable_safety_checkerміндетті емес
Түріboolean
Әдепкіtrue
Қауіпсіздік тексергішін іске қосу; true мәні тексеруді қосады.
safety_checker_versionміндетті емес
Түріenum
Әдепкіv1
v1v2
Арнаулы ViT қауіпсіздік тексергішін (`v2`) немесе CompVis тексергішін (`v1`, әдепкі) таңдаңыз.
expand_promptміндетті емес
Түріboolean
Әдепкіfalse
Қосымша нұсқаулармен нұсқауды кеңейту; true болғанда қосылады.
formatміндетті емес
Түріenum
Әдепкіjpeg
jpegpng
Нәтижедегі кескіннің файл пішімі.
request_idміндетті емес
Түріstring
Әдепкі
Жауапты оны жасаған сұраумен байланыстыруға арналған сұрау идентификаторы.
openpose_image_urlміндетті емес
Түріurl · image
Басқару кескініне сілтеме жасайтын URL.
openpose_preprocessміндетті емес
Түріboolean
Әдепкіtrue
openpose кескінінің алдын ала өңделуін басқарады.
depth_image_urlміндетті емес
Түріurl · image
Басқару кескініне сілтеме жасайтын URL.
depth_preprocessміндетті емес
Түріboolean
Әдепкіtrue
depth кескінінің алдын ала өңделуін басқарады.
teed_image_urlміндетті емес
Түріurl · image
Басқару кескініне сілтеме жасайтын URL.
teed_preprocessміндетті емес
Түріboolean
Әдепкіtrue
teed кескінінің алдын ала өңделуін басқарады.
canny_image_urlміндетті емес
Түріurl · image
Басқару кескініне сілтеме жасайтын URL.
canny_preprocessміндетті емес
Түріboolean
Әдепкіtrue
canny кескінінің алдын ала өңделуін басқарады.
normal_image_urlміндетті емес
Түріurl · image
Басқару кескініне сілтеме жасайтын URL.
normal_preprocessміндетті емес
Түріboolean
Әдепкіtrue
normal кескінінің алдын ала өңделуін басқарады.
segmentation_image_urlміндетті емес
Түріurl · image
Басқару кескініне сілтеме жасайтын URL.
segmentation_preprocessміндетті емес
Түріboolean
Әдепкіtrue
segmentation кескінінің алдын ала өңделуін басқарады.
міндетті Канондық атау, бұл да қабылданады

Файл параметрлері жалпыға қолжетімді https:// URL мекенжайын, 10 MB-қа дейінгі data: URI мекенжайын немесе жүктеп салынған файлдың file_url мәнін қабылдайды. Файлдар

Шығыс

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sdxl-controlnet-union",
  "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": 14,
    "usd": "0.014",
    "charged": 14,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Файлдарыңыз — таңдауыңызӘр outputs[].url — сақтау орнымыздағы көшірме: мәңгі (әр GB-ай үшін ақылы) немесе аккаунт параметрі не ?storage= арқылы 7 күн тегін сақталады.
Әр модельдегі пішім бірдейtype, url, content_type, width, height және duration — кескіндерге, бейнеге және аудиоға ортақ. output — модельдің өз нәтижелер нысаны.
Шығыс өрістері
images
array of object {url, width, height, content_type}Генерацияланған кескіндер туралы файл ақпараты.
timings
object
seed
integerКескін генерациясының seed мәні: кірісте seed көрсетілмесе, кездейсоқ таңдалған мәнді қамтиды; әйтпесе берілген мәнді қайталайды.
has_nsfw_concepts
array of booleanГенерацияланған кескіндерде NSFW ұғымдарының бар-жоғын көрсетеді.
prompt
stringКескін генерациясы кезінде қолданылатын нұсқау.

Қосымша модельдер: Мәтіннен кескінге

AI агенттеріне: бұл беттің Markdown нұсқасы мына жерде: https://doitong.com/kk/developers/models/sdxl-controlnet-union.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt