Przejdź do treści

IP Adapter Face ID

Integracja

Identyfikator modelu ip-adapter-face-id
# 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/ip-adapter-face-id?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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"

To żądanie: ≈0,06 $ 60 kredytów API Uruchom na tej stronie

Uzyskaj klucz API
Tencent Edycja obrazów #ip-adapter#personalization#customization#editing

Generuje obrazy pasujące do twarzy z jednego zdjęcia lub archiwum zip zdjęć, na bazie SD 1.5 lub SDXL

Tencent · Obraz

Tutaj pojawi się pierwszy wynik

Zbuduj poniżej żądanie i uruchom je za pomocą klucza API. Wyniki są kopiowane do naszej przestrzeni dyskowej i przechowywane bezterminowo lub 7 dni bezpłatnie.

Zbuduj żądanie

Elementy sterujące są generowane ze schematu modelu. Kod i cena aktualizują się podczas ich zmiany.

•wymagane

Opisz obraz, który chcesz wygenerować, używając jak największej liczby szczegółów, aby uzyskać najlepsze wyniki.

domyślnie 4

Liczba próbek dla identyfikatora twarzy, domyślnie 4. Zwiększenie tej liczby poprawia jakość obrazu, ale wydłuża czas generowania.

Zaawansowane negative_prompt · face_image_url · model_type · face_images_data_url · base_1_5_model_repo · base_sdxl_model_repo · guidance_scale · num_inference_steps · width · height · face_id_det_size · seed · enable_safety_checker
domyślnie blurry, low resolutio...

Negatywny prompt określający niepożądane szczegóły obrazu. Może wykluczać kolory, obiekty, scenerię lub drobniejsze cechy i właściwości, takie jak wąsy, rozmycie lub niska rozdzielczość.

Upuść plik lub

Referencyjny obraz do dopasowania twarzy, skalowany i przycinany do 640x640, gdy jego wymiary różnią się od tego rozmiaru.

model_type domyślnie 1_5-v1

Wybór modelu, przy czym 1_5 jest wartością domyślną i zalecaną dla większości zastosowań.

URL archiwum ZIP z obrazami twarzy, używanego do utworzenia dokładniejszego identyfikatora twarzy przez uśrednienie embeddingów z zarchiwizowanych obrazów.

domyślnie SG161222/Realistic_Vi...

URL modelu bazowego 1.5; wartość domyślna to `SG161222/Realistic_Vision_V4.0_noVAE`.

domyślnie SG161222/RealVisXL_V3.0

URL modelu bazowego SDXL; wartość domyślna to `SG161222/RealVisXL_V3.0`.

domyślnie 7.5

Siła zgodności z promptem przy wyborze obrazu, wyrażona jako CFG (Classifier Free Guidance).

domyślnie 50

Liczba kroków wnioskowania podczas generowania obrazu; większe wartości zapewniają lepszą jakość obrazu kosztem dłuższego generowania.

domyślnie 512

Szerokość wynikowego obrazu.

domyślnie 512

Wysokość wynikowego obrazu.

domyślnie 640

Ustaw rozmiar modelu wykrywania twarzy, zmniejszając go, jeśli model nie może znaleźć twarzy na obrazie. Większe ustawienie zapewnia dokładniejsze wykrywanie, ale działa wolniej i zwiększa ryzyko całkowitego pominięcia twarzy.

Ziarno do odtwarzania obrazów w Stable Diffusion. Obraz można odtworzyć dokładnie przy każdym uruchomieniu, zachowując bez zmian wersję modelu, prompt i ziarno.

POST /run/ip-adapter-face-id?wait=20 wycena → 0,06 $
# 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/ip-adapter-face-id?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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"

Uruchom to żądanie

Klucz pozostaje w tej przeglądarce: jest wysyłany tylko do Doitong API i zapisywany (localStorage) tylko po zaznaczeniu opcji Zapamiętaj. Uzyskaj klucz API

Informacje o IP Adapter Face ID

Personalizuje generowanie dla twarzy podanej przez `face_image_url` lub kilku twarzy w archiwum zip przez `face_images_data_url`, których embeddingi są uśredniane. `model_type` wybiera wariant SD 1.5 lub SDXL, a bazowe checkpointy można zmienić parametrami repo. `width` i `height` przyjmują wartości od 512 do 1024, a `num_inference_steps` do 200.

Parametry

NazwaTyp DomyślneDozwolone Opis
model_typeopcjonalne
Typenum
Domyślne1_5-v1
1_5-v11_5-v1-plus1_5-v2-plusSDXL-v1SDXL-v2-plus1_5-auraface-v1
Wybór modelu, przy czym 1_5 jest wartością domyślną i zalecaną dla większości zastosowań.
promptwymagane
Typstring
Opisz obraz, który chcesz wygenerować, używając jak największej liczby szczegółów, aby uzyskać najlepsze wyniki.
face_image_urlopcjonalne
Typurl · image
Referencyjny obraz do dopasowania twarzy, skalowany i przycinany do 640x640, gdy jego wymiary różnią się od tego rozmiaru.
face_images_data_urlopcjonalne
Typstring | null
URL archiwum ZIP z obrazami twarzy, używanego do utworzenia dokładniejszego identyfikatora twarzy przez uśrednienie embeddingów z zarchiwizowanych obrazów.
negative_promptopcjonalne
Typstring
Domyślneblurry, low resolution, bad, ugly, low quality, pixelated, interpolated, compression artifacts, noisey, grainy
Negatywny prompt określający niepożądane szczegóły obrazu. Może wykluczać kolory, obiekty, scenerię lub drobniejsze cechy i właściwości, takie jak wąsy, rozmycie lub niska rozdzielczość.
seedopcjonalne
Typinteger | null
Ziarno do odtwarzania obrazów w Stable Diffusion. Obraz można odtworzyć dokładnie przy każdym uruchomieniu, zachowując bez zmian wersję modelu, prompt i ziarno.
guidance_scaleopcjonalne
Typnumber
Domyślne7.5
0 – 16
Siła zgodności z promptem przy wyborze obrazu, wyrażona jako CFG (Classifier Free Guidance).
num_inference_stepsopcjonalne
Typinteger
Domyślne50
1 – 200
Liczba kroków wnioskowania podczas generowania obrazu; większe wartości zapewniają lepszą jakość obrazu kosztem dłuższego generowania.
num_samplesopcjonalne
Typinteger
Domyślne4
1 – 4
Liczba próbek dla identyfikatora twarzy, domyślnie 4. Zwiększenie tej liczby poprawia jakość obrazu, ale wydłuża czas generowania.
widthopcjonalne
Typinteger
Domyślne512
512 – 1024
Szerokość wynikowego obrazu.
heightopcjonalne
Typinteger
Domyślne512
512 – 1024
Wysokość wynikowego obrazu.
face_id_det_sizeopcjonalne
Typinteger
Domyślne640
64 – 640
Ustaw rozmiar modelu wykrywania twarzy, zmniejszając go, jeśli model nie może znaleźć twarzy na obrazie. Większe ustawienie zapewnia dokładniejsze wykrywanie, ale działa wolniej i zwiększa ryzyko całkowitego pominięcia twarzy.
base_1_5_model_repoopcjonalne
Typstring
DomyślneSG161222/Realistic_Vision_V4.0_noVAE
URL modelu bazowego 1.5; wartość domyślna to `SG161222/Realistic_Vision_V4.0_noVAE`.
base_sdxl_model_repoopcjonalne
Typstring
DomyślneSG161222/RealVisXL_V3.0
URL modelu bazowego SDXL; wartość domyślna to `SG161222/RealVisXL_V3.0`.
enable_safety_checkeropcjonalne
Typboolean
Domyślnetrue
Filtrowanie można złagodzić, ustawiając false, jeśli wywołujący ma odpowiednie uprawnienia.
wymagane

Parametry plików przyjmują publiczny URL https://, identyfikator URI data: do 10 MB albo file_url przesłanego pliku. Pliki

Wynik

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ip-adapter-face-id",
  "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": 60,
    "usd": "0.06",
    "charged": 60,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "image": {
      "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"
  }
}
Twoje pliki, Twój wybórKażdy outputs[].url to kopia w naszej przestrzeni dyskowej: przechowywana bezterminowo (opłata za GB-miesiąc) lub 7 dni bezpłatnie, zgodnie z ustawieniem konta lub ?storage=.
Taki sam format w każdym modelutype, url, content_type, width, height i duration — tak samo dla obrazów, filmów i dźwięku. output to własny obiekt wyniku modelu.
Pola wyniku
image
object {url, content_type, file_name, file_size, width, height}Informacje o pliku wygenerowanego obrazu.
seed
integerZiarno generowania obrazu, zawierające wartość wybraną losowo, jeśli dane wejściowe nie zawierały ziarna; w przeciwnym razie powtarza podaną wartość.

Dla agentów AI: ta strona w formacie Markdown jest dostępna pod adresem https://doitong.com/pl/developers/models/ip-adapter-face-id.md. Wszystkie modele i przewodniki: https://doitong.com/developers/llms.txt