Bỏ qua đến nội dung

PuLID

Tích hợp

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

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

Lấy khóa API
ByteDance Chỉnh sửa hình ảnh Đầu vào tham chiếu #editing#customization#personalization

Tạo ảnh mới vẫn giữ khuôn mặt của một người từ ảnh tham chiếu mà không cần tinh chỉnh theo từng người

ByteDance · 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

Lời nhắc dùng để tạo khuôn mặt.

image_size mặc định {"height":1024,"width...

Kích thước của hình ảnh được tạo.

num_images mặc định 1

Số hình ảnh cần tạo.

•bắt buộc

Danh sách hình ảnh khuôn mặt tham chiếu; lý tưởng là 4 hình ảnh.

Nâng cao negative_prompt · mode · guidance_scale · num_inference_steps · id_scale · seed · id_mix · enable_safety_checker
mặc định flaws in the eyes, fl...

Lời nhắc phủ định cho việc tạo khuôn mặt.

mode mặc định fidelity

Chế độ tạo sinh.

mặc định 1.2

Tỷ lệ hướng dẫn.

mặc định 4

Tổng số bước cần thực hiện.

mặc định 0.8

Tỷ lệ cho ID.

Seed dùng để tạo ngẫu nhiên có thể tái tạo.

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

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ề PuLID

Nhận `reference_images` khuôn mặt (đề xuất khoảng 4 hình ảnh) và `prompt`, sau đó tạo sinh hình ảnh giữ nguyên danh tính. `mode` là fidelity hoặc extreme phong cách, `id_scale` nằm trong khoảng 0 đến 5, và `id_mix` cho phép trộn hai danh tính. Có thể tạo sinh tối đa 8 hình ảnh, với 1 đến 12 bước và `guidance_scale` từ 1 đến 1.5.

Tham số

Gửi tên chuẩn hoặc tên gốc, không gửi cả hai. Tên chuẩn

TênKiểu Mặc địnhĐược phép Mô tả
reference_imagesbắt buộc
Kiểuobject[]
Danh sách hình ảnh khuôn mặt tham chiếu; lý tưởng là 4 hình ảnh.
reference_images[].image_urlbắt buộc
Kiểuurl · image
URL hình ảnh khuôn mặt tham chiếu.
promptbắt buộc
Kiểustring
Lời nhắc dùng để tạo khuôn mặt.
negative_prompttùy chọn
Kiểustring
Mặc địnhflaws 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
Lời nhắc phủ định cho việc tạo khuôn mặt.
num_imagestùy chọn num_outputs
Kiểuinteger
Mặc định1
1 – 8
Số hình ảnh cần tạo.
guidance_scaletùy chọn
Kiểunumber
Mặc định1.2
1 – 1,5
Tỷ lệ hướng dẫn.
num_inference_stepstùy chọn
Kiểuinteger
Mặc định4
1 – 12
Tổng số bước cần thực hiện.
seedtùy chọn
Kiểuinteger | null
Seed dùng để tạo ngẫu nhiên có thể tái tạo.
image_sizetùy chọn
Kiểuobject
Mặc định{"height":1024,"width":768}
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Kích thước của hình ảnh được tạo.
id_scaletùy chọn
Kiểunumber
Mặc định0.8
≤ 5> 0
Tỷ lệ cho ID.
modetùy chọn
Kiểuenum
Mặc địnhfidelity
fidelityextreme style
Chế độ tạo sinh.
id_mixtùy chọn
Kiểuboolean
Mặc địnhfalse
Có trộn hai hình ảnh ID hay không. Bật để trộn; nếu không thì tắt.
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 Tên chuẩn, cũng được chấp nhận

Đầu ra

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"
  }
}
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
images
array of object {url, content_type, file_name, file_size, width, height}Các hình ảnh được tạo, trả về dưới dạng danh sách.
seed
integerSeed ngẫu nhiên để tái tạo kết quả.

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