Naar inhoud springen

PuLID

Integreren

Model-ID 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"

Deze request: ≈$ 0,009 9 API-tegoed Op deze pagina uitvoeren

API-sleutel ophalen
ByteDance Afbeelding bewerken Referentie-inputs #editing#customization#personalization

Genereert nieuwe afbeeldingen die het gezicht van een persoon uit referentiefoto's behouden, zonder afstemming per persoon

ByteDance · Afbeelding

Je eerste resultaat komt hier

Bouw hieronder een request en voer die uit met je API-sleutel. Uitvoer wordt naar onze opslag gekopieerd en voor altijd of 7 dagen gratis bewaard.

Een aanvraag samenstellen

Besturingselementen worden gegenereerd op basis van het modelschema. De code en de prijs worden bijgewerkt terwijl je ze wijzigt.

•verplicht

Prompt die wordt gebruikt om het gezicht te genereren.

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

Afmetingen van de gegenereerde afbeelding.

num_images standaard 1

Aantal te produceren afbeeldingen.

•verplicht

Lijst met referentiegezichtsafbeeldingen; 4 afbeeldingen zijn ideaal.

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

Negatieve prompt voor gezichtsgeneratie.

mode standaard fidelity

Generatiemodus.

standaard 1.2

Schaal voor guidance.

standaard 4

Totaal aantal uit te voeren stappen.

standaard 0.8

Schaal voor ID.

Seed voor reproduceerbare willekeurige generatie.

POST /run/pulid?wait=20 prijsopgave → $ 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"

Deze request uitvoeren

Je sleutel blijft in deze browser: hij wordt alleen naar de Doitong API verzonden en alleen in localStorage opgeslagen als je Onthouden aanvinkt. API-sleutel ophalen

Over PuLID

Neemt `reference_images` van een gezicht (ongeveer 4 worden aanbevolen) en een `prompt` en maakt vervolgens afbeeldingen die de identiteit behouden. `mode` is fidelity of extreme stijl, `id_scale` loopt van 0 tot 5 en `id_mix` maakt het mengen van twee identiteiten mogelijk. Er kunnen maximaal 8 afbeeldingen worden gegenereerd, met 1 tot 12 stappen en `guidance_scale` van 1 tot 1.5.

Parameters

Stuur de canonieke naam of de oorspronkelijke naam, niet beide. Canonieke namen

NaamType StandaardToegestaan Beschrijving
reference_imagesverplicht
Typeobject[]
Lijst met referentiegezichtsafbeeldingen; 4 afbeeldingen zijn ideaal.
reference_images[].image_urlverplicht
Typeurl · image
URL van de referentiegezichtsafbeelding.
promptverplicht
Typestring
Prompt die wordt gebruikt om het gezicht te genereren.
negative_promptoptioneel
Typestring
Standaardflaws 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
Negatieve prompt voor gezichtsgeneratie.
num_imagesoptioneel num_outputs
Typeinteger
Standaard1
1 – 8
Aantal te produceren afbeeldingen.
guidance_scaleoptioneel
Typenumber
Standaard1.2
1 – 1,5
Schaal voor guidance.
num_inference_stepsoptioneel
Typeinteger
Standaard4
1 – 12
Totaal aantal uit te voeren stappen.
seedoptioneel
Typeinteger | null
Seed voor reproduceerbare willekeurige generatie.
image_sizeoptioneel
Typeobject
Standaard{"height":1024,"width":768}
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Afmetingen van de gegenereerde afbeelding.
id_scaleoptioneel
Typenumber
Standaard0.8
≤ 5> 0
Schaal voor ID.
modeoptioneel
Typeenum
Standaardfidelity
fidelityextreme style
Generatiemodus.
id_mixoptioneel
Typeboolean
Standaardfalse
Of twee ID-afbeeldingen moeten worden gecombineerd. Schakel dit in voor combineren; schakel het anders uit.
enable_safety_checkeroptioneel
Typeboolean
Standaardtrue
Screening kan worden versoepeld door false in te stellen, mits de aanroeper is geautoriseerd.
verplicht Canonieke naam, ook geaccepteerd

Uitvoer

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"
  }
}
Jouw bestanden, jouw keuzeElke outputs[].url is een kopie in onze opslag: voor altijd bewaard (betaald per GB-maand) of 7 dagen gratis, volgens je accountinstelling of ?storage=.
Dezelfde structuur voor elk modeltype, url, content_type, width, height en duration, voor afbeeldingen, video en audio. output is het eigen resultaatobject van het model.
Velden van de uitvoer
images
array of object {url, content_type, file_name, file_size, width, height}Gegenereerde afbeeldingen, geretourneerd als lijst.
seed
integerWillekeurige seed voor het reproduceren van resultaten.

Voor AI-agents: deze pagina als Markdown staat op https://doitong.com/nl/developers/models/pulid.md. Alle modellen en handleidingen: https://doitong.com/developers/llms.txt