Ir 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.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"

Esta solicitação: ≈$ 0,057 57 créditos de API · ≈ ₽ 6,01 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

Seu primeiro resultado aparecerá aqui

Monte uma requisição abaixo e execute-a com sua chave de API. As saídas são copiadas para nosso armazenamento, mantidas para sempre ou por 7 dias gratuitamente.

Criar uma solicitação

Os controles são gerados a partir do esquema do modelo. O código e o preço são atualizados conforme você os altera.

•obrigatório

Descreva a imagem que deseja gerar com o máximo de detalhes possível para obter os melhores resultados.

image_size padrão square_hd

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

•obrigatório

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

num_images padrão 1

Defina quantas imagens uma única requisição 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
padrão

Prompt negativo que especifica detalhes indesejados da imagem. Ele pode excluir cores, objetos, cenários ou características e qualidades mais sutis, como bigode, desfoque ou baixa resolução.

Solte um arquivo ou

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

Solte um arquivo ou

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

prediction_type padrão epsilon

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

image_format padrão png

Formato de arquivo da imagem resultante.

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

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

Codificador de imagem especificado por uma URL HTTPS ou um ID do Hugging Face, com 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 contiver um valor.

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

padrão pytorch_model.bin

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

URL do modelo IC Light usada durante a geração de imagens.

Scheduler ou sampler usado para remover o ruído da imagem.

padrão 30

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

padrão 7.5

Intensidade de aderência ao prompt para seleção de imagem, expressa como CFG (Classifier Free Guidance).

padrão 0

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

padrão 4096

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

padrão 4096

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

padrão 2048

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

padrão 2048

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

padrão 0

Configuração Eta usada durante a geração de imagens.

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

padrão []

LoRAs cujo efeito combinado produz a imagem gerada, sem limite para a quantidade fornecida.

padrão []

Embeddings aplicados durante a geração de imagem para mapear tokens do prompt a pesos de embedding. Atualmente, apenas um embedding é compatível.

padrão []

Control nets programados para aplicação à imagem em determinados timesteps durante a geração, sem limite para a quantidade fornecida.

padrão []

IP adapters usados para gerar imagens. Fornecer qualquer entrada exige image_encoder_path.

padrão {"array":[],"method":...

Substituição do agendamento de timesteps de remoção de ruído, mutuamente exclusiva com sigmas. Sem uma substituição — o padrão —, o scheduler calcula os timesteps a partir de num_inference_steps; fornecer um agendamento personalizado torna num_inference_steps irrelevante. A substituição exige que o scheduler seja compatível com o argumento timesteps de set_timesteps.

padrão {"array":[],"method":...

Substituição do agendamento de sigmas de remoção de ruído, mutuamente exclusiva com timesteps. Sem uma substituição — o padrão —, o scheduler calcula os sigmas a partir de num_inference_steps; fornecer um agendamento personalizado torna num_inference_steps irrelevante. A substituição exige que o scheduler seja compatível com 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.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"

Executar esta solicitação

Sua chave permanece neste navegador: ela é enviada somente à Doitong API e salva (localStorage) apenas se você marcar Lembrar. Obter uma chave de API

Sobre Stable Diffusion with LoRAs

Gera imagens a partir de um prompt de texto usando um modelo base fornecido por URL ou ID do HuggingFace em `model_name`. Várias `loras` podem ser mescladas, e há suporte a embeddings, ControlNets, adaptadores IP e entradas IC Light. As opções de amostragem incluem vários schedulers e de 1 a 150 passos. Gera de 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 PadrãoPermitido Descrição
model_nameobrigatório
Tipostring
Modelo base para gerar a imagem, identificado por uma URL ou um ID do HuggingFace.
unet_nameopcional
Tipostring | null
Seleção de U-Net personalizada para gerar imagens; forneça seu ID do HuggingFace ou sua URL.
variantopcional
Tipostring | null
Seleção da variante do modelo HuggingFace; 'fp16' é um exemplo.
promptobrigatório
Tipostring
Descreva a imagem que deseja gerar com o máximo de detalhes possível para obter os melhores resultados.
negative_promptopcional
Tipostring
Padrão
Prompt negativo que especifica detalhes indesejados da imagem. Ele pode excluir cores, objetos, cenários ou características e qualidades mais sutis, como bigode, desfoque ou baixa resolução.
prompt_weightingopcional
Tipoboolean
Padrãofalse
Alternância de ponderação do prompt: true remove o limite de 77 tokens por meio da média de embeddings e habilita a sintaxe de ponderação.
lorasopcional
Tipoobject[]
Padrão[]
LoRAs cujo efeito combinado produz a imagem gerada, sem limite para a quantidade fornecida.
loras[].pathobrigatório
Tipostring
Localização dos pesos da LoRA, especificada como URL ou caminho.
loras[].scaleopcional
Tiponumber
Padrão1
0 – 4
Multiplicador aplicado ao peso da LoRA antes de sua mesclagem ao modelo base.
embeddingsopcional
Tipoobject[]
Padrão[]
Embeddings aplicados durante a geração de imagem para mapear tokens do prompt a pesos de embedding. Atualmente, apenas um embedding é compatível.
embeddings[].pathobrigatório
Tipostring
Pesos dos embeddings especificados por URL ou caminho do arquivo.
embeddings[].tokensopcional
Tipostring[]
Tokens do prompt mapeados a pesos de embedding. Omiti-los cria um token por vetor do arquivo de embedding, nomeado <s0>, <s1>, ...; use os tokens mapeados nos prompts.
controlnetsopcional
Tipoobject[]
Padrão[]
Control nets programados para aplicação à imagem em determinados timesteps durante a geração, sem limite para a quantidade fornecida.
controlnets[].pathobrigatório
Tipostring
Local dos pesos do ControlNet, especificado como uma URL ou caminho.
controlnets[].config_urlopcional
Tipostring | null
URL opcional que aponta para o arquivo config.json do ControlNet.
controlnets[].variantopcional
Tipostring | null
Variante opcional para uso com uma chave de repositório do 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 corresponder ao tamanho da imagem de controle quando fornecida; a largura e a altura devem ser divisíveis por 32.
controlnets[].conditioning_scaleopcional
Tiponumber
Padrão1
0 – 2
Escala aplicada aos pesos do ControlNet antes de serem mesclados ao modelo base.
controlnets[].start_percentageopcional
Tiponumber
Padrão0
0 – 1
Porcentagem do total de timesteps em que o ControlNet começa a influenciar a geração da imagem.
controlnets[].end_percentageopcional
Tiponumber
Padrão1
0 – 1
Porcentagem do total de timesteps em que o ControlNet para de influenciar a geração da imagem.
controlnets[].ip_adapter_indexopcional
Tipointeger | null
Seleção do IP adapter por índice para um ControlNet InstantID; outros ControlNets não precisam desta configuração.
controlnet_guess_modeopcional
Tipoboolean
Padrãofalse
Restringe a aplicação do ControlNet a previsões condicionais quando true.
ip_adapteropcional
Tipoobject[]
Padrão[]
IP adapters usados para gerar imagens. Fornecer qualquer entrada exige image_encoder_path.
ip_adapter[].ip_adapter_image_urlobrigatório
Tipourl · image
URL da imagem fornecida como entrada do IP adapter.
ip_adapter[].ip_adapter_mask_urlopcional
Tipourl · image
Máscara do IP adapter, sujeita a uma restrição de tamanho quando fornecida: suas dimensões devem ser iguais às da imagem do adapter.
ip_adapter[].pathobrigatório
Tipostring
Localização dos pesos do IP adapter, especificada como URL ou caminho.
ip_adapter[].model_subfolderopcional
Tipostring | null
Localização dos pesos do IP adapter, especificada como subpasta dentro do diretório do modelo.
ip_adapter[].weight_nameopcional
Tipostring | null
Nome do arquivo 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
Padrão1
≥ 0
Fator de escala dos pesos do IP adapter, aplicado antes de serem mesclados ao modelo base.
ip_adapter[].scale_jsonopcional
Tipoobject | null
Fator de escala dos pesos do IP adapter, aplicado antes de serem mesclados ao modelo base.
ip_adapter[].unconditional_noising_factoropcional
Tiponumber
Padrão0
0 – 1
Fator que controla o ruído não condicional do IP adapter.
ip_adapter[].image_projection_shortcutopcional
Tipoboolean
Padrãotrue
Configuração do atalho de projeção da imagem, com True como padrã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 uma URL HTTPS ou um ID do Hugging Face, com 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 contiver 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
Padrãopytorch_model.bin
Selecione por nome os pesos do codificador de imagem para uso na geração de imagens.
ic_light_model_urlopcional
Tipostring | null
URL do modelo IC Light usada durante a geração de imagens.
ic_light_model_background_image_urlopcional
Tipourl · image
Fundo compatível com o modelo para geração de imagens com 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 inalterados a versão do modelo, o prompt e a seed.
image_sizeopcional
Tipoobject
Padrãosquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensões da imagem de saída, selecionadas entre predefinições ou especificadas como largura e altura personalizadas. Ambas as dimensões personalizadas devem ser divisíveis por 8.
num_inference_stepsopcional
Tipointeger
Padrão30
1 – 150
Controla quantas etapas de geração o Stable Diffusion executa; etapas adicionais podem produzir uma imagem final mais detalhada.
guidance_scaleopcional
Tiponumber
Padrão7.5
0 – 20
Intensidade de aderência ao prompt para seleção de imagem, expressa como CFG (Classifier Free Guidance).
clip_skipopcional
Tipointeger
Padrão0
0 – 2
Ignora parte da geração de 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
Scheduler ou sampler usado para remover o ruído da imagem.
timestepsopcional
Tipoobject
Padrão{"array":[],"method":"default"}
Substituição do agendamento de timesteps de remoção de ruído, mutuamente exclusiva com sigmas. Sem uma substituição — o padrão —, o scheduler calcula os timesteps a partir de num_inference_steps; fornecer um agendamento personalizado torna num_inference_steps irrelevante. A substituição exige que o scheduler seja compatível com o argumento timesteps de set_timesteps.
timesteps.methodopcional
Tipoenum
Padrãodefault
defaultarray
Escolha como os timesteps são determinados: 'default', a configuração padrão, permite que o scheduler use `num_inference_steps`. Para fornecer seu próprio agendamento de timesteps, selecione 'array' e coloque o agendamento no campo `array`.
timesteps.arrayopcional
Tipointeger[]
Padrão[]
Agendamento de timesteps aplicado quando o método selecionado é 'custom'.
sigmasopcional
Tipoobject
Padrão{"array":[],"method":"default"}
Substituição do agendamento de sigmas de remoção de ruído, mutuamente exclusiva com timesteps. Sem uma substituição — o padrão —, o scheduler calcula os sigmas a partir de num_inference_steps; fornecer um agendamento personalizado torna num_inference_steps irrelevante. A substituição exige que o scheduler seja compatível com o argumento sigmas de set_sigmas.
sigmas.methodopcional
Tipoenum
Padrãodefault
defaultarray
Escolha como os sigmas são determinados: 'default', a configuração padrão, usa os próprios valores de sigma do scheduler. Para fornecer seu próprio agendamento de sigma, selecione 'custom' e coloque o agendamento no campo `array`.
sigmas.arrayopcional
Tiponumber[]
Padrão[]
Agendamento de sigma aplicado quando o método selecionado é 'custom'.
prediction_typeopcional
Tipoenum
Padrãoepsilon
v_predictionepsilon
Escolha o tipo de previsão para gerar imagens; sem outra seleção, `epsilon` é usado.
rescale_betas_snr_zeroopcional
Tipoboolean
Padrãofalse
Controla se o sampler habilita rescale_betas_snr_zero.
image_formatopcional
Tipoenum
Padrãopng
jpegpng
Formato de arquivo da imagem resultante.
num_imagesopcional num_outputs
Tipointeger
Padrão1
1 – 8
Defina quantas imagens uma única requisição produz, permitindo mais tempo de geração para um lote maior.
enable_safety_checkeropcional
Tipoboolean
Padrãofalse
Ativação do verificador de segurança; true ativa a verificação.
tile_widthopcional
Tipointeger
Padrão4096
128 – 4.096
Defina o tamanho de cada bloco durante a geração de imagens.
tile_heightopcional
Tipointeger
Padrão4096
128 – 4.096
Defina o tamanho de cada bloco durante a geração de imagens.
tile_stride_widthopcional
Tipointeger
Padrão2048
64 – 2.048
Defina o espaçamento entre posições consecutivas dos blocos durante a geração de imagens.
tile_stride_heightopcional
Tipointeger
Padrão2048
64 – 2.048
Defina o espaçamento entre posições consecutivas dos blocos durante a geração de imagens.
etaopcional
Tiponumber
Padrão0
0 – 1
Configuração Eta usada durante a geração de imagens.
debug_latentsopcional
Tipoboolean
Padrãofalse
Salva os latentes para depuração quando true.
debug_per_pass_latentsopcional
Tipoboolean
Padrãofalse
Habilite a depuração por passagem definindo este valor como true; isso salva os latentes de cada passagem.
obrigatório Nome canônico, também aceito

Os parâmetros de arquivo aceitam uma URL https:// pública, um URI data: de até 10 MB ou o file_url de um upload. Arquivos

Saída

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"
  }
}
Seus arquivos, sua escolhaCada outputs[].url é uma cópia em nosso armazenamento: mantida para sempre (cobrada por GB-mês) ou por 7 dias gratuitamente, conforme a configuração da sua conta ou ?storage=.
Mesmo formato em todos os modelostype, url, content_type, width, height e duration, para imagens, vídeos e áudios. output é o próprio objeto de resultado do modelo.
Campos da saída
images
array of object {url, content_type, file_name, file_size, width, height}Informações de arquivo das imagens geradas.
seed
integerSeed de geração de imagens, incluindo o valor escolhido aleatoriamente quando a entrada não forneceu uma seed; caso contrário, repete o valor fornecido.
has_nsfw_concepts
array of booleanIndica se conceitos NSFW aparecem nas imagens geradas.
debug_latents
object {url, content_type, file_name, file_size} | nullDados latentes armazenados para depuração.
debug_per_pass_latents
object {url, content_type, file_name, file_size} | nullDados latentes por passagem armazenados para depuração.

Mais modelos: Texto para imagem

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