Saltar al cuntegna

Stable Diffusion with LoRAs · Image to Image

Integrar

ID dal model lora/image-to-image
# 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/image-to-image?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"

Questa dumonda: ≈$0,264 264 credits API Lantschar sin questa pagina

Obtegna ina clav API
Open model Modificaziun da maletgs Inputs da referenza #diffusion#lora#customization#fine-tuning

Image-to-image cun in model da basa Stable Diffusion tschernì, LoRAs e controlla da `noise_strength`

Open model · Maletg

Tes emprim resultat vegn qua

Construis ina dumonda sutvart e l'exequescha cun tia clav API. Outputs vegnan copiads en nossa memorisaziun, conservads per adina u 7 dis gratuitamain.

Construir ina dumonda

Ils controls vegnan generads dal schema dal model. Il code e ​​il pretsch s'actualiseschan durant che ti als midas.

•obligatori

Descriva il maletg che ti vuls generar, cun uschè blers detagls sco pussaivel per ils megliers resultats.

•obligatori

Model da basa per generar la maletg, identifitgà tras in URL u in ID HuggingFace.

num_images standard 1

Definir quants maletgs che ina singula dumonda producescha; in batch pli grond permetta dapli temp da generaziun.

Avanzà negative_prompt · image · 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 · noise_strength · 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
standard

Prompt negativ che specifica detagls da maletg betg giavischads. El po excluder colurs, objects, cuntradas u caracteristicas e qualitads pli finas, sco ina mustazza, sfuschadad u ina resoluziun bassa.

image_url
Trametta in datoteca u

URL dal maletg d’origin per la generaziun maletg-a-maletg u l’inpainting.

Trametta in datoteca u

Sfond cumpatibel cun il model per la generaziun da maletgs IC Light, furnì sco URL da maletg.

Trametta in datoteca u

URL dal maletg d’input per la generaziun cun il model IC Light.

prediction_type standard epsilon

Tscherner il tip da predicziun per generar maletgs; senza in’autra selecziun vegn utilisà `epsilon`.

image_format standard png

Format da datoteca dal maletg final.

Selecziun U-Net persunalisada per generar maletgs; furnescha ses ID HuggingFace u sia URL.

Selecziun da la varianta dal model HuggingFace; 'fp16' è in exempel.

Codader dal maletg inditgà tras ina URL HTTPS u in ID Hugging Face; la cumpatibilitad vegn determinada dals pais IP-Adapter: SD1.5 utilisescha image_encoder_subfolder='models/image_encoder', entant che h94/IP-Adapter SDXL utilisescha h94/IP-Adapter e image_encoder_subfolder='sdxl_models/image_encoder'. In codader è necessari sch’il valur da ip_adapter exista.

Sutdatoteca entaifer image_encoder_path che cuntegna ils pais dal codader dal maletg.

standard pytorch_model.bin

Tscherner ils pais dal codader dal maletg tenor num per generar maletgs.

URL dal model IC Light utilisà durant la generaziun da maletgs.

Scheduler u sampler utilisà per denoisar il maletg.

standard 0.5

Controllar il canun dal maletg agiuntà sin ina scala nua che 1.0 signifitga canun cumplett e valurs datiers da 0 canun minimal. Quai vala mo cun image_url furnì.

standard 30

Controlla quants pass da generaziun Stable Diffusion exequescha; pass supplementars pon producir in maletg final pli detaglià.

standard 7.5

Furza d'aderenza al prompt per la selecziun dal maletg, exprimida sco CFG (Classifier Free Guidance).

standard 0

Omet ina part da la generaziun dal maletg per render pli svelt, cun resultats levamain differents.

standard 4096

Definir la grondezza da mintga tile durant la generaziun da maletgs.

standard 4096

Definir la grondezza da mintga tile durant la generaziun da maletgs.

standard 2048

Definir la distanza tranter posiziuns successivas da tiles durant la generaziun da maletgs.

standard 2048

Definir la distanza tranter posiziuns successivas da tiles durant la generaziun da maletgs.

standard 0

Configuraziun Eta utilisada durant la generaziun da maletgs.

Seed per reproducir maletgs en Stable Diffusion. In maletg po vegnir reproducì exactamain en mintga execuziun sche la versiun dal model, il prompt ed il seed restan invariads.

standard []

LoRAs da las qualas l'effect cumina produce il maletg generà, senza limit dal dumber furnì.

standard []

Embeddings applitgads durant la generaziun da maletgs per mappar ils token dal prompt a las ponderaziuns d’embedding. Actualmain è sustegnì mo in embedding.

standard []

Control nets planisads per l’applicaziun al maletg durant la generaziun, a timesteps spezificads, senza limit da quantas entradas che vegnan furnidas.

standard []

Adapters IP utilisads per generar maletgs. Mintga entrada pretenda image_encoder_path.

standard {"array":[],"method":...

Surdefiniziun dal plan da timesteps da denoisaziun, exclusiva cun sigmas. Senza surdefiniziun—la configuraziun standard—calculescha il scheduler ils timesteps da num_inference_steps; cun in plan persunalizà daventa num_inference_steps irrelevant. La surdefiniziun pretenda il sustegn dal scheduler per l’argument timesteps da set_timesteps.

standard {"array":[],"method":...

Surdefiniziun dal plan da sigma da denoisaziun, exclusiva cun timesteps. Senza surdefiniziun—la configuraziun standard—calculescha il scheduler las sigmas da num_inference_steps; cun in plan persunalizà daventa num_inference_steps irrelevant. La surdefiniziun pretenda il sustegn dal scheduler per l’argument sigmas da set_sigmas.

POST /run/lora/image-to-image?wait=20 calculaziun → $0,264
# 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/image-to-image?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"

Executar questa dumonda

Tia clav resta en quest browser: ella vegn tramessa mo al Doitong API e memorisada (localStorage) mo sch'ella scheccas Tiar a memoria. Obtegnair ina clav API

Davart Stable Diffusion with LoRAs · Image to Image

Transfurma in `image_url` d'entrada cun in model Stable Diffusion tschernì, configurà tras `model_name`. `noise_strength` da 0 fin a 1 fixescha quant lunsch il resultat divergescha da la funtauna. Sustegna LoRAs fusiunads, embeddings, ControlNets, IP adapters e blers schedulers. Producescha 1 fin a 8 maletgs en png u jpeg.

Parameters

Invia u il num canonic u il num nativ, betg omaduas. Nums canonics

NumTip StandardPermess Descripziun
model_nameobligatori
Tipstring
Model da basa per generar la maletg, identifitgà tras in URL u in ID HuggingFace.
unet_nameopziunal
Tipstring | null
Selecziun U-Net persunalisada per generar maletgs; furnescha ses ID HuggingFace u sia URL.
variantopziunal
Tipstring | null
Selecziun da la varianta dal model HuggingFace; 'fp16' è in exempel.
promptobligatori
Tipstring
Descriva il maletg che ti vuls generar, cun uschè blers detagls sco pussaivel per ils megliers resultats.
negative_promptopziunal
Tipstring
Standard
Prompt negativ che specifica detagls da maletg betg giavischads. El po excluder colurs, objects, cuntradas u caracteristicas e qualitads pli finas, sco ina mustazza, sfuschadad u ina resoluziun bassa.
prompt_weightingopziunal
Tipboolean
Standardfalse
Interrupziun da ponderaziun dal prompt: true removescha il limit da 77 token tras la mediaziun d’embeddings e activa la sintaxa da ponderaziun.
image_urlopziunal image
Tipurl · image
URL dal maletg d’origin per la generaziun maletg-a-maletg u l’inpainting.
noise_strengthopziunal
Tipnumber
Standard0.5
≤ 1> 0
Controllar il canun dal maletg agiuntà sin ina scala nua che 1.0 signifitga canun cumplett e valurs datiers da 0 canun minimal. Quai vala mo cun image_url furnì.
lorasopziunal
Tipobject[]
Standard[]
LoRAs da las qualas l'effect cumina produce il maletg generà, senza limit dal dumber furnì.
loras[].pathobligatori
Tipstring
Lieu dals pais da LoRA, specificà sco URL u percurs.
loras[].scaleopziunal
Tipnumber
Standard1
0 – 4
Multiplicatur applitgà al pais da LoRA avant che quel vegn fusiunà en il model da basa.
embeddingsopziunal
Tipobject[]
Standard[]
Embeddings applitgads durant la generaziun da maletgs per mappar ils token dal prompt a las ponderaziuns d’embedding. Actualmain è sustegnì mo in embedding.
embeddings[].pathobligatori
Tipstring
Ponderaziuns da l'embedding specifitgadas tras URL u tschep da datoteca.
embeddings[].tokensopziunal
Tipstring[]
Ils token dal prompt vegnan mappads a ponderaziuns d’embedding. Sche vegnan omess, vegn creat in token per mintga vector dal datoteca d’embedding, numnads <s0>, <s1>, ...; utilisai ils token mappads en vos prompts.
controlnetsopziunal
Tipobject[]
Standard[]
Control nets planisads per l’applicaziun al maletg durant la generaziun, a timesteps spezificads, senza limit da quantas entradas che vegnan furnidas.
controlnets[].pathobligatori
Tipstring
Lieu da la ponderaziun ControlNet, inditgà sco URL u via.
controlnets[].config_urlopziunal
Tipstring | null
URL facultativ che mussa il datoteca config.json da ControlNet.
controlnets[].variantopziunal
Tipstring | null
Varianta facultativa per l'utilisaziun cun ina clav da repositori Hugging Face.
controlnets[].image_urlobligatori
Tipurl · image
URL dal maletg furnì sco input dal ControlNet.
controlnets[].mask_urlopziunal
Tipurl · image
Masca dal ControlNet; sch’ella vegn furnida, sto ella avair la medema grondezza sco il maletg da controlla; ladezza ed autezza ston esser divisiblas cun 32.
controlnets[].conditioning_scaleopziunal
Tipnumber
Standard1
0 – 2
Scalaziun applitgada a las ponderaziuns ControlNet avant ch'ellas vegnan fusiunadas cun il model da basa.
controlnets[].start_percentageopziunal
Tipnumber
Standard0
0 – 1
Per tschient dal total da pass temporals nua che ControlNet cumenza a influenzar la generaziun dal maletg.
controlnets[].end_percentageopziunal
Tipnumber
Standard1
0 – 1
Per tschient dal total da pass temporals nua che ControlNet chalenda d'influenzar la generaziun dal maletg.
controlnets[].ip_adapter_indexopziunal
Tipinteger | null
Selecziun da l’adapter IP tenor index per in ControlNet InstantID; auters ControlNets na dovran betg questa configuraziun.
controlnet_guess_modeopziunal
Tipboolean
Standardfalse
Limitescha l’applicaziun dal ControlNet a predicziuns cundiziunalas sch’il valur è true.
ip_adapteropziunal
Tipobject[]
Standard[]
Adapters IP utilisads per generar maletgs. Mintga entrada pretenda image_encoder_path.
ip_adapter[].ip_adapter_image_urlobligatori
Tipurl · image
URL dal maletg furnì sco input da l’adapter IP.
ip_adapter[].ip_adapter_mask_urlopziunal
Tipurl · image
Masca da l’adapter IP; sch’ella vegn furnida, ston sias dimensiuns correspunder a quellas dal maletg da l’adapter.
ip_adapter[].pathobligatori
Tipstring
Lieu dals pais da l’adapter IP, inditgà sco URL u path.
ip_adapter[].model_subfolderopziunal
Tipstring | null
Lieu dals pais da l’adapter IP, inditgà sco sutdatoteca en la datoteca dal model.
ip_adapter[].weight_nameopziunal
Tipstring | null
Num da la datoteca dals pais.
ip_adapter[].insight_face_model_pathopziunal
Tipstring | null
Lieu dals pais dal model InsightFace, inditgà sco URL u path.
ip_adapter[].scaleopziunal
Tipnumber
Standard1
≥ 0
Factor da scala per ils pais da l’adapter IP, applitgà avant ch’els vegnan unids al model da basa.
ip_adapter[].scale_jsonopziunal
Tipobject | null
Factor da scala per ils pais da l’adapter IP, applitgà avant ch’els vegnan unids al model da basa.
ip_adapter[].unconditional_noising_factoropziunal
Tipnumber
Standard0
0 – 1
Factor che controlla il noisiar nuncondiziunal per l’adapter IP.
ip_adapter[].image_projection_shortcutopziunal
Tipboolean
Standardtrue
Configuraziun dal shortcut da proiecziun dal maletg, cun True sco standard. Utilisai False per models FaceID plus V1 e True per models FaceID plus V2.
image_encoder_pathopziunal
Tipstring | null
Codader dal maletg inditgà tras ina URL HTTPS u in ID Hugging Face; la cumpatibilitad vegn determinada dals pais IP-Adapter: SD1.5 utilisescha image_encoder_subfolder='models/image_encoder', entant che h94/IP-Adapter SDXL utilisescha h94/IP-Adapter e image_encoder_subfolder='sdxl_models/image_encoder'. In codader è necessari sch’il valur da ip_adapter exista.
image_encoder_subfolderopziunal
Tipstring | null
Sutdatoteca entaifer image_encoder_path che cuntegna ils pais dal codader dal maletg.
image_encoder_weight_nameopziunal
Tipstring | null
Standardpytorch_model.bin
Tscherner ils pais dal codader dal maletg tenor num per generar maletgs.
ic_light_model_urlopziunal
Tipstring | null
URL dal model IC Light utilisà durant la generaziun da maletgs.
ic_light_model_background_image_urlopziunal
Tipurl · image
Sfond cumpatibel cun il model per la generaziun da maletgs IC Light, furnì sco URL da maletg.
ic_light_image_urlopziunal
Tipurl · image
URL dal maletg d’input per la generaziun cun il model IC Light.
seedopziunal
Tipinteger | null
Seed per reproducir maletgs en Stable Diffusion. In maletg po vegnir reproducì exactamain en mintga execuziun sche la versiun dal model, il prompt ed il seed restan invariads.
num_inference_stepsopziunal
Tipinteger
Standard30
1 – 150
Controlla quants pass da generaziun Stable Diffusion exequescha; pass supplementars pon producir in maletg final pli detaglià.
guidance_scaleopziunal
Tipnumber
Standard7.5
0 – 20
Furza d'aderenza al prompt per la selecziun dal maletg, exprimida sco CFG (Classifier Free Guidance).
clip_skipopziunal
Tipinteger
Standard0
0 – 2
Omet ina part da la generaziun dal maletg per render pli svelt, cun resultats levamain differents.
scheduleropziunal
Tipenum
DPM++ 2MDPM++ 2M KarrasDPM++ 2M SDEDPM++ 2M SDE KarrasEulerEuler AEuler (trailing timesteps)LCMLCM (trailing timesteps)DDIMTCD
Scheduler u sampler utilisà per denoisar il maletg.
timestepsopziunal
Tipobject
Standard{"array":[],"method":"default"}
Surdefiniziun dal plan da timesteps da denoisaziun, exclusiva cun sigmas. Senza surdefiniziun—la configuraziun standard—calculescha il scheduler ils timesteps da num_inference_steps; cun in plan persunalizà daventa num_inference_steps irrelevant. La surdefiniziun pretenda il sustegn dal scheduler per l’argument timesteps da set_timesteps.
timesteps.methodopziunal
Tipenum
Standarddefault
defaultarray
Tscherner co determinar ils timesteps: 'default', la configuraziun standard, permetta al scheduler d’utilisar `num_inference_steps`. Per furnir sez in plan, tschernai 'array' e mettai il plan en il champ `array`.
timesteps.arrayopziunal
Tipinteger[]
Standard[]
Plan da timesteps applitgà sch’il metod tschernì è 'custom'.
sigmasopziunal
Tipobject
Standard{"array":[],"method":"default"}
Surdefiniziun dal plan da sigma da denoisaziun, exclusiva cun timesteps. Senza surdefiniziun—la configuraziun standard—calculescha il scheduler las sigmas da num_inference_steps; cun in plan persunalizà daventa num_inference_steps irrelevant. La surdefiniziun pretenda il sustegn dal scheduler per l’argument sigmas da set_sigmas.
sigmas.methodopziunal
Tipenum
Standarddefault
defaultarray
Tscherner co determinar las sigmas: 'default', la configuraziun standard, utilisescha ils agens valurs da sigma dal scheduler. Per furnir sez in plan, tschernai 'custom' e mettai il plan en il champ `array`.
sigmas.arrayopziunal
Tipnumber[]
Standard[]
Plan da sigma applitgà sch’il metod tschernì è 'custom'.
prediction_typeopziunal
Tipenum
Standardepsilon
v_predictionepsilon
Tscherner il tip da predicziun per generar maletgs; senza in’autra selecziun vegn utilisà `epsilon`.
rescale_betas_snr_zeroopziunal
Tipboolean
Standardfalse
Controlla sch’il sampler activa rescale_betas_snr_zero.
image_formatopziunal
Tipenum
Standardpng
jpegpng
Format da datoteca dal maletg final.
num_imagesopziunal num_outputs
Tipinteger
Standard1
1 – 8
Definir quants maletgs che ina singula dumonda producescha; in batch pli grond permetta dapli temp da generaziun.
enable_safety_checkeropziunal
Tipboolean
Standardfalse
Activaziun da la controlla da segirezza; true activa la controlla.
tile_widthopziunal
Tipinteger
Standard4096
128 – 4 096
Definir la grondezza da mintga tile durant la generaziun da maletgs.
tile_heightopziunal
Tipinteger
Standard4096
128 – 4 096
Definir la grondezza da mintga tile durant la generaziun da maletgs.
tile_stride_widthopziunal
Tipinteger
Standard2048
64 – 2 048
Definir la distanza tranter posiziuns successivas da tiles durant la generaziun da maletgs.
tile_stride_heightopziunal
Tipinteger
Standard2048
64 – 2 048
Definir la distanza tranter posiziuns successivas da tiles durant la generaziun da maletgs.
etaopziunal
Tipnumber
Standard0
0 – 1
Configuraziun Eta utilisada durant la generaziun da maletgs.
debug_latentsopziunal
Tipboolean
Standardfalse
Memorisar ils latents per il debugging sch’il valur è true.
debug_per_pass_latentsopziunal
Tipboolean
Standardfalse
Activar il debugging per mintga pass cun definir true; quai memorisescha ils latents da mintga pass.
obligatori Num canonic, er acceptà

Ils parameters da datotecas acceptan ina URL publica https://, ina URI data: fin a 10 MB u il file_url d'ina chargiada. Datotecas

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "lora/image-to-image",
  "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": 264,
    "usd": "0.264",
    "charged": 264,
    "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"
  }
}
Tias datotecas, tia decisiunMintga outputs[].url è ina copia en nossa memorisaziun: conservada per adina (pajà per GB-mes) u 7 dis gratuitamain, tenor la configuraziun dal conto u ?storage=.
La medema structura per mintga modeltype, url, content_type, width, height e duration, tant per maletgs sco per video e audio. output è l'object da resultat dal model sez.
Champs da l'output
images
array of object {url, content_type, file_name, file_size, width, height}Infurmaziuns da la datoteca per ils maletgs generads.
seed
integerSeed da la generaziun dal maletg, inclusa la valur tschernida casualmain sche l'input n'ha betg furnì in seed; autramain repeta la valur furnida.
has_nsfw_concepts
array of booleanInditgescha sche concepts NSFW cumparan en ils maletgs generads.
debug_latents
object {url, content_type, file_name, file_size} | nullDatas latentas memorisadas per il debugging.
debug_per_pass_latents
object {url, content_type, file_name, file_size} | nullDatas latentas per pass memorisadas per il debugging.

Dapli models: Modificaziun da maletgs

Per agents AI: questa pagina sco Markdown è disponibla sut https://doitong.com/rm/developers/models/lora/image-to-image.md. Tut ils models e las guidas: https://doitong.com/developers/llms.txt