Bỏ qua đến nội dung

IP Adapter Face ID

Tích hợp

Id mô hình 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"

Yêu cầu này: ≈0,06 $ 60 tín dụng API Chạy trên trang này

Lấy khóa API
Tencent Chỉnh sửa hình ảnh #ip-adapter#personalization#customization#editing

Tạo hình ảnh khớp với khuôn mặt từ một ảnh hoặc tệp zip ảnh, trên nền SD 1.5 hoặc SDXL

Tencent · Hình ảnh

Kết quả đầu tiên của bạn sẽ xuất hiện ở đây

Tạo một yêu cầu bên dưới và chạy bằng khóa API của bạn. Đầu ra được sao chép vào bộ lưu trữ của chúng tôi, giữ vĩnh viễn hoặc 7 ngày miễn phí.

Tạo một yêu cầu

Các điều khiển được tạo từ lược đồ mô hình. Mã và giá sẽ cập nhật khi bạn thay đổi chúng.

•bắt buộc

Mô tả hình ảnh bạn muốn tạo bằng càng nhiều chi tiết càng tốt để đạt kết quả tốt nhất.

mặc định 4

Số mẫu cho ID khuôn mặt, mặc định là 4. Tăng số mẫu cải thiện chất lượng hình ảnh nhưng kéo dài thời gian tạo sinh.

Nâng cao 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
mặc định blurry, low resolutio...

Lời nhắc phủ định chỉ định các chi tiết hình ảnh không mong muốn. Có thể loại màu sắc, vật thể, phong cảnh hoặc các đặc điểm và phẩm chất nhỏ hơn, chẳng hạn như ria mép, mờ hoặc độ phân giải thấp.

Thả tệp hoặc

Hình ảnh tham chiếu để khớp khuôn mặt, được thay đổi tỷ lệ và cắt thành 640x640 khi kích thước khác với mức đó.

model_type mặc định 1_5-v1

Lựa chọn mô hình, trong đó 1_5 vừa là mặc định vừa là lựa chọn được khuyến nghị cho hầu hết trường hợp sử dụng.

URL kho lưu trữ zip chứa hình ảnh khuôn mặt, dùng để tạo ID khuôn mặt chính xác hơn bằng cách lấy trung bình các embedding từ những hình ảnh trong kho.

mặc định SG161222/Realistic_Vi...

URL của mô hình nền 1.5; mặc định là `SG161222/Realistic_Vision_V4.0_noVAE`.

mặc định SG161222/RealVisXL_V3.0

URL của mô hình nền SDXL; mặc định là `SG161222/RealVisXL_V3.0`.

mặc định 7.5

Mức độ tuân thủ lời nhắc khi chọn hình ảnh, được biểu thị bằng CFG (Classifier Free Guidance).

mặc định 50

Số bước suy luận tạo hình ảnh; số bước lớn hơn cho chất lượng hình ảnh tốt hơn nhưng thời gian tạo sinh lâu hơn.

mặc định 512

Chiều rộng của hình ảnh kết quả.

mặc định 512

Chiều cao của hình ảnh kết quả.

mặc định 640

Đặt kích thước mô hình phát hiện khuôn mặt, giảm kích thước nếu mô hình không tìm thấy khuôn mặt trong hình ảnh. Thiết lập lớn hơn cho khả năng phát hiện chính xác hơn nhưng chạy chậm hơn và dễ bỏ sót hoàn toàn khuôn mặt hơn.

Seed để tái tạo hình ảnh trong Stable Diffusion. Có thể tái tạo chính xác hình ảnh ở mỗi lần chạy bằng cách giữ nguyên phiên bản mô hình, lời nhắc và seed.

POST /run/ip-adapter-face-id?wait=20 báo giá → 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"

Chạy yêu cầu này

Key của bạn vẫn nằm trong trình duyệt này: key chỉ được gửi đến Doitong API và chỉ được lưu trong localStorage nếu bạn chọn Ghi nhớ. Nhận khóa API

Giới thiệu về IP Adapter Face ID

Cá nhân hóa quá trình tạo theo khuôn mặt được cung cấp qua `face_image_url`, hoặc qua tệp zip nhiều khuôn mặt trong `face_images_data_url`, với các embedding được lấy trung bình. `model_type` chọn giữa các biến thể SD 1.5 và SDXL, còn checkpoint nền có thể thay đổi bằng các tham số repo. `width` và `height` nằm trong khoảng 512 đến 1024, `num_inference_steps` tối đa 200.

Tham số

TênKiểu Mặc địnhĐược phép Mô tả
model_typetùy chọn
Kiểuenum
Mặc định1_5-v1
1_5-v11_5-v1-plus1_5-v2-plusSDXL-v1SDXL-v2-plus1_5-auraface-v1
Lựa chọn mô hình, trong đó 1_5 vừa là mặc định vừa là lựa chọn được khuyến nghị cho hầu hết trường hợp sử dụng.
promptbắt buộc
Kiểustring
Mô tả hình ảnh bạn muốn tạo bằng càng nhiều chi tiết càng tốt để đạt kết quả tốt nhất.
face_image_urltùy chọn
Kiểuurl · image
Hình ảnh tham chiếu để khớp khuôn mặt, được thay đổi tỷ lệ và cắt thành 640x640 khi kích thước khác với mức đó.
face_images_data_urltùy chọn
Kiểustring | null
URL kho lưu trữ zip chứa hình ảnh khuôn mặt, dùng để tạo ID khuôn mặt chính xác hơn bằng cách lấy trung bình các embedding từ những hình ảnh trong kho.
negative_prompttùy chọn
Kiểustring
Mặc địnhblurry, low resolution, bad, ugly, low quality, pixelated, interpolated, compression artifacts, noisey, grainy
Lời nhắc phủ định chỉ định các chi tiết hình ảnh không mong muốn. Có thể loại màu sắc, vật thể, phong cảnh hoặc các đặc điểm và phẩm chất nhỏ hơn, chẳng hạn như ria mép, mờ hoặc độ phân giải thấp.
seedtùy chọn
Kiểuinteger | null
Seed để tái tạo hình ảnh trong Stable Diffusion. Có thể tái tạo chính xác hình ảnh ở mỗi lần chạy bằng cách giữ nguyên phiên bản mô hình, lời nhắc và seed.
guidance_scaletùy chọn
Kiểunumber
Mặc định7.5
0 – 16
Mức độ tuân thủ lời nhắc khi chọn hình ảnh, được biểu thị bằng CFG (Classifier Free Guidance).
num_inference_stepstùy chọn
Kiểuinteger
Mặc định50
1 – 200
Số bước suy luận tạo hình ảnh; số bước lớn hơn cho chất lượng hình ảnh tốt hơn nhưng thời gian tạo sinh lâu hơn.
num_samplestùy chọn
Kiểuinteger
Mặc định4
1 – 4
Số mẫu cho ID khuôn mặt, mặc định là 4. Tăng số mẫu cải thiện chất lượng hình ảnh nhưng kéo dài thời gian tạo sinh.
widthtùy chọn
Kiểuinteger
Mặc định512
512 – 1.024
Chiều rộng của hình ảnh kết quả.
heighttùy chọn
Kiểuinteger
Mặc định512
512 – 1.024
Chiều cao của hình ảnh kết quả.
face_id_det_sizetùy chọn
Kiểuinteger
Mặc định640
64 – 640
Đặt kích thước mô hình phát hiện khuôn mặt, giảm kích thước nếu mô hình không tìm thấy khuôn mặt trong hình ảnh. Thiết lập lớn hơn cho khả năng phát hiện chính xác hơn nhưng chạy chậm hơn và dễ bỏ sót hoàn toàn khuôn mặt hơn.
base_1_5_model_repotùy chọn
Kiểustring
Mặc địnhSG161222/Realistic_Vision_V4.0_noVAE
URL của mô hình nền 1.5; mặc định là `SG161222/Realistic_Vision_V4.0_noVAE`.
base_sdxl_model_repotùy chọn
Kiểustring
Mặc địnhSG161222/RealVisXL_V3.0
URL của mô hình nền SDXL; mặc định là `SG161222/RealVisXL_V3.0`.
enable_safety_checkertùy chọn
Kiểuboolean
Mặc địnhtrue
Có thể nới lỏng việc kiểm duyệt bằng cách đặt thành false, nếu người gọi được cấp quyền.
bắt buộc

Các tham số tệp nhận URL https:// công khai, URI data: tối đa 10 MB hoặc file_url của một tệp tải lên. Tệp

Đầu ra

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"
  }
}
Tệp của bạn, lựa chọn của bạnMỗi outputs[].url là một bản sao trên bộ lưu trữ của chúng tôi: được giữ vĩnh viễn (tính phí theo GB-tháng) hoặc 7 ngày miễn phí, theo cài đặt tài khoản hoặc ?storage=.
Cùng một cấu trúc trên mọi mô hìnhtype, url, content_type, width, height và duration cho hình ảnh, video và âm thanh. output là đối tượng kết quả riêng của mô hình.
Các trường đầu ra
image
object {url, content_type, file_name, file_size, width, height}Thông tin tệp của hình ảnh đã tạo.
seed
integerSeed tạo sinh hình ảnh, bao gồm giá trị được chọn ngẫu nhiên nếu đầu vào không cung cấp seed; nếu không, lặp lại giá trị đã cung cấp.

Dành cho tác nhân AI: trang này ở dạng Markdown tại https://doitong.com/vi/developers/models/ip-adapter-face-id.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt