Skip to main content
POST
Генерация изображения
character_id — необязательное поле. Без него выполняется обычная генерация по описанию, с ним лицо берётся из обученного персонажа. Доступные модели: soul-2-1080p и soul-2-720p.
Один и тот же character_id можно использовать в любом количестве генераций. Если персонаж ещё обучается, дождитесь status: completed.

Authorizations

Authorization
string
header
required

Заголовок авторизации вида Bearer <token>, где <token> — ваш API-ключ.

Body

application/json
model
enum<string>
required

Идентификатор модели генерации изображений Higgsfield Soul 2.

Available options:
soul-2-1080p,
soul-2-720p
Example:

"soul-2-1080p"

prompt
string
required

Текстовое описание желаемого изображения.

Example:

"portrait in soft daylight, city background"

character_id
string

Необязательный идентификатор обученного персонажа со статусом completed.

Example:

"3b9c1e2a-2cd3-4b91-a50f-fcc59bde76a8"

aspect_ratio
enum<string>
default:4:3

Соотношение сторон изображения.

Available options:
9:16,
16:9,
4:3,
3:4,
1:1,
2:3,
3:2
style
enum<string>

Визуальный стиль генерации. Полный каталог с превью — на странице «Стили генерации».

Available options:
Y2K studio,
Street photography,
Editorial street style,
Warm ambient,
Drain,
Neutral pastel film,
Digital camera,
Old smartphone,
General,
Asian nostalgia,
Flash editorial,
Frutiger aero,
Muted cool film,
Double exposure,
Disposable camera,
Surreal solarization,
Underwater,
Siren,
Candy pop,
Mystique city,
Subtle flash,
80s horror,
New Indie,
Extraterrestrial,
Theatrical light,
Y2K street,
Warm contrast film,
Retro BW,
Swag era,
Nature light,
2000s band,
Warm vivid film,
BW film
Example:

"General"

enhance_prompt
boolean
default:true

Автоматическое улучшение промпта. При false промпт используется как есть.

response_format
enum<string>
default:b64_json

Формат результата — ссылка или изображение в base64.

Available options:
url,
b64_json

Response

Изображение сгенерировано

data
object[]

Список сгенерированных изображений.