aisplice

По возможностям

Изображения

Выберите модель, скопируйте запрос и получите изображение. Всё, что ниже, подстраивается под выбранную модель.

#1. Выберите модель

#3. Получите результат

Запрос на отправку сразу возвращает task_id. Проверяйте задачу каждые несколько секунд, пока status не станет completed, или передайте webhook_url — и мы сообщим вам, когда всё будет готово.

GET https://www.aisplice.store/v1/images/tasks/{task_id}

GET https://www.aisplice.store/v1/images/tasks/{task_id}/content

Оплата только при успехе

За неудачную или отменённую задачу средства возвращаются автоматически. Итоговая стоимость каждой задачи видна в журнале запросов.

Значения статуса и опрос →Обратный вызов вместо проверок →

#Если что-то пошло не так

  • 400 с названием поля: эта модель не принимает такой параметр; используйте значения, указанные на шаге 2.
  • Модель отклонила содержимое: переформулируйте промпт; отклонённые запросы не оплачиваются.
  • 402: баланса не хватает на этот запрос; пополните его в разделе «Кошелёк» и повторите.
  • 429: снизьте частоту и повторите через Retry-After секунд.
  • 503 model_not_found: имя модели неверное или модель недоступна; выберите модель на шаге 1.

Найти другую ошибку →

#Референсные изображения

Передавайте публичные URL изображений в поле для референсных изображений, указанном на шаге 2. Локальный файл сначала загрузите и используйте полученный URL.

Как загрузить локальный файл →

Встраивание в ваш продуктКакие параметры показать пользователям сразу, а какие оставить на потом.
Какие настройки показать пользователям в первую очередьНачните с промпта и одной настройки, влияющей на цену; остальное добавляйте, когда базовый сценарий заработает.+

Творческий замысел

Поля вроде prompt должны быть в интерфейсе: пользователь сразу понимает, на что они влияют.

Множитель стоимости

Поля вроде duration, resolution, size и count стоит добавлять, только когда ценообразование уже можно понятно объяснить.

Переключатель режима

Поля вроде image, mask или ID для продолжения меняют сам сценарий работы и должны появляться только в отдельных режимах.

Служебные параметры

Поля вроде webhook_secret нужны интеграторам, а не обычным пользователям, поэтому не выносите их в стандартный интерфейс.

  • prompt
    Когда показывать
    Всегда. Это основные входные данные для задач генерации изображений.
    Рекомендуемое значение по умолчанию
    Обязательно в интерфейсе.
    Почему это важно
    Напрямую определяет результат; если его скрыть, функцией нельзя будет пользоваться.
  • size
    Когда показывать
    Показывайте в первом релизе, если стоимость зависит от размера результата.
    Рекомендуемое значение по умолчанию
    Начните с одного рекомендуемого соотношения сторон, например 1:1.
    Почему это важно
    Влияет и на стоимость, и на композицию результата, поэтому простой выбор размера нужен пользователям сразу.
  • quality
    Когда показывать
    Показывайте, только когда пользователи явно попросят более качественный или более дешёвый вариант.
    Рекомендуемое значение по умолчанию
    Оставьте на сервере значение модели по умолчанию.
    Почему это важно
    Влияет на цену и задержку, но обычно не нужен в интерфейсе с первого дня.
  • n
    Когда показывать
    Показывайте, только если пакетная генерация — основной сценарий.
    Рекомендуемое значение по умолчанию
    По умолчанию 1.
    Почему это важно
    Сразу умножает стоимость и может перегрузить первое знакомство с продуктом.
  • mask / image
    Когда показывать
    Показывайте только в продуктах для редактирования или работы с референсными изображениями.
    Рекомендуемое значение по умолчанию
    Скрывайте в режиме генерации изображений по тексту.
    Почему это важно
    Эти поля превращают генерацию в редактирование, поэтому им не место в базовом сценарии.
recommended-rollout.txt
Phase 1
- prompt
- one size or one duration default
- submit -> poll -> content

Phase 2
- one quality or resolution selector
- clear pricing hint

Phase 3
- advanced controls such as reference media, continuation, webhook, or vendor-specific tuning

Один источник истины для результатов

Когда задача завершится, стройте приложение вокруг URL платформы, который возвращает /content. Так детали вышестоящего провайдера остаются скрытыми, а воспроизведение старых результатов — стабильным.

Проблема не решена?

Пришлите нам ID запроса или текст ошибки, и мы разберёмся.

НазадЧатДалееВидео