Accéder au contenu

Stable Diffusion with LoRAs

Intégrer

Identifiant du modèle lora
# 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/lora?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "stabilityai/stable-diffusion-xl-base-1.0",
    "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"

Cette requête: ≈0,057 $ 57 crédits API · ≈ 6,01 ₽ L'exécuter sur cette page

Obtenir une clé API
Open model Texte vers image Entrées de référence #diffusion#lora#customization

Texte-image avec n'importe quel modèle de base Stable Diffusion, ainsi que LoRAs, embeddings, ControlNets et adaptateurs IP

Open model · Image

Votre premier résultat apparaîtra ici

Construisez une requête ci-dessous et exécutez-la avec votre clé API. Les sorties sont copiées dans notre stockage, conservées indéfiniment ou 7 jours gratuitement.

Créer une requête

Les contrôles sont générés à partir du schéma du modèle. Le code et le prix se mettent à jour lorsque vous les modifiez.

•obligatoire

Décrivez l’image que vous souhaitez générer avec autant de détails que possible pour obtenir les meilleurs résultats.

image_size par défaut square_hd

Dimensions de l’image de sortie, sélectionnées parmi des préréglages ou définies par une largeur et une hauteur personnalisées. Les deux dimensions personnalisées doivent être divisibles par 8.

•obligatoire

Modèle de base pour générer l'image, identifié par une URL ou un ID HuggingFace.

num_images par défaut 1

Définissez le nombre d’images produites par une seule requête ; une taille de lot plus importante nécessite davantage de temps de génération.

Avancé negative_prompt · ic_light_model_background_image_url · ic_light_image_url · prediction_type · image_format · unet_name · variant · image_encoder_path · image_encoder_subfolder · image_encoder_weight_name · ic_light_model_url · scheduler · num_inference_steps · guidance_scale · clip_skip · tile_width · tile_height · tile_stride_width · tile_stride_height · eta · seed · prompt_weighting · controlnet_guess_mode · rescale_betas_snr_zero · enable_safety_checker · debug_latents · debug_per_pass_latents · loras · embeddings · controlnets · ip_adapter · timesteps · sigmas
par défaut

Invite négative indiquant les détails d’image indésirables. Elle peut exclure des couleurs, objets, décors ou caractéristiques et qualités fines, comme une moustache, du flou ou une basse résolution.

Déposez un fichier ou

Arrière-plan compatible avec le modèle pour la génération d’images IC Light, fourni sous forme d’URL d’image.

Déposez un fichier ou

URL de l’image d’entrée pour la génération avec le modèle IC Light.

prediction_type par défaut epsilon

Choisissez le type de prédiction pour générer des images ; sans autre sélection, `epsilon` est utilisé.

image_format par défaut png

Format de fichier de l'image résultante.

Sélection d’un U-Net personnalisé pour générer des images ; fournissez son identifiant HuggingFace ou son URL.

Sélection de variante de modèle HuggingFace ; 'fp16' en est un exemple.

Encodeur d’image spécifié par une URL HTTPS ou un identifiant Hugging Face, dont la compatibilité dépend des poids de l’IP-Adapter : SD1.5 utilise `image_encoder_subfolder='models/image_encoder'`, tandis que h94/IP-Adapter SDXL utilise h94/IP-Adapter et `image_encoder_subfolder='sdxl_models/image_encoder'`. Un encodeur est requis dès que `ip_adapter` contient une valeur.

Sous-répertoire de `image_encoder_path` contenant les poids de l’encodeur d’image.

par défaut pytorch_model.bin

Sélectionnez par nom les poids de l’encodeur d’image à utiliser pour générer des images.

URL du modèle IC Light utilisée lors de la génération d’images.

Planificateur ou échantillonneur utilisé pour débruiter l'image.

par défaut 30

Contrôle le nombre d'étapes de génération effectuées par Stable Diffusion ; des étapes supplémentaires peuvent produire une image finale plus détaillée.

par défaut 7.5

Intensité d’adhésion à l’invite pour la sélection d’image, exprimée en CFG (Classifier Free Guidance).

par défaut 0

Ignore une partie de la génération d’image pour accélérer le rendu, au prix de résultats légèrement différents.

par défaut 4096

Définissez la taille de chaque tuile pendant la génération d’images.

par défaut 4096

Définissez la taille de chaque tuile pendant la génération d’images.

par défaut 2048

Définissez l’espacement entre les positions successives des tuiles pendant la génération d’images.

par défaut 2048

Définissez l’espacement entre les positions successives des tuiles pendant la génération d’images.

par défaut 0

Réglage Eta utilisé lors de la génération d’images.

Graine pour reproduire des images dans Stable Diffusion. Une image peut être reproduite exactement à chaque exécution si la version du modèle, l’invite et la graine restent inchangées.

par défaut []

LoRA dont l'effet combiné produit l'image générée, sans limite quant au nombre fourni.

par défaut []

Embeddings appliqués pendant la génération d’images pour mapper les jetons de l’invite à des poids d’embeddings. Actuellement, un seul embedding est pris en charge.

par défaut []

Control nets planifiés pour être appliqués à l’image aux pas spécifiés pendant la génération, sans limite quant au nombre fourni.

par défaut []

Adaptateurs IP utilisés pour générer des images. La fourniture d’une entrée quelconque nécessite `image_encoder_path`.

par défaut {"array":[],"method":...

Remplacement du calendrier des pas de débruitage, mutuellement exclusif avec `sigmas`. Sans remplacement — par défaut — le scheduler calcule les pas à partir de `num_inference_steps` ; fournir un calendrier personnalisé rend `num_inference_steps` sans effet. Un remplacement nécessite que le scheduler prenne en charge l’argument `timesteps` pour `set_timesteps`.

par défaut {"array":[],"method":...

Remplacement du calendrier des sigmas de débruitage, mutuellement exclusif avec `timesteps`. Sans remplacement — par défaut — le scheduler calcule les sigmas à partir de `num_inference_steps` ; fournir un calendrier personnalisé rend `num_inference_steps` sans effet. Un remplacement nécessite que le scheduler prenne en charge l’argument `sigmas` pour `set_sigmas`.

POST /run/lora?wait=20 devis → 0,057 $
# 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/lora?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "stabilityai/stable-diffusion-xl-base-1.0",
    "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"

Exécuter cette requête

Votre clé reste dans ce navigateur : elle est envoyée uniquement à la Doitong API et enregistrée dans localStorage uniquement si vous cochez Mémoriser. Obtenir une clé API

À propos de Stable Diffusion with LoRAs

Génère des images à partir d’une invite textuelle en utilisant un modèle de base indiqué par une URL ou un identifiant HuggingFace dans `model_name`. Plusieurs `loras` peuvent être fusionnés, et les embeddings, ControlNets, adaptateurs IP et entrées IC Light sont pris en charge. Les options d’échantillonneur incluent de nombreux ordonnanceurs et de 1 à 150 étapes. Génère 1 à 8 images en png ou jpeg.

Paramètres

Envoyez soit le nom canonique, soit le nom natif, mais pas les deux. Noms canoniques

NomType Par défautAutorisé Description
model_nameobligatoire
Typestring
Modèle de base pour générer l'image, identifié par une URL ou un ID HuggingFace.
unet_namefacultatif
Typestring | null
Sélection d’un U-Net personnalisé pour générer des images ; fournissez son identifiant HuggingFace ou son URL.
variantfacultatif
Typestring | null
Sélection de variante de modèle HuggingFace ; 'fp16' en est un exemple.
promptobligatoire
Typestring
Décrivez l’image que vous souhaitez générer avec autant de détails que possible pour obtenir les meilleurs résultats.
negative_promptfacultatif
Typestring
Par défaut
Invite négative indiquant les détails d’image indésirables. Elle peut exclure des couleurs, objets, décors ou caractéristiques et qualités fines, comme une moustache, du flou ou une basse résolution.
prompt_weightingfacultatif
Typeboolean
Par défautfalse
Option de pondération de l’invite : `true` supprime la limite de 77 jetons grâce à la moyenne des embeddings et active la syntaxe de pondération.
lorasfacultatif
Typeobject[]
Par défaut[]
LoRA dont l'effet combiné produit l'image générée, sans limite quant au nombre fourni.
loras[].pathobligatoire
Typestring
Emplacement des poids LoRA, indiqué sous forme d’URL ou de chemin.
loras[].scalefacultatif
Typenumber
Par défaut1
0 – 4
Multiplicateur appliqué au poids LoRA avant sa fusion avec le modèle de base.
embeddingsfacultatif
Typeobject[]
Par défaut[]
Embeddings appliqués pendant la génération d’images pour mapper les jetons de l’invite à des poids d’embeddings. Actuellement, un seul embedding est pris en charge.
embeddings[].pathobligatoire
Typestring
Poids des embeddings spécifiés par URL ou chemin de fichier.
embeddings[].tokensfacultatif
Typestring[]
Jetons de l’invite mappés à des poids d’embeddings. Si vous les omettez, un jeton est créé pour chaque vecteur du fichier d’embedding, nommé <s0>, <s1>, ... ; utilisez les jetons mappés dans vos invites.
controlnetsfacultatif
Typeobject[]
Par défaut[]
Control nets planifiés pour être appliqués à l’image aux pas spécifiés pendant la génération, sans limite quant au nombre fourni.
controlnets[].pathobligatoire
Typestring
Emplacement des poids ControlNet, spécifié sous forme d'URL ou de chemin.
controlnets[].config_urlfacultatif
Typestring | null
URL facultative pointant vers le fichier config.json du ControlNet.
controlnets[].variantfacultatif
Typestring | null
Variante facultative à utiliser avec une clé de dépôt Hugging Face.
controlnets[].image_urlobligatoire
Typeurl · image
URL de l’image fournie comme entrée du ControlNet.
controlnets[].mask_urlfacultatif
Typeurl · image
Masque du ControlNet, qui doit avoir la même taille que l’image de contrôle lorsqu’il est fourni ; la largeur et la hauteur doivent être divisibles par 32.
controlnets[].conditioning_scalefacultatif
Typenumber
Par défaut1
0 – 2
Mise à l'échelle appliquée aux poids ControlNet avant leur fusion avec le modèle de base.
controlnets[].start_percentagefacultatif
Typenumber
Par défaut0
0 – 1
Pourcentage du nombre total d'étapes temporelles auquel ControlNet commence à influencer la génération de l'image.
controlnets[].end_percentagefacultatif
Typenumber
Par défaut1
0 – 1
Pourcentage du nombre total d'étapes temporelles auquel ControlNet cesse d'influencer la génération de l'image.
controlnets[].ip_adapter_indexfacultatif
Typeinteger | null
Sélection de l’adaptateur IP par index pour un ControlNet InstantID ; les autres ControlNets ne nécessitent pas ce réglage.
controlnet_guess_modefacultatif
Typeboolean
Par défautfalse
Limite l’application du ControlNet aux prédictions conditionnelles lorsque la valeur est `true`.
ip_adapterfacultatif
Typeobject[]
Par défaut[]
Adaptateurs IP utilisés pour générer des images. La fourniture d’une entrée quelconque nécessite `image_encoder_path`.
ip_adapter[].ip_adapter_image_urlobligatoire
Typeurl · image
URL de l’image fournie comme entrée de l’adaptateur IP.
ip_adapter[].ip_adapter_mask_urlfacultatif
Typeurl · image
Masque de l’adaptateur IP, soumis à une contrainte de taille lorsqu’il est fourni : ses dimensions doivent être identiques à celles de l’image de l’adaptateur.
ip_adapter[].pathobligatoire
Typestring
Emplacement des poids de l’adaptateur IP, indiqué sous forme d’URL ou de chemin.
ip_adapter[].model_subfolderfacultatif
Typestring | null
Emplacement des poids de l’adaptateur IP, indiqué comme sous-dossier du répertoire du modèle.
ip_adapter[].weight_namefacultatif
Typestring | null
Nom de fichier des poids.
ip_adapter[].insight_face_model_pathfacultatif
Typestring | null
Emplacement des poids du modèle InsightFace, indiqué sous forme d’URL ou de chemin.
ip_adapter[].scalefacultatif
Typenumber
Par défaut1
≥ 0
Facteur d’échelle des poids de l’adaptateur IP, appliqué avant leur fusion dans le modèle de base.
ip_adapter[].scale_jsonfacultatif
Typeobject | null
Facteur d’échelle des poids de l’adaptateur IP, appliqué avant leur fusion dans le modèle de base.
ip_adapter[].unconditional_noising_factorfacultatif
Typenumber
Par défaut0
0 – 1
Facteur contrôlant le débruitage inconditionnel de l’adaptateur IP.
ip_adapter[].image_projection_shortcutfacultatif
Typeboolean
Par défauttrue
Réglage du raccourci de projection d’image, `True` étant la valeur par défaut. Utilisez `False` pour les modèles FaceID plus V1 et `True` pour les modèles FaceID plus V2.
image_encoder_pathfacultatif
Typestring | null
Encodeur d’image spécifié par une URL HTTPS ou un identifiant Hugging Face, dont la compatibilité dépend des poids de l’IP-Adapter : SD1.5 utilise `image_encoder_subfolder='models/image_encoder'`, tandis que h94/IP-Adapter SDXL utilise h94/IP-Adapter et `image_encoder_subfolder='sdxl_models/image_encoder'`. Un encodeur est requis dès que `ip_adapter` contient une valeur.
image_encoder_subfolderfacultatif
Typestring | null
Sous-répertoire de `image_encoder_path` contenant les poids de l’encodeur d’image.
image_encoder_weight_namefacultatif
Typestring | null
Par défautpytorch_model.bin
Sélectionnez par nom les poids de l’encodeur d’image à utiliser pour générer des images.
ic_light_model_urlfacultatif
Typestring | null
URL du modèle IC Light utilisée lors de la génération d’images.
ic_light_model_background_image_urlfacultatif
Typeurl · image
Arrière-plan compatible avec le modèle pour la génération d’images IC Light, fourni sous forme d’URL d’image.
ic_light_image_urlfacultatif
Typeurl · image
URL de l’image d’entrée pour la génération avec le modèle IC Light.
seedfacultatif
Typeinteger | null
Graine pour reproduire des images dans Stable Diffusion. Une image peut être reproduite exactement à chaque exécution si la version du modèle, l’invite et la graine restent inchangées.
image_sizefacultatif
Typeobject
Par défautsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensions de l’image de sortie, sélectionnées parmi des préréglages ou définies par une largeur et une hauteur personnalisées. Les deux dimensions personnalisées doivent être divisibles par 8.
num_inference_stepsfacultatif
Typeinteger
Par défaut30
1 – 150
Contrôle le nombre d'étapes de génération effectuées par Stable Diffusion ; des étapes supplémentaires peuvent produire une image finale plus détaillée.
guidance_scalefacultatif
Typenumber
Par défaut7.5
0 – 20
Intensité d’adhésion à l’invite pour la sélection d’image, exprimée en CFG (Classifier Free Guidance).
clip_skipfacultatif
Typeinteger
Par défaut0
0 – 2
Ignore une partie de la génération d’image pour accélérer le rendu, au prix de résultats légèrement différents.
schedulerfacultatif
Typeenum
DPM++ 2MDPM++ 2M KarrasDPM++ 2M SDEDPM++ 2M SDE KarrasEulerEuler AEuler (trailing timesteps)LCMLCM (trailing timesteps)DDIMTCD
Planificateur ou échantillonneur utilisé pour débruiter l'image.
timestepsfacultatif
Typeobject
Par défaut{"array":[],"method":"default"}
Remplacement du calendrier des pas de débruitage, mutuellement exclusif avec `sigmas`. Sans remplacement — par défaut — le scheduler calcule les pas à partir de `num_inference_steps` ; fournir un calendrier personnalisé rend `num_inference_steps` sans effet. Un remplacement nécessite que le scheduler prenne en charge l’argument `timesteps` pour `set_timesteps`.
timesteps.methodfacultatif
Typeenum
Par défautdefault
defaultarray
Choisissez comment les pas sont déterminés : `'default'`, le réglage par défaut, permet au scheduler d’utiliser `num_inference_steps`. Pour fournir vous-même un calendrier de pas, sélectionnez `'array'` et placez-le dans le champ `array`.
timesteps.arrayfacultatif
Typeinteger[]
Par défaut[]
Calendrier des pas appliqué lorsque la méthode sélectionnée est `'custom'`.
sigmasfacultatif
Typeobject
Par défaut{"array":[],"method":"default"}
Remplacement du calendrier des sigmas de débruitage, mutuellement exclusif avec `timesteps`. Sans remplacement — par défaut — le scheduler calcule les sigmas à partir de `num_inference_steps` ; fournir un calendrier personnalisé rend `num_inference_steps` sans effet. Un remplacement nécessite que le scheduler prenne en charge l’argument `sigmas` pour `set_sigmas`.
sigmas.methodfacultatif
Typeenum
Par défautdefault
defaultarray
Choisissez comment les sigmas sont déterminés : `'default'`, le réglage par défaut, utilise les valeurs de sigma propres au scheduler. Pour fournir vous-même un calendrier de sigmas, sélectionnez `'custom'` et placez-le dans le champ `array`.
sigmas.arrayfacultatif
Typenumber[]
Par défaut[]
Calendrier des sigmas appliqué lorsque la méthode sélectionnée est `'custom'`.
prediction_typefacultatif
Typeenum
Par défautepsilon
v_predictionepsilon
Choisissez le type de prédiction pour générer des images ; sans autre sélection, `epsilon` est utilisé.
rescale_betas_snr_zerofacultatif
Typeboolean
Par défautfalse
Contrôle l’activation de `rescale_betas_snr_zero` par l’échantillonneur.
image_formatfacultatif
Typeenum
Par défautpng
jpegpng
Format de fichier de l'image résultante.
num_imagesfacultatif num_outputs
Typeinteger
Par défaut1
1 – 8
Définissez le nombre d’images produites par une seule requête ; une taille de lot plus importante nécessite davantage de temps de génération.
enable_safety_checkerfacultatif
Typeboolean
Par défautfalse
Activation du contrôle de sécurité ; true active la vérification.
tile_widthfacultatif
Typeinteger
Par défaut4096
128 – 4 096
Définissez la taille de chaque tuile pendant la génération d’images.
tile_heightfacultatif
Typeinteger
Par défaut4096
128 – 4 096
Définissez la taille de chaque tuile pendant la génération d’images.
tile_stride_widthfacultatif
Typeinteger
Par défaut2048
64 – 2 048
Définissez l’espacement entre les positions successives des tuiles pendant la génération d’images.
tile_stride_heightfacultatif
Typeinteger
Par défaut2048
64 – 2 048
Définissez l’espacement entre les positions successives des tuiles pendant la génération d’images.
etafacultatif
Typenumber
Par défaut0
0 – 1
Réglage Eta utilisé lors de la génération d’images.
debug_latentsfacultatif
Typeboolean
Par défautfalse
Enregistre les latents à des fins de débogage lorsque la valeur est `true`.
debug_per_pass_latentsfacultatif
Typeboolean
Par défautfalse
Activez le débogage à chaque passe en définissant cette valeur sur `true`, ce qui enregistre les latents de chaque passe.
obligatoire Nom canonique, également accepté

Les paramètres de fichier acceptent une URL publique https://, un URI data: jusqu'à 10 MB ou le file_url d'un téléversement. Fichiers

Sortie

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "lora",
  "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": 57,
    "usd": "0.057",
    "charged": 57,
    "refunded": 0
  },
  "input": {
    "model_name": "stabilityai/stable-diffusion-xl-base-1.0",
    "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",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "debug_latents": {
      "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
    },
    "debug_per_pass_latents": {
      "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
    }
  },
  "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"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie sur notre stockage : conservée indéfiniment (facturation par Go-mois) ou 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Une structure identique pour chaque modèletype, url, content_type, width, height et duration, pour les images, les vidéos et l'audio. output est l'objet de résultat propre au modèle.
Champs de sortie
images
array of object {url, content_type, file_name, file_size, width, height}Informations sur les fichiers des images générées.
seed
integerGraine de génération d'image, incluant la valeur choisie aléatoirement si l'entrée ne fournissait pas de graine ; sinon, elle répète la valeur fournie.
has_nsfw_concepts
array of booleanIndique si des concepts NSFW apparaissent dans les images générées.
debug_latents
object {url, content_type, file_name, file_size} | nullDonnées latentes stockées à des fins de débogage.
debug_per_pass_latents
object {url, content_type, file_name, file_size} | nullDonnées latentes de chaque passe stockées à des fins de débogage.

Plus de modèles : Texte vers image

Pour les agents IA : cette page au format Markdown est disponible à l'adresse https://doitong.com/fr-FR/developers/models/lora.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt