API ИИ-улучшения промпта

На этой странице

Улучшение промпта

http

POST /open/v1/prompts/polish

Работает так же, как «ИИ-улучшение» на сайте: превращает идею в одном предложении в полноценный промпт с описанием объекта, сцены, освещения, композиции и стиля. Метод синхронный — результат возвращается сразу, опрашивать ничего не нужно.

curl https://api.zroimg.com/open/v1/prompts/polish \
  -H "Authorization: Bearer zk-xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a cat on a windowsill", "scene": "image"}'

Параметры запроса

Параметр	Тип	Обязательный	Описание
`prompt`	string	Да	Исходное описание, которое нужно улучшить
`scene`	string	Нет	`image` (по умолчанию) или `video` — улучшать промпт для изображения или для видео
`image_urls`	string[]	Нет	HTTPS-адреса референсных изображений, до 4 шт. (PNG / JPEG / WebP). Результат опирается на изображения: сохраняет объект, место, палитру, освещение и стиль, а `prompt` трактуется как нужное изменение или действие; для `video` описывается движение и работа камеры, начиная с изображения

Ответ

json

{
  "prompt": "A fluffy ginger cat curled up on a sunlit wooden windowsill, soft morning light, shallow depth of field, warm tones, cozy atmosphere",
  "cost_points": 1,
  "balance": 275
}

Поле	Тип	Описание
`prompt`	string	Улучшенный промпт
`cost_points`	integer	Списанные баллы
`balance`	integer	Баланс баллов после списания

Оплата и ограничения

Каждое улучшение оплачивается отдельно по той же цене, что и на сайте; если улучшение не удалось, баллы возвращаются автоматически.
Запросы учитываются в лимите методов отправки (20 запросов / минуту на ключ).
Если сервис улучшения на платформе недоступен, возвращается 400 invalid_request; при сбое внешнего сервиса возвращается 502 upstream_error, а баллы возвращаются.
Если передан image_urls, а модель улучшения на платформе не умеет читать изображения, возвращается 502 upstream_error, баллы возвращаются.

Улучшенный промпт можно сразу передать как prompt в генерацию изображений или генерацию видео.