Разработчикам · API

Оденьте любой товар
одним вызовом API.

Тот же движок, что и в приложении NoShot, — в виде чистого REST API. Отправьте фото товара и получите фотореалистичные рендеры на модели и чистые маски: за секунды, в масштабе каталога.

Хост: api.noshot.co
Вызов: POST /v1/generate
онлайн: 200 OK · 4 рендера · 4K + маски

Получить API-ключ Быстрый старт

<15s

на кадр

чистые маски

эндпоинта

500+

брендов строят

Зачем API

Продакшн-визуал как эндпоинт

Всё, что умеет приложение, — вызовом из вашего пайплайна, PIM или витрины. Без окна загрузки и ручной арт-дирекции.

Кадры на модели программно

Один POST превращает предметное фото в фотореалистичные рендеры на модели. Модель, поза, свет и сцена задаются параметрами, а не кликами.

Пакетно, в масштабе каталога

Прогоняйте тысячи SKU через /v1/batch одним запросом. Те же кредиты, одна задача для отслеживания — рассчитано на объёмы маркетплейса.

Экспорт в 4K, чистые маски

Каждый рендер отдаётся вплоть до 4K с альфа-маской попиксельной точности — готово к композиту или сразу в карточку товара.

Вебхуки вместо опроса

Подпишитесь на job.succeeded — и мы отправим готовые ссылки POST-запросом на ваш эндпоинт, как только они появятся. Никаких холостых циклов.

Быстрый старт

Первый рендер за один запрос

Авторизуйтесь bearer-токеном, отправьте POST с фото товара и параметрами модели и сцены, затем опросите задачу или поймайте вебхук. Вот весь цикл целиком.

Запрос

cURLPOST /v1/generate

curl -X POST https://api.noshot.co/v1/generate \
  -H "Authorization: Bearer $NOSHOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_image_url": "https://cdn.yourbrand.com/sku/8842-front.jpg",
    "category": "apparel",
    "model": { "gender": "female", "body": "medium", "skin_tone": "III" },
    "scene": { "preset": "studio-daylight", "background": "seamless-bone" },
    "output": { "count": 4, "resolution": "4k", "mask": true }
  }'

NodePOST /v1/generate

import NoShot from "@noshot/sdk";

const noshot = new NoShot({ apiKey: process.env.NOSHOT_API_KEY });

const job = await noshot.generate({
  productImageUrl: "https://cdn.yourbrand.com/sku/8842-front.jpg",
  category: "apparel",
  model: { gender: "female", body: "medium", skinTone: "III" },
  scene: { preset: "studio-daylight", background: "seamless-bone" },
  output: { count: 4, resolution: "4k", mask: true },
});

console.log(job.id, job.status); // "job_9f8c2a1b7d", "succeeded"

PythonPOST /v1/generate

import os
from noshot import NoShot

noshot = NoShot(api_key=os.environ["NOSHOT_API_KEY"])

job = noshot.generate(
    product_image_url="https://cdn.yourbrand.com/sku/8842-front.jpg",
    category="apparel",
    model={"gender": "female", "body": "medium", "skin_tone": "III"},
    scene={"preset": "studio-daylight", "background": "seamless-bone"},
    output={"count": 4, "resolution": "4k", "mask": True},
)

print(job.id, job.status)  # "job_9f8c2a1b7d", "succeeded"

Ответ

JSON200 OK

{
  "id": "job_9f8c2a1b7d",
  "status": "succeeded",
  "credits_used": 4,
  "images": [
    {
      "url": "https://cdn.noshot.co/v1/renders/9f8c2a1b7d/01.png",
      "width": 3072,
      "height": 4096,
      "mask_url": "https://cdn.noshot.co/v1/renders/9f8c2a1b7d/01-mask.png"
    },
    {
      "url": "https://cdn.noshot.co/v1/renders/9f8c2a1b7d/02.png",
      "width": 3072,
      "height": 4096,
      "mask_url": "https://cdn.noshot.co/v1/renders/9f8c2a1b7d/02-mask.png"
    }
  ],
  "created_at": "2026-07-22T09:41:20Z"
}

Пример для иллюстрации — полный набор параметров и все пресеты сцен смотрите в актуальном справочнике внутри приложения.

Один вызов — оба конца

Шёлковое платье-колонна — Шёлк цвета слоновой кости в косом крое, вырез с бисером — ВходШёлковое платье-колонна

Шёлковое платье-колонна — Каждая бусина там, где вы её пришили — Выход3072 × 4096

Эндпоинты

Маленькая поверхность — намеренно

Четыре эндпоинта покрывают весь жизненный цикл — генерация, статус, пакет, справочник.

POST: /v1/generateСоздаёт задачу рендера из одного фото товара и ваших параметров модели и сцены.
GET: /v1/jobs/{id}Возвращает статус задачи, ссылки на изображения и на маски.
POST: /v1/batchСтавит в очередь много SKU одним запросом — для прогонов масштаба каталога.
GET: /v1/modelsСписок доступных пресетов моделей, типов фигуры, оттенков кожи и сцен.

Лимиты и цены

На кредитах — и просто

Один кадр — один кредит. Вот и вся модель цен.

01: 1 кадр = 1 кредит. Дополнительные рендеры в запросе списываются с того же баланса.
02: За неудавшиеся и отклонённые рендеры мы не списываем ничего.
03: Каждый ответ возвращает заголовок X-Credits-Remaining — расход всегда под счётчиком.
04: Лимиты растут вместе с тарифом; на Enterprise их нет вовсе.

ТарифКадрыЛимит

Free1030 зап/мин

Starter100 / мес60 зап/мин

StudioПопулярный выбор400 / мес120 зап/мин

EnterpriseБез лимитаПо запросу

Кредиты берутся из вашего тарифа NoShot — все уровни на странице «Цены».

Тарифы и кредиты

Полный справочник

Вся документация — внутри приложения

Каждый параметр, событие вебхука, код ошибки и официальный SDK — с версиями и интерактивно — лежат в вашей панели. Заведите ключ, и справочник откроется рядом.

Открыть справочник API

Кадры на модели —
программно.

Начать бесплатно Записаться на демо

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