Перейти к содержимому

PuLID

Интеграция

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"

Этот запрос: ≈0,009 $ 9 API-кредитов · ≈ 0,95 ₽ Запустить на этой странице

Получить API-ключ
ByteDance Редактирование изображений Референсные входные данные #editing#customization#personalization

Генерирует новые изображения, сохраняя лицо человека с референсных фотографий без настройки для каждого человека

ByteDance · Изображение

Здесь появится ваш первый результат

Составьте запрос ниже и выполните его с помощью API-ключа. Результаты копируются в наше хранилище и хранятся навсегда или 7 дней бесплатно.

Сформировать запрос

Элементы управления сгенерированы из схемы модели. Код и цена обновляются при изменении параметров.

•обязательно

Промпт для генерации лица.

image_size по умолчанию {"height":1024,"width...

Размеры сгенерированного изображения.

num_images по умолчанию 1

Количество создаваемых изображений.

•обязательно

Список референсных изображений лица; оптимально использовать 4 изображения.

Расширенные negative_prompt · mode · guidance_scale · num_inference_steps · id_scale · seed · id_mix · enable_safety_checker
по умолчанию flaws in the eyes, fl...

Негативный промпт для генерации лица.

mode по умолчанию fidelity

Режим генерации.

по умолчанию 1.2

Масштаб управления.

по умолчанию 4

Общее количество шагов.

по умолчанию 0.8

Масштаб для ID.

Сид для воспроизводимой случайной генерации.

POST /run/pulid?wait=20 стоимость → 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"

Запустить этот запрос

Ваш ключ хранится в этом браузере: он отправляется только в Doitong API и сохраняется в localStorage только при включении параметра «Запомнить». Получить API-ключ

О PuLID

Принимает `reference_images` лица (рекомендуется около 4) и `prompt`, а затем создаёт изображения с сохранением идентичности. `mode` — fidelity или extreme стиль, `id_scale` принимает значения от 0 до 5, а `id_mix` позволяет смешать две идентичности. Можно сгенерировать до 8 изображений, используя от 1 до 12 шагов и `guidance_scale` от 1 до 1.5.

Параметры

Передавайте либо каноническое имя, либо исходное имя, но не оба. Канонические имена

ИмяТип По умолчаниюДопустимые значения Описание
reference_imagesобязательно
Типobject[]
Список референсных изображений лица; оптимально использовать 4 изображения.
reference_images[].image_urlобязательно
Типurl · image
URL референсного изображения лица.
promptобязательно
Типstring
Промпт для генерации лица.
negative_promptнеобязательно
Типstring
По умолчаниюflaws 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
Негативный промпт для генерации лица.
num_imagesнеобязательно num_outputs
Типinteger
По умолчанию1
1 – 8
Количество создаваемых изображений.
guidance_scaleнеобязательно
Типnumber
По умолчанию1.2
1 – 1,5
Масштаб управления.
num_inference_stepsнеобязательно
Типinteger
По умолчанию4
1 – 12
Общее количество шагов.
seedнеобязательно
Типinteger | null
Сид для воспроизводимой случайной генерации.
image_sizeнеобязательно
Типobject
По умолчанию{"height":1024,"width":768}
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Размеры сгенерированного изображения.
id_scaleнеобязательно
Типnumber
По умолчанию0.8
≤ 5> 0
Масштаб для ID.
modeнеобязательно
Типenum
По умолчаниюfidelity
fidelityextreme style
Режим генерации.
id_mixнеобязательно
Типboolean
По умолчаниюfalse
Смешивать ли два изображения ID. Включите для смешивания; в противном случае отключите.
enable_safety_checkerнеобязательно
Типboolean
По умолчаниюtrue
Проверку можно ослабить, установив false, если вызывающая сторона авторизована.
обязательно Каноническое имя, также принимается

Результат

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"
  }
}
Ваши файлы — ваш выборКаждый URL из outputs[].url — это копия в нашем хранилище: она хранится навсегда (оплата за ГБ в месяц) или 7 дней бесплатно — в зависимости от настройки вашего аккаунта или параметра ?storage=.
Одинаковая структура у каждой моделиtype, url, content_type, width, height и duration — одинаково для изображений, видео и аудио. output — собственный объект результата модели.
Поля результата
images
array of object {url, content_type, file_name, file_size, width, height}Сгенерированные изображения, возвращаемые в виде списка.
seed
integerСлучайное начальное число для воспроизведения результатов.

Для AI-агентов: эта страница в формате Markdown доступна по адресу https://doitong.com/ru/developers/models/pulid.md. Все модели и руководства: https://doitong.com/developers/llms.txt