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

Cette requête: ≈0,057 $ 57 crédits API 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 LoRA, plongements, ControlNets et adaptateurs IP

Open model · Image

Votre premier résultat apparaîtra ici

Créez 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 pendant 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 au fur et à mesure de vos modifications.

•requis

Décrivez l’image que vous souhaitez générer avec le plus de détails 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.

•requis

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

num_images par défaut 1

Définissez le nombre d’images produites par une seule requête, en accordant davantage de temps de génération aux lots plus volumineux.

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 les couleurs, les objets, le décor ou des caractéristiques et qualités plus fines, comme une moustache, du flou ou une faible 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 utilisé 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 obtenue.

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

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

Encodeur d’image indiqué par une URL HTTPS ou un identifiant Hugging Face, dont la compatibilité dépend des poids 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 lorsque 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’images, exprimée comme CFG (Classifier Free Guidance).

par défaut 0

Ignore une partie de la génération d’image pour accélérer le rendu, ce qui produit des 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 en conservant la version du modèle, l’invite et la graine 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 []

Plongements appliqués pendant la génération d’images pour associer les jetons de l’invite aux poids des plongements. Actuellement, un seul plongement est pris en charge.

par défaut []

ControlNets planifiés pour être appliqués à l’image à des pas de temps précis 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’entrées nécessite image_encoder_path.

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

Remplacement du calendrier des pas de temps de débruitage, mutuellement exclusif avec sigmas. Sans remplacement — le comportement par défaut — le planificateur calcule les pas de temps à partir de num_inference_steps; un calendrier personnalisé rend num_inference_steps sans effet. Un remplacement nécessite que le planificateur 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 — le comportement par défaut — le planificateur calcule les sigmas à partir de num_inference_steps; un calendrier personnalisé rend num_inference_steps sans effet. Un remplacement nécessite que le planificateur 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.com/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.com/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 au 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 texte en utilisant un modèle de base indiqué par URL ou identifiant HuggingFace dans `model_name`. Plusieurs `loras` peuvent être fusionnés, et les plongements, ControlNets, adaptateurs IP et entrées IC Light sont pris en charge. Les options d’échantillonneur comprennent de nombreux ordonnanceurs et de 1 à 150 étapes. Génère de 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_namerequis
Typestring
Modèle de base pour générer l’image, identifié par une URL ou un identifiant 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 du modèle HuggingFace; 'fp16' en est un exemple.
promptrequis
Typestring
Décrivez l’image que vous souhaitez générer avec le plus de détails 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 les couleurs, les objets, le décor ou des caractéristiques et qualités plus fines, comme une moustache, du flou ou une faible résolution.
prompt_weightingfacultatif
Typeboolean
Par défautfalse
Interrupteur de pondération de l’invite : true supprime la limite de 77 jetons grâce à la moyenne des plongements 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[].pathrequis
Typestring
Emplacement des poids LoRA, indiqué par une URL ou un 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[]
Plongements appliqués pendant la génération d’images pour associer les jetons de l’invite aux poids des plongements. Actuellement, un seul plongement est pris en charge.
embeddings[].pathrequis
Typestring
Poids de l’embedding spécifiés par URL ou chemin de fichier.
embeddings[].tokensfacultatif
Typestring[]
Jetons de l’invite associés aux poids des plongements. Leur omission crée un jeton par vecteur du fichier de plongements, nommé <s0>, <s1>, ...; utilisez les jetons associés dans vos invites.
controlnetsfacultatif
Typeobject[]
Par défaut[]
ControlNets planifiés pour être appliqués à l’image à des pas de temps précis pendant la génération, sans limite quant au nombre fourni.
controlnets[].pathrequis
Typestring
Emplacement des poids ControlNet, indiqué 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_urlrequis
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 chacune ê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 d’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 d’image.
controlnets[].ip_adapter_indexfacultatif
Typeinteger | null
Sélection de l’adaptateur IP par index pour un ControlNet InstantID; les autres ControlNets n’ont pas besoin de 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’entrées nécessite image_encoder_path.
ip_adapter[].ip_adapter_image_urlrequis
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[].pathrequis
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 bruitage non conditionnel de l’adaptateur IP.
ip_adapter[].image_projection_shortcutfacultatif
Typeboolean
Par défauttrue
Réglage du raccourci de projection d’image, dont la valeur par défaut est True. 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 indiqué par une URL HTTPS ou un identifiant Hugging Face, dont la compatibilité dépend des poids 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 lorsque 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 en conservant la version du modèle, l’invite et la graine 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’images, exprimée comme 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, ce qui produit des 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 temps de débruitage, mutuellement exclusif avec sigmas. Sans remplacement — le comportement par défaut — le planificateur calcule les pas de temps à partir de num_inference_steps; un calendrier personnalisé rend num_inference_steps sans effet. Un remplacement nécessite que le planificateur prenne en charge l’argument timesteps pour set_timesteps.
timesteps.methodfacultatif
Typeenum
Par défautdefault
defaultarray
Choisissez comment les pas de temps sont déterminés : 'default', le réglage par défaut, permet au planificateur d’utiliser `num_inference_steps`. Pour fournir vous-même un calendrier de pas de temps, sélectionnez 'array' et placez le calendrier dans le champ `array`.
timesteps.arrayfacultatif
Typeinteger[]
Par défaut[]
Calendrier des pas de temps 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 — le comportement par défaut — le planificateur calcule les sigmas à partir de num_inference_steps; un calendrier personnalisé rend num_inference_steps sans effet. Un remplacement nécessite que le planificateur 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 sigma propres au planificateur. Pour fournir vous-même un calendrier sigma, sélectionnez 'custom' et placez le calendrier dans le champ `array`.
sigmas.arrayfacultatif
Typenumber[]
Par défaut[]
Calendrier sigma appliqué lorsque la méthode sélectionnée est 'custom'.
prediction_typefacultatif
Typeenum
Par défautepsilon
v_predictionepsilon
Choisissez le type de prédiction utilisé pour générer des images; sans autre sélection, `epsilon` est utilisé.
rescale_betas_snr_zerofacultatif
Typeboolean
Par défautfalse
Contrôle si l’échantillonneur active rescale_betas_snr_zero.
image_formatfacultatif
Typeenum
Par défautpng
jpegpng
Format de fichier de l’image obtenue.
num_imagesfacultatif num_outputs
Typeinteger
Par défaut1
1 – 8
Définissez le nombre d’images produites par une seule requête, en accordant davantage de temps de génération aux lots plus volumineux.
enable_safety_checkerfacultatif
Typeboolean
Par défautfalse
Activation du vérificateur 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 par passe en définissant cette valeur à true; les latents de chaque passe sont alors enregistrés.
requis 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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie dans notre stockage : conservée indéfiniment (facturation par Go-mois) ou pendant 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Même structure pour chaque modèletype, url, content_type, width, height et duration, pour les images, les vidéos et les fichiers 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 de fichier pour les images générées.
seed
integerGraine de génération d’image, incluant la valeur choisie aléatoirement si l’entrée n’a pas fourni 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 enregistrées à des fins de débogage.
debug_per_pass_latents
object {url, content_type, file_name, file_size} | nullDonnées latentes par passe enregistrées à des fins de débogage.

Plus de modèles : Texte vers image

Pour les agents IA : cette page en Markdown se trouve à https://doitong.com/fr-CA/developers/models/lora.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt