உள்ளடக்கத்திற்குச் செல்க

SDXL ControlNet Union

ஒருங்கிணை

மாடல் id 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

இந்தக் கோரிக்கை: ≈$0.014 14 API கிரெடிட்கள் · ≈ ₽1.47 இந்தப் பக்கத்தில் இயக்குங்கள்

API விசையைப் பெறுக
Stability AI உரையிலிருந்து படத்திற்கு #diffusion#controlnet#composition

ஆறு கட்டுப்பாட்டுப் படங்கள் வரை பயன்படுத்தும் SDXL உரையிலிருந்து பட உருவாக்கம்: openpose, ஆழ வரைபடம், teed, canny, normal, பகுதிப்படுத்தல்

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 safety checker (`v2`) மற்றும் CompVis checker (`v1`, இயல்புநிலை) ஆகியவற்றில் ஒன்றைத் தேர்ந்தெடுக்கவும்.

format இயல்புநிலை jpeg

விளைவாக வரும் படத்திற்கான கோப்பு வடிவம்.

இயல்புநிலை

பதிலை அதை உருவாக்கிய கோரிக்கையுடன் தொடர்புபடுத்துவதற்கான கோரிக்கை அடையாளங்காட்டி.

இயல்புநிலை 0.5

ControlNet பயன்படுத்தும் நிபந்தனையாக்கத்தின் வலிமை.

இயல்புநிலை 35

இயக்க வேண்டிய inference படிகளின் எண்ணிக்கை.

இயல்புநிலை 7.5

படத் தேர்வுக்கான ப்ராம்ப்ட்-பின்பற்றல் வலிமை, CFG (Classifier Free Guidance) ஆக வெளிப்படுத்தப்படுகிறது.

Stable Diffusion-ல் படங்களை மீண்டும் உருவாக்குவதற்கான seed. மாதிரி பதிப்பு, ப்ராம்ப்ட் மற்றும் seed ஆகியவற்றை மாற்றாமல் வைத்தால், ஒவ்வொரு இயக்கத்திலும் ஒரு படத்தைத் துல்லியமாக மீண்டும் உருவாக்கலாம்.

இயல்புநிலை []

பயன்பாட்டிற்குத் தேர்ந்தெடுக்கப்பட்ட LoRA weights, பட்டியலாக வழங்கப்படும்.

இயல்புநிலை []

பயன்பாட்டிற்குத் தேர்ந்தெடுக்கப்பட்ட Embeddings, பட்டியலாக வழங்கப்படும்.

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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

இந்தக் கோரிக்கையை இயக்கு

உங்கள் key இந்த உலாவியில் மட்டுமே இருக்கும்: அது Doitong API-க்கு மட்டும் அனுப்பப்படும்; Remember-ஐத் தேர்ந்தெடுத்தால் மட்டுமே (localStorage)-ல் சேமிக்கப்படும். API விசையைப் பெறுங்கள்

SDXL ControlNet Union பற்றி

openpose, ஆழ வரைபடம், teed, canny, normal அல்லது பகுதிப்படுத்தல் போன்ற கட்டுப்பாட்டுப் படங்களால் வழிநடத்தப்படும் `prompt`-இலிருந்து SDXL படங்களை உருவாக்குகிறது; ஒவ்வொன்றுக்கும் தனிப்பட்ட முன்செயலாக்க மாற்றுக் கட்டுப்பாடு உள்ளது. `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
இயக்க வேண்டிய inference படிகளின் எண்ணிக்கை.
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 weights, பட்டியலாக வழங்கப்படும்.
loras[].forceவிருப்பத்தேர்வு
வகைboolean
இயல்புநிலைfalse
Embedding பயன்பாடு கட்டாயமா என்பதை குறிப்பிடுகிறது: true கட்டாயமாக்குகிறது.
loras[].pathதேவை
வகைstring
LoRA weight-ன் மூலம்; safetensors weights-க்கு தீர்க்கப்படும் HF மாதிரி அடையாளங்காட்டியாகவோ, URL அல்லது path மூலம் கிடைக்கும் safetensors கோப்பாகவோ வழங்கப்படும்.
loras[].scaleவிருப்பத்தேர்வு
வகைnumber
இயல்புநிலை1
0 – 1
அடிப்படை மாதிரியில் இணைப்பதற்கு முன் LoRA எடைக்கு பயன்படுத்தப்படும் பெருக்கி.
embeddingsவிருப்பத்தேர்வு
வகைobject[]
இயல்புநிலை[]
பயன்பாட்டிற்குத் தேர்ந்தெடுக்கப்பட்ட Embeddings, பட்டியலாக வழங்கப்படும்.
embeddings[].pathதேவை
வகைstring
URL அல்லது கோப்பு path மூலம் குறிப்பிடப்படும் Embedding weights.
embeddings[].tokensவிருப்பத்தேர்வு
வகைstring[]
Embedding டோக்கன் பட்டியல்; விடுபட்டால் தானியங்கி பெயரிடல் கிடைக்கும்: Embedding கோப்பிலுள்ள ஒவ்வொரு vector-க்கும் <s0>, <s1>, ... வரிசையிலிருந்து ஒரு டோக்கன் வழங்கப்படும்.
enable_safety_checkerவிருப்பத்தேர்வு
வகைboolean
இயல்புநிலைtrue
பாதுகாப்புச் சரிபார்ப்பைச் செயல்படுத்துதல்; true எனில் சரிபார்ப்பு இயக்கப்படும்.
safety_checker_versionவிருப்பத்தேர்வு
வகைenum
இயல்புநிலைv1
v1v2
தனிப்பயன் ViT safety checker (`v2`) மற்றும் CompVis checker (`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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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பட உருவாக்க விதை; உள்ளீட்டில் விதை விடுபட்டிருந்தால் தோராயமாகத் தேர்ந்தெடுக்கப்பட்ட மதிப்பும் இதில் அடங்கும்; இல்லையெனில் வழங்கப்பட்ட மதிப்பை மீண்டும் பயன்படுத்தும்.
has_nsfw_concepts
array of booleanஉருவாக்கப்பட்ட படங்களில் NSFW கருத்துகள் உள்ளனவா என்பதைக் குறிப்பிடுகிறது.
prompt
stringபட உருவாக்கத்தின்போது பயன்படுத்தப்படும் ப்ராம்ப்ட்.

மேலும் மாதிரிகள்: உரையிலிருந்து படத்திற்கு

AI ஏஜெண்டுகளுக்கு: இந்தப் பக்கம் Markdown வடிவில் இங்கே உள்ளது https://doitong.com/ta/developers/models/sdxl-controlnet-union.md. அனைத்து மாடல்களும் வழிகாட்டிகளும்: https://doitong.com/developers/llms.txt