Lompat ke konten

IP Adapter Face ID

Integrasikan

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

Permintaan ini: ≈$0,06 60 kredit API Jalankan di halaman ini

Dapatkan kunci API
Tencent Pengeditan Gambar #ip-adapter#personalization#customization#editing

Menghasilkan gambar yang mencocokkan wajah dari satu foto atau zip foto, pada basis SD 1.5 atau SDXL

Tencent · Gambar

Hasil pertama Anda akan muncul di sini

Buat permintaan di bawah ini dan jalankan dengan kunci API Anda. Output disalin ke penyimpanan kami, disimpan selamanya atau 7 hari gratis.

Buat permintaan

Kontrol dibuat dari skema model. Kode dan harga diperbarui saat Anda mengubahnya.

•wajib

Jelaskan gambar yang ingin dibuat sedetail mungkin untuk memperoleh hasil terbaik.

bawaan 4

Jumlah sampel untuk ID wajah, dengan bawaan 4. Meningkatkan jumlah ini memperbaiki kualitas gambar, tetapi memperpanjang waktu pembuatan.

Lanjutan 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
bawaan blurry, low resolutio...

Negative prompt yang menentukan detail gambar yang tidak diinginkan. Prompt ini dapat mengecualikan warna, objek, pemandangan, atau fitur dan kualitas yang lebih halus, seperti kumis, buram, atau resolusi rendah.

Jatuhkan file, atau

Gambar referensi pencocokan wajah, diskalakan dan dipangkas menjadi 640x640 setiap kali dimensinya berbeda dari ukuran tersebut.

model_type bawaan 1_5-v1

Pemilihan model, dengan 1_5 sebagai bawaan sekaligus pilihan yang direkomendasikan untuk sebagian besar penggunaan.

URL arsip zip gambar wajah, digunakan untuk membuat ID wajah yang lebih akurat dengan merata-ratakan embedding dari gambar yang diarsipkan.

bawaan SG161222/Realistic_Vi...

URL model Base 1.5; bawaannya `SG161222/Realistic_Vision_V4.0_noVAE`.

bawaan SG161222/RealVisXL_V3.0

URL model Base SDXL; bawaannya `SG161222/RealVisXL_V3.0`.

bawaan 7.5

Kekuatan kepatuhan terhadap prompt untuk pemilihan gambar, dinyatakan sebagai CFG (Classifier Free Guidance).

bawaan 50

Jumlah langkah inferensi pembuatan gambar, dengan kualitas gambar yang lebih baik pada jumlah lebih besar tetapi waktu pembuatan lebih lama.

bawaan 512

Lebar gambar yang dihasilkan.

bawaan 512

Tinggi gambar yang dihasilkan.

bawaan 640

Atur ukuran model deteksi wajah, kurangi jika model tidak dapat menemukan wajah dalam gambar Anda. Pengaturan yang lebih besar memberikan deteksi yang lebih akurat, tetapi berjalan lebih lambat dan lebih mungkin sama sekali tidak menemukan wajah.

Seed untuk mereproduksi gambar dalam Stable Diffusion. Gambar dapat direproduksi secara persis pada setiap proses dengan mempertahankan versi model, prompt, dan seed.

POST /run/ip-adapter-face-id?wait=20 estimasi harga → $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"

Jalankan permintaan ini

Key Anda tetap berada di browser ini: key hanya dikirim ke Doitong API dan disimpan (localStorage) hanya jika Anda mencentang Ingat. Dapatkan kunci API

Tentang IP Adapter Face ID

Mempersonalisasi generasi berdasarkan wajah yang diberikan sebagai `face_image_url`, atau sebagai zip beberapa wajah melalui `face_images_data_url` yang embedding-nya dirata-ratakan. `model_type` memilih antara varian SD 1.5 dan SDXL, dan checkpoint dasar dapat diubah dengan parameter repo. `width` dan `height` berada dalam rentang 512 hingga 1024, dan `num_inference_steps` hingga 200.

Parameter

NamaTipe BawaanDiizinkan Deskripsi
model_typeopsional
Tipeenum
Bawaan1_5-v1
1_5-v11_5-v1-plus1_5-v2-plusSDXL-v1SDXL-v2-plus1_5-auraface-v1
Pemilihan model, dengan 1_5 sebagai bawaan sekaligus pilihan yang direkomendasikan untuk sebagian besar penggunaan.
promptwajib
Tipestring
Jelaskan gambar yang ingin dibuat sedetail mungkin untuk memperoleh hasil terbaik.
face_image_urlopsional
Tipeurl · image
Gambar referensi pencocokan wajah, diskalakan dan dipangkas menjadi 640x640 setiap kali dimensinya berbeda dari ukuran tersebut.
face_images_data_urlopsional
Tipestring | null
URL arsip zip gambar wajah, digunakan untuk membuat ID wajah yang lebih akurat dengan merata-ratakan embedding dari gambar yang diarsipkan.
negative_promptopsional
Tipestring
Bawaanblurry, low resolution, bad, ugly, low quality, pixelated, interpolated, compression artifacts, noisey, grainy
Negative prompt yang menentukan detail gambar yang tidak diinginkan. Prompt ini dapat mengecualikan warna, objek, pemandangan, atau fitur dan kualitas yang lebih halus, seperti kumis, buram, atau resolusi rendah.
seedopsional
Tipeinteger | null
Seed untuk mereproduksi gambar dalam Stable Diffusion. Gambar dapat direproduksi secara persis pada setiap proses dengan mempertahankan versi model, prompt, dan seed.
guidance_scaleopsional
Tipenumber
Bawaan7.5
0 – 16
Kekuatan kepatuhan terhadap prompt untuk pemilihan gambar, dinyatakan sebagai CFG (Classifier Free Guidance).
num_inference_stepsopsional
Tipeinteger
Bawaan50
1 – 200
Jumlah langkah inferensi pembuatan gambar, dengan kualitas gambar yang lebih baik pada jumlah lebih besar tetapi waktu pembuatan lebih lama.
num_samplesopsional
Tipeinteger
Bawaan4
1 – 4
Jumlah sampel untuk ID wajah, dengan bawaan 4. Meningkatkan jumlah ini memperbaiki kualitas gambar, tetapi memperpanjang waktu pembuatan.
widthopsional
Tipeinteger
Bawaan512
512 – 1.024
Lebar gambar yang dihasilkan.
heightopsional
Tipeinteger
Bawaan512
512 – 1.024
Tinggi gambar yang dihasilkan.
face_id_det_sizeopsional
Tipeinteger
Bawaan640
64 – 640
Atur ukuran model deteksi wajah, kurangi jika model tidak dapat menemukan wajah dalam gambar Anda. Pengaturan yang lebih besar memberikan deteksi yang lebih akurat, tetapi berjalan lebih lambat dan lebih mungkin sama sekali tidak menemukan wajah.
base_1_5_model_repoopsional
Tipestring
BawaanSG161222/Realistic_Vision_V4.0_noVAE
URL model Base 1.5; bawaannya `SG161222/Realistic_Vision_V4.0_noVAE`.
base_sdxl_model_repoopsional
Tipestring
BawaanSG161222/RealVisXL_V3.0
URL model Base SDXL; bawaannya `SG161222/RealVisXL_V3.0`.
enable_safety_checkeropsional
Tipeboolean
Bawaantrue
Penyaringan dapat dilonggarkan dengan menetapkan false, jika pemanggil berwenang.
wajib

Parameter file menerima URL publik https://, URI data: hingga 10 MB, atau file_url dari unggahan. File

Output

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"
  }
}
File Anda, pilihan AndaSetiap outputs[].url adalah salinan di penyimpanan kami: disimpan selamanya (dikenai biaya per GB-bulan) atau 7 hari gratis, sesuai setelan akun atau ?storage=.
Struktur sama di setiap modeltype, url, content_type, width, height, dan duration, untuk gambar, video, dan audio. output adalah objek hasil milik model.
Field output
image
object {url, content_type, file_name, file_size, width, height}Informasi file untuk gambar yang dihasilkan.
seed
integerSeed pembuatan gambar, termasuk nilai yang dipilih secara acak jika input tidak menyertakan seed; jika tidak, nilai yang diberikan akan diulang.

Untuk agen AI: halaman ini dalam Markdown tersedia di https://doitong.com/id/developers/models/ip-adapter-face-id.md. Semua model dan panduan: https://doitong.com/developers/llms.txt