Avançar para o conteúdo

Stable Diffusion with LoRAs

Integrar

ID do modelo 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"

Este pedido: ≈0,057 $ 57 créditos da API Executar nesta página

Obter chave de API
Open model Texto para imagem Entradas de referência #diffusion#lora#customization

Texto para imagem com qualquer modelo base Stable Diffusion, além de LoRAs, embeddings, ControlNets e adaptadores IP

Open model · Imagem

O seu primeiro resultado aparece aqui

Crie um pedido abaixo e execute-o com a sua chave de API. As saídas são copiadas para o nosso armazenamento, guardadas para sempre ou durante 7 dias gratuitamente.

Criar um pedido

Os controlos são gerados a partir do esquema do modelo. O código e o preço são atualizados à medida que os altera.

•obrigatório

Descreva a imagem que pretende gerar, utilizando o máximo de detalhe possível para obter os melhores resultados.

image_size predefinição square_hd

Dimensões da imagem de saída, selecionadas a partir de predefinições ou especificadas como largura e altura personalizadas. Ambas as dimensões personalizadas têm de ser divisíveis por 8.

•obrigatório

Modelo base para gerar a imagem, identificado por um URL ou um ID do HuggingFace.

num_images predefinição 1

Defina quantas imagens um único pedido produz, permitindo mais tempo de geração para um lote maior.

Avançado 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
predefinição

Negative prompt que especifica detalhes de imagem indesejados. Pode excluir cores, objetos, cenários ou características e qualidades mais finas, como um bigode, desfocagem ou baixa resolução.

Largue um ficheiro ou

Fundo compatível com o modelo para a geração de imagens IC Light, fornecido como URL de imagem.

Largue um ficheiro ou

URL da imagem de entrada para geração com o modelo IC Light.

prediction_type predefinição epsilon

Escolha o tipo de previsão para gerar imagens; sem outra seleção, é utilizado `epsilon`.

image_format predefinição png

Formato de ficheiro da imagem resultante.

Seleção personalizada de U-Net para gerar imagens; forneça o respetivo ID do HuggingFace ou a URL.

Seleção da variante do modelo HuggingFace; 'fp16' é um exemplo.

Codificador de imagem especificado por um URL HTTPS ou ID do Hugging Face, cuja compatibilidade é determinada pelos pesos do IP-Adapter: SD1.5 usa image_encoder_subfolder='models/image_encoder', enquanto h94/IP-Adapter SDXL usa h94/IP-Adapter e image_encoder_subfolder='sdxl_models/image_encoder'. É necessário um codificador sempre que ip_adapter contém um valor.

Subdiretório dentro de image_encoder_path que contém os pesos do codificador de imagem.

predefinição pytorch_model.bin

Selecione os pesos do codificador de imagem pelo nome para os utilizar na geração de imagens.

URL do modelo IC Light utilizado ao gerar imagens.

Agendador ou amostrador usado para reduzir o ruído da imagem.

predefinição 30

Controla quantos passos de geração o Stable Diffusion executa; passos adicionais podem produzir uma imagem final mais detalhada.

predefinição 7.5

Intensidade de adesão ao prompt para seleção de imagens, expressa como CFG (Classifier Free Guidance).

predefinição 0

Ignora uma parte da geração da imagem para renderizar mais rapidamente, produzindo resultados ligeiramente diferentes.

predefinição 4096

Defina o tamanho de cada mosaico durante a geração de imagens.

predefinição 4096

Defina o tamanho de cada mosaico durante a geração de imagens.

predefinição 2048

Defina o espaçamento entre posições sucessivas dos mosaicos durante a geração de imagens.

predefinição 2048

Defina o espaçamento entre posições sucessivas dos mosaicos durante a geração de imagens.

predefinição 0

Definição Eta utilizada ao gerar imagens.

Seed para reproduzir imagens no Stable Diffusion. Uma imagem pode ser reproduzida exatamente em cada execução mantendo inalteradas a versão do modelo, o prompt e a seed.

predefinição []

LoRAs cujo efeito combinado produz a imagem gerada, sem limite quanto ao número fornecido.

predefinição []

Embeddings aplicados durante a geração de imagens para mapear tokens do prompt para pesos de embeddings. Atualmente, só é suportado um embedding.

predefinição []

Control nets agendados para aplicação à imagem nos timesteps especificados durante a geração, sem limite para o número fornecido.

predefinição []

Adaptadores IP utilizados para gerar imagens. O fornecimento de qualquer entrada requer image_encoder_path.

predefinição {"array":[],"method":...

Substituição do agendamento de timesteps de remoção de ruído, mutuamente exclusiva com sigmas. Sem substituição — a predefinição — o scheduler calcula os timesteps a partir de num_inference_steps; fornecer um agendamento personalizado torna num_inference_steps irrelevante. A substituição requer suporte do scheduler para o argumento timesteps de set_timesteps.

predefinição {"array":[],"method":...

Substituição do agendamento de sigmas de remoção de ruído, mutuamente exclusiva com timesteps. Sem substituição — a predefinição — o scheduler calcula as sigmas a partir de num_inference_steps; fornecer um agendamento personalizado torna num_inference_steps irrelevante. A substituição requer suporte do scheduler para o argumento sigmas de set_sigmas.

POST /run/lora?wait=20 cotação → 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"

Executar este pedido

A sua chave permanece neste navegador: é enviada apenas para a Doitong API e guardada em localStorage apenas se selecionar Lembrar. Obter uma chave de API

Sobre Stable Diffusion with LoRAs

Gera imagens a partir de um prompt de texto utilizando um modelo base fornecido por URL ou ID do HuggingFace em `model_name`. Podem ser combinadas várias `loras`, e são suportados embeddings, ControlNets, adaptadores IP e entradas IC Light. As opções de amostragem incluem vários schedulers e passos de 1 a 150. Gera 1 a 8 imagens em png ou jpeg.

Parâmetros

Envie o nome canónico ou o nome nativo, não ambos. Nomes canónicos

NomeTipo PredefiniçãoPermitido Descrição
model_nameobrigatório
Tipostring
Modelo base para gerar a imagem, identificado por um URL ou um ID do HuggingFace.
unet_nameopcional
Tipostring | null
Seleção personalizada de U-Net para gerar imagens; forneça o respetivo ID do HuggingFace ou a URL.
variantopcional
Tipostring | null
Seleção da variante do modelo HuggingFace; 'fp16' é um exemplo.
promptobrigatório
Tipostring
Descreva a imagem que pretende gerar, utilizando o máximo de detalhe possível para obter os melhores resultados.
negative_promptopcional
Tipostring
Predefinição
Negative prompt que especifica detalhes de imagem indesejados. Pode excluir cores, objetos, cenários ou características e qualidades mais finas, como um bigode, desfocagem ou baixa resolução.
prompt_weightingopcional
Tipoboolean
Predefiniçãofalse
Ativação do peso do prompt: true remove o limite de 77 tokens através da média de embeddings e ativa a sintaxe de ponderação.
lorasopcional
Tipoobject[]
Predefinição[]
LoRAs cujo efeito combinado produz a imagem gerada, sem limite quanto ao número fornecido.
loras[].pathobrigatório
Tipostring
Localização dos pesos LoRA, especificada como URL ou caminho.
loras[].scaleopcional
Tiponumber
Predefinição1
0 – 4
Multiplicador aplicado ao peso LoRA antes de este ser fundido no modelo base.
embeddingsopcional
Tipoobject[]
Predefinição[]
Embeddings aplicados durante a geração de imagens para mapear tokens do prompt para pesos de embeddings. Atualmente, só é suportado um embedding.
embeddings[].pathobrigatório
Tipostring
Pesos dos embeddings especificados por URL ou caminho do ficheiro.
embeddings[].tokensopcional
Tipostring[]
Tokens do prompt mapeados para pesos de embeddings. Se forem omitidos, é criado um token por vetor do ficheiro de embeddings, com os nomes <s0>, <s1>, ...; use os tokens mapeados nos prompts.
controlnetsopcional
Tipoobject[]
Predefinição[]
Control nets agendados para aplicação à imagem nos timesteps especificados durante a geração, sem limite para o número fornecido.
controlnets[].pathobrigatório
Tipostring
Localização dos pesos do ControlNet, especificada como um URL ou caminho.
controlnets[].config_urlopcional
Tipostring | null
URL opcional para o ficheiro config.json do ControlNet.
controlnets[].variantopcional
Tipostring | null
Variante opcional para utilização com uma chave de repositório Hugging Face.
controlnets[].image_urlobrigatório
Tipourl · image
URL da imagem fornecida como entrada do ControlNet.
controlnets[].mask_urlopcional
Tipourl · image
Máscara do ControlNet, que deve ter o mesmo tamanho da imagem de controlo quando fornecida; a largura e a altura devem ser divisíveis por 32.
controlnets[].conditioning_scaleopcional
Tiponumber
Predefinição1
0 – 2
Escala aplicada aos pesos do ControlNet antes de serem integrados no modelo base.
controlnets[].start_percentageopcional
Tiponumber
Predefinição0
0 – 1
Percentagem do total de passos temporais em que o ControlNet começa a influenciar a geração da imagem.
controlnets[].end_percentageopcional
Tiponumber
Predefinição1
0 – 1
Percentagem do total de passos temporais em que o ControlNet deixa de influenciar a geração da imagem.
controlnets[].ip_adapter_indexopcional
Tipointeger | null
Seleção do adaptador IP por índice para um ControlNet InstantID; os outros ControlNets não precisam desta definição.
controlnet_guess_modeopcional
Tipoboolean
Predefiniçãofalse
Restringe a aplicação do ControlNet a previsões condicionais quando definido como true.
ip_adapteropcional
Tipoobject[]
Predefinição[]
Adaptadores IP utilizados para gerar imagens. O fornecimento de qualquer entrada requer image_encoder_path.
ip_adapter[].ip_adapter_image_urlobrigatório
Tipourl · image
URL da imagem fornecida como entrada do adaptador IP.
ip_adapter[].ip_adapter_mask_urlopcional
Tipourl · image
Máscara do adaptador IP, sujeita a uma restrição de tamanho quando fornecida: as dimensões devem ser iguais às da imagem do adaptador.
ip_adapter[].pathobrigatório
Tipostring
Localização dos pesos do adaptador IP, especificada como URL ou caminho.
ip_adapter[].model_subfolderopcional
Tipostring | null
Localização dos pesos do adaptador IP, especificada como subpasta dentro do diretório do modelo.
ip_adapter[].weight_nameopcional
Tipostring | null
Nome do ficheiro dos pesos.
ip_adapter[].insight_face_model_pathopcional
Tipostring | null
Localização dos pesos do modelo InsightFace, especificada como URL ou caminho.
ip_adapter[].scaleopcional
Tiponumber
Predefinição1
≥ 0
Fator de escala dos pesos do adaptador IP, aplicado antes de serem integrados no modelo base.
ip_adapter[].scale_jsonopcional
Tipoobject | null
Fator de escala dos pesos do adaptador IP, aplicado antes de serem integrados no modelo base.
ip_adapter[].unconditional_noising_factoropcional
Tiponumber
Predefinição0
0 – 1
Fator que controla o ruído não condicional do adaptador IP.
ip_adapter[].image_projection_shortcutopcional
Tipoboolean
Predefiniçãotrue
Definição do atalho de projeção da imagem, com True como predefinição. Use False para modelos FaceID plus V1 e True para modelos FaceID plus V2.
image_encoder_pathopcional
Tipostring | null
Codificador de imagem especificado por um URL HTTPS ou ID do Hugging Face, cuja compatibilidade é determinada pelos pesos do IP-Adapter: SD1.5 usa image_encoder_subfolder='models/image_encoder', enquanto h94/IP-Adapter SDXL usa h94/IP-Adapter e image_encoder_subfolder='sdxl_models/image_encoder'. É necessário um codificador sempre que ip_adapter contém um valor.
image_encoder_subfolderopcional
Tipostring | null
Subdiretório dentro de image_encoder_path que contém os pesos do codificador de imagem.
image_encoder_weight_nameopcional
Tipostring | null
Predefiniçãopytorch_model.bin
Selecione os pesos do codificador de imagem pelo nome para os utilizar na geração de imagens.
ic_light_model_urlopcional
Tipostring | null
URL do modelo IC Light utilizado ao gerar imagens.
ic_light_model_background_image_urlopcional
Tipourl · image
Fundo compatível com o modelo para a geração de imagens IC Light, fornecido como URL de imagem.
ic_light_image_urlopcional
Tipourl · image
URL da imagem de entrada para geração com o modelo IC Light.
seedopcional
Tipointeger | null
Seed para reproduzir imagens no Stable Diffusion. Uma imagem pode ser reproduzida exatamente em cada execução mantendo inalteradas a versão do modelo, o prompt e a seed.
image_sizeopcional
Tipoobject
Predefiniçãosquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensões da imagem de saída, selecionadas a partir de predefinições ou especificadas como largura e altura personalizadas. Ambas as dimensões personalizadas têm de ser divisíveis por 8.
num_inference_stepsopcional
Tipointeger
Predefinição30
1 – 150
Controla quantos passos de geração o Stable Diffusion executa; passos adicionais podem produzir uma imagem final mais detalhada.
guidance_scaleopcional
Tiponumber
Predefinição7.5
0 – 20
Intensidade de adesão ao prompt para seleção de imagens, expressa como CFG (Classifier Free Guidance).
clip_skipopcional
Tipointeger
Predefinição0
0 – 2
Ignora uma parte da geração da imagem para renderizar mais rapidamente, produzindo resultados ligeiramente diferentes.
scheduleropcional
Tipoenum
DPM++ 2MDPM++ 2M KarrasDPM++ 2M SDEDPM++ 2M SDE KarrasEulerEuler AEuler (trailing timesteps)LCMLCM (trailing timesteps)DDIMTCD
Agendador ou amostrador usado para reduzir o ruído da imagem.
timestepsopcional
Tipoobject
Predefinição{"array":[],"method":"default"}
Substituição do agendamento de timesteps de remoção de ruído, mutuamente exclusiva com sigmas. Sem substituição — a predefinição — o scheduler calcula os timesteps a partir de num_inference_steps; fornecer um agendamento personalizado torna num_inference_steps irrelevante. A substituição requer suporte do scheduler para o argumento timesteps de set_timesteps.
timesteps.methodopcional
Tipoenum
Predefiniçãodefault
defaultarray
Escolha como os timesteps são determinados: 'default', a definição predefinida, permite que o scheduler use `num_inference_steps`. Para fornecer manualmente um agendamento de timesteps, selecione 'array' e coloque o agendamento no campo `array`.
timesteps.arrayopcional
Tipointeger[]
Predefinição[]
Agendamento de timesteps aplicado quando o método selecionado é 'custom'.
sigmasopcional
Tipoobject
Predefinição{"array":[],"method":"default"}
Substituição do agendamento de sigmas de remoção de ruído, mutuamente exclusiva com timesteps. Sem substituição — a predefinição — o scheduler calcula as sigmas a partir de num_inference_steps; fornecer um agendamento personalizado torna num_inference_steps irrelevante. A substituição requer suporte do scheduler para o argumento sigmas de set_sigmas.
sigmas.methodopcional
Tipoenum
Predefiniçãodefault
defaultarray
Escolha como as sigmas são determinadas: 'default', a definição predefinida, usa os valores de sigma do próprio scheduler. Para fornecer manualmente um agendamento de sigma, selecione 'custom' e coloque o agendamento no campo `array`.
sigmas.arrayopcional
Tiponumber[]
Predefinição[]
Agendamento de sigma aplicado quando o método selecionado é 'custom'.
prediction_typeopcional
Tipoenum
Predefiniçãoepsilon
v_predictionepsilon
Escolha o tipo de previsão para gerar imagens; sem outra seleção, é utilizado `epsilon`.
rescale_betas_snr_zeroopcional
Tipoboolean
Predefiniçãofalse
Controla se o sampler ativa rescale_betas_snr_zero.
image_formatopcional
Tipoenum
Predefiniçãopng
jpegpng
Formato de ficheiro da imagem resultante.
num_imagesopcional num_outputs
Tipointeger
Predefinição1
1 – 8
Defina quantas imagens um único pedido produz, permitindo mais tempo de geração para um lote maior.
enable_safety_checkeropcional
Tipoboolean
Predefiniçãofalse
Ativação do verificador de segurança; true ativa a verificação.
tile_widthopcional
Tipointeger
Predefinição4096
128 – 4096
Defina o tamanho de cada mosaico durante a geração de imagens.
tile_heightopcional
Tipointeger
Predefinição4096
128 – 4096
Defina o tamanho de cada mosaico durante a geração de imagens.
tile_stride_widthopcional
Tipointeger
Predefinição2048
64 – 2048
Defina o espaçamento entre posições sucessivas dos mosaicos durante a geração de imagens.
tile_stride_heightopcional
Tipointeger
Predefinição2048
64 – 2048
Defina o espaçamento entre posições sucessivas dos mosaicos durante a geração de imagens.
etaopcional
Tiponumber
Predefinição0
0 – 1
Definição Eta utilizada ao gerar imagens.
debug_latentsopcional
Tipoboolean
Predefiniçãofalse
Guarda os latentes para depuração quando definido como true.
debug_per_pass_latentsopcional
Tipoboolean
Predefiniçãofalse
Ative a depuração por passagem definindo isto como true; os latentes de cada passagem serão guardados.
obrigatório Nome canónico, também aceite

Os parâmetros de ficheiro aceitam um URL https:// público, um URI data: até 10 MB ou o file_url de um carregamento. Ficheiros

Resultado

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"
  }
}
Os seus ficheiros, a sua escolhaCada outputs[].url é uma cópia no nosso armazenamento: guardada para sempre (paga por GB-mês) ou durante 7 dias gratuitamente, conforme a definição da sua conta ou ?storage=.
A mesma estrutura em todos os modelostype, url, content_type, width, height e duration, tanto para imagens como para vídeo e áudio. output é o próprio objeto de resultado do modelo.
Campos do resultado
images
array of object {url, content_type, file_name, file_size, width, height}Informações dos ficheiros das imagens geradas.
seed
integerSeed da geração de imagens, incluindo o valor escolhido aleatoriamente se a entrada não tiver fornecido uma seed; caso contrário, repete o valor fornecido.
has_nsfw_concepts
array of booleanIndica se aparecem conceitos NSFW nas imagens geradas.
debug_latents
object {url, content_type, file_name, file_size} | nullDados latentes guardados para depuração.
debug_per_pass_latents
object {url, content_type, file_name, file_size} | nullDados latentes por passagem guardados para depuração.

Mais modelos: Texto para imagem

Para agentes de IA: esta página em Markdown está disponível em https://doitong.com/pt-PT/developers/models/lora.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt