Avançar para o conteúdo

PhotoMaker

Integrar

ID do modelo photomaker
# 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/photomaker?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_archive_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "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,022 $ 22 créditos da API Executar nesta página

Obter chave de API
Tencent Edição de imagem #editing#customization#realism#personalization

Geração personalizada de retratos a partir de um arquivo de fotografias de referência, com predefinições de estilo e img2img opcional

Tencent · 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.

•obrigatório

Forneça as imagens a usar num arquivo, especificadas pela respetiva URL.

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 · initial_image_url · base_pipeline · style · initial_image_strength · num_inference_steps · style_strength · guidance_scale · seed · enable_safety_checker
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

Imagem inicial opcional para processamento img2img.

base_pipeline predefinição photomaker

Pipeline base usado para geração de imagens.

predefinição Photographic
predefinição 0.5

Nível de ruído da imagem latente, entre nenhum ruído adicionado em O e o máximo em 1.

predefinição 50

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

predefinição 20
predefinição 5

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

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.

POST /run/photomaker?wait=20 cotação → 0,022 $
# 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/photomaker?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_archive_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "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 PhotoMaker

Cria novas imagens de uma pessoa a partir de um arquivo ZIP com as suas fotografias (`image_archive_url`) e de um `prompt` de texto obrigatório. Escolha o pipeline base `photomaker` ou `photomaker-style` e selecione entre 11 estilos, como Cinematic, Comic book ou Line art. Suporta 1 a 4 imagens por pedido, 20 a 100 passos de inferência, orientação de 1 a 10 e uma imagem inicial opcional com `initial_image_strength` entre 0 e 1.

Parâmetros

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

NomeTipo PredefiniçãoPermitido Descrição
image_archive_urlobrigatório
Tipostring
Forneça as imagens a usar num arquivo, especificadas pela respetiva URL.
promptobrigatório
Tipostring
Descreva a imagem que pretende gerar, utilizando o máximo de detalhe possível para obter os melhores resultados.
base_pipelineopcional
Tipoenum
Predefiniçãophotomaker
photomakerphotomaker-style
Pipeline base usado para geração de imagens.
initial_image_urlopcional
Tipourl · image
Imagem inicial opcional para processamento img2img.
initial_image_strengthopcional
Tiponumber
Predefinição0.5
0 – 1
Nível de ruído da imagem latente, entre nenhum ruído adicionado em O e o máximo em 1.
styleopcional
Tipoenum
PredefiniçãoPhotographic
(No style)CinematicDisney CharacterDigital ArtPhotographicFantasy artNeonpunkEnhanceComic bookLowpolyLine art
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.
num_inference_stepsopcional
Tipointeger
Predefinição50
20 – 100
Controla quantos passos de geração o Stable Diffusion executa; passos adicionais podem produzir uma imagem final mais detalhada.
style_strengthopcional
Tipointeger
Predefinição20
15 – 50
num_imagesopcional num_outputs
Tipointeger
Predefinição1
1 – 4
Defina quantas imagens um único pedido produz, permitindo mais tempo de geração para um lote maior.
guidance_scaleopcional
Tiponumber
Predefinição5
1 – 10
Intensidade de adesão ao prompt para seleção de imagens, expressa como CFG (Classifier Free Guidance).
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.
enable_safety_checkeropcional
Tipoboolean
Predefiniçãotrue
A filtragem pode ser flexibilizada definindo false, desde que o autor do pedido esteja autorizado.
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": "photomaker",
  "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": 22,
    "usd": "0.022",
    "charged": 22,
    "refunded": 0
  },
  "input": {
    "image_archive_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "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
  },
  "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}
seed
integer

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