Применяйте высокостилизованные креативные эффекты и шаблоны к модным изображениям для социальных сетей.

Социальная студия

Конечная точка Social Studio применяет высокостилизованные, креативные эстетические шаблоны к вашим модным изображениям, превращая их в привлекательный контент, идеально подходящий для маркетинга в социальных сетях.

Название модели: social-studio

Жизненный цикл: stable

Время обработки: ~15–30 с

Формат вывода: Авто (JPEG или PNG)

Методы доставки: URL

Кредиты: от 2 до 5 за генерацию (зависит от качества)

Запрос

Отправьте ваше изображение и выбранный ID стиля на универсальную конечную точку /v1/run:

POSThttps://fititon.app/api/v1/run

Примеры запросов

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "social-studio",
           "inputs": {
             "personImage": "https://example.com/model-shot.jpg",
             "styleId": "action-figure",
             "quality": "2k",
             "sampleCount": 1
           }
         }'

Ответ

Поскольку генерация изображения может занимать до 30 секунд, конечная точка /v1/run немедленно возвращает статус 201 Created с асинхронным id задания. Вы должны опрашивать Status API, используя этот id, чтобы получить окончательное изображение. В качестве альтернативы вы можете настроить веб-хуки для автоматического получения уведомлений. Обратите внимание, что наш диспетчер веб-хуков применяет строгое 15-секундное ограничение по времени. Ваш сервер должен подтвердить веб-хук кодом состояния 2xx в течение 15 секунд, иначе мы посчитаем его неудачным и повторим попытку позже.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2024-03-10T12:00:00Z",
  "model_name": "social-studio"
}

Когда задание будет завершено (status: "success"), поле output будет содержать массив результирующих URL-адресов:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://cdn.fititon.app/users/123/results/social-studio-123-0.png"
  ],
  "error": null,
  "created_at": "2024-03-10T12:00:00Z",
  "updated_at": "2024-03-10T12:00:20Z"
}

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

Обязательные параметры

personImageRequiredstring

Исходное изображение для стилизации. Может быть общедоступным URL-адресом или строкой изображения в кодировке Base64.

Совет профессионала: Полноростовые фотографии, на которых виден весь человек, дают наилучшие стилизованные результаты. Четкая видимость лица имеет значение — ИИ использует черты лица для создания вашей стилизованной версии. Избегайте групповых фотографий или изображений, где вы частично скрыты за объектами.

Требование к форматированию При отправке строки Base64 она должна включать стандартный префикс URI данных (например, data:image/jpeg;base64,...). Хотя personImage принимает строки Base64, мы настоятельно рекомендуем использовать стандартные HTTP URL для изображений размером более 3 МБ, чтобы избежать превышения глобальных ограничений на размер полезной нагрузки JSON (HTTP 413) в вашем запросе.

styleIdRequiredstring

ID фотографического стиля, который будет применен к сгенерированному изображению. Он определяет освещение, эстетику и настроение.

Доступные стили:

Style Name	Style ID (`styleId`)

Необязательные параметры

quality'1k' | '2k' | '4k'

Уровень выходного разрешения. По умолчанию: 1k

sampleCountinteger

Количество вариантов изображения для генерации на один запрос. Должно быть от 1 до 4. По умолчанию: 1

ratiostring

Переопределение соотношения сторон. Если пусто, система по умолчанию использует 1:1 (идеально для Instagram/социальных лент).

Поддерживаемые значения: '1:1', '3:4', '4:3', '9:16', '16:9', '2:3', '3:2', '4:5', '5:4', '21:9'.

Ошибки выполнения

Ошибки выполнения для этой функции используют общий набор, задокументированный в Обработка ошибок. Если во время обработки возникает ошибка, status обновится до "error", а поле error будет содержать конкретную причину сбоя.

Стоимость кредитов

Для запросов Developer API стоимость зависит от выбранного уровня quality вывода, умноженного на sampleCount.

Формула: Стоимость = КредитыЗаКачество × sampleCount

Quality Tier	Credits per Image
1k (По умолчанию)	2
2k	3
4k	5