Vai al contenuto

PuLID

Integra

ID del modello pulid
# 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/pulid?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "reference_images": [
      {
        "image_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"

Questa richiesta: ≈0,009 $ 9 crediti API Esegui in questa pagina

Ottieni la chiave API
ByteDance Modifica immagini Input di riferimento #editing#customization#personalization

Genera nuove immagini che mantengono il volto di una persona dalle foto di riferimento, senza ottimizzazione per singola persona

ByteDance · Immagine

Il tuo primo risultato apparirà qui

Crea una richiesta qui sotto ed eseguila con la tua chiave API. Gli output vengono copiati nella nostra archiviazione, conservati per sempre oppure 7 giorni gratuitamente.

Crea una richiesta

I controlli vengono generati dallo schema del modello. Il codice e il prezzo si aggiornano mentre li modifichi.

•obbligatorio

Prompt utilizzato per generare il volto.

image_size predefinito {"height":1024,"width...

Dimensioni dell'immagine generata.

num_images predefinito 1

Numero di immagini da produrre.

•obbligatorio

Elenco di immagini di riferimento del volto; 4 immagini sono l'ideale.

Avanzate negative_prompt · mode · guidance_scale · num_inference_steps · id_scale · seed · id_mix · enable_safety_checker
predefinito flaws in the eyes, fl...

Prompt negativo per la generazione del volto.

mode predefinito fidelity

Modalità di generazione.

predefinito 1.2

Scala per la guida.

predefinito 4

Numero totale di passaggi da eseguire.

predefinito 0.8

Scala per l'ID.

Seed usato per una generazione casuale riproducibile.

POST /run/pulid?wait=20 preventivo → 0,009 $
# 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/pulid?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "reference_images": [
      {
        "image_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"

Esegui questa richiesta

La tua chiave rimane in questo browser: viene inviata solo al Doitong API e salvata in localStorage solo se selezioni Ricorda. Ottieni una chiave API

Informazioni su PuLID

Prende `reference_images` di un volto (ne vengono suggerite circa 4) e un `prompt`, quindi crea immagini che ne mantengono l'identità. `mode` è fidelity o extreme stile, `id_scale` varia da 0 a 5 e `id_mix` consente di combinare due identità. È possibile generare fino a 8 immagini, con da 1 a 12 step e `guidance_scale` da 1 a 1.5.

Parametri

Invia il nome canonico oppure il nome nativo, non entrambi. Nomi canonici

NomeTipo PredefinitoConsentiti Descrizione
reference_imagesobbligatorio
Tipoobject[]
Elenco di immagini di riferimento del volto; 4 immagini sono l'ideale.
reference_images[].image_urlobbligatorio
Tipourl · image
URL dell'immagine di riferimento del volto.
promptobbligatorio
Tipostring
Prompt utilizzato per generare il volto.
negative_promptfacoltativo
Tipostring
Predefinitoflaws in the eyes, flaws in the face, flaws, lowres, non-HDRi, low quality, worst quality,artifacts noise, text, watermark, glitch, deformed, mutated, ugly, disfigured, hands, low resolution, partially rendered objects, deformed or partially rendered eyes, deformed, deformed eyeballs, cross-eyed,blurry
Prompt negativo per la generazione del volto.
num_imagesfacoltativo num_outputs
Tipointeger
Predefinito1
1 – 8
Numero di immagini da produrre.
guidance_scalefacoltativo
Tiponumber
Predefinito1.2
1 – 1,5
Scala per la guida.
num_inference_stepsfacoltativo
Tipointeger
Predefinito4
1 – 12
Numero totale di passaggi da eseguire.
seedfacoltativo
Tipointeger | null
Seed usato per una generazione casuale riproducibile.
image_sizefacoltativo
Tipoobject
Predefinito{"height":1024,"width":768}
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensioni dell'immagine generata.
id_scalefacoltativo
Tiponumber
Predefinito0.8
≤ 5> 0
Scala per l'ID.
modefacoltativo
Tipoenum
Predefinitofidelity
fidelityextreme style
Modalità di generazione.
id_mixfacoltativo
Tipoboolean
Predefinitofalse
Indica se combinare due immagini ID. Attiva per la combinazione; in caso contrario, disattiva.
enable_safety_checkerfacoltativo
Tipoboolean
Predefinitotrue
Il controllo può essere allentato impostando false, se il chiamante è autorizzato.
obbligatorio Nome canonico, accettato anche

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "pulid",
  "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": 9,
    "usd": "0.009",
    "charged": 9,
    "refunded": 0
  },
  "input": {
    "reference_images": [
      {
        "image_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"
  }
}
I tuoi file, la tua sceltaOgni outputs[].url è una copia nella nostra archiviazione: conservata per sempre (a pagamento per GB-mese) oppure 7 giorni gratuitamente, in base all'impostazione dell'account o a ?storage=.
Stessa struttura per ogni modellotype, url, content_type, width, height e duration, per immagini, video e audio. output è l'oggetto risultato del modello.
Campi dell'output
images
array of object {url, content_type, file_name, file_size, width, height}Immagini generate, restituite come elenco.
seed
integerSeed casuale per riprodurre i risultati.

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/pulid.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt