Seedance 2.5 API: NSFW-видео без цензуры до 30 с

bytedance/seedance-2.5/image-to-video

Seedance 2.5 image-to-video от ByteDance начинает клип с вашего изображения и оживляет его, звук — за тот же проход. Клипы по 4–30 секунд в 480p, 720p или 1080p; необязательный финальный кадр задаёт, на чём закончится план.

От $0.123/с

Запустить модель Открыть API

Отправить запрос

Примеры используют публичные параметры выбранного эндпоинта. Замените API-ключ и примеры медиафайлов, затем отправьте запрос со своего сервера.

SDK и интеграции

POSThttps://api.spicyapi.ai/api/v1/jobs/createTask

Аутентификация API

Храните API-ключ в серверной переменной окружения SPICY_API_KEY. Используйте Bearer-аутентификацию и Content-Type: application/json для JSON-запросов.

Authorization: Bearer $SPICY_API_KEY

Пример результата

# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "bytedance/seedance-2.5/image-to-video",
  "input": {
    "aspect_ratio": "adaptive",
    "duration_seconds": 5,
    "generate_audio": true,
    "image_url": "https://example.com/reference.png",
    "output_format": "mp4",
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise"
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Пример построен по входной схеме этой модели — той же, по которой API проверяет каждый запрос.

Входные параметры

Поместите эти поля в объект input тела запроса. Имена и типы соответствуют API. Не предполагайте значение по умолчанию, если оно не задано.

image_urlstringОбязательно

Обязателен и становится первым кадром видео. Композиция, внешность и цвет приходят отсюда же, и этим задан потолок качества результата: точный кадр важнее любых попыток дописать результат словами. Берите резкий кадр с ясным субъектом и без заметных артефактов сжатия. Собственная проверка входных данных Seedance может отклонить фото, на котором видно лицо реального узнаваемого человека. Каждая сторона должна быть от 300 до 6000 пикселей; изображения меньшего размера отсекает входная проверка, и списания при этом не происходит.

По умолчанию: Не задано
Ограничения: contentMediaType:["image/jpeg","image/png","image/webp","image/gif"]

watermarkbooleanНеобязательно

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

По умолчанию: false

return_last_framebooleanНеобязательно

Дополнительно возвращает последний кадр ролика отдельным изображением рядом с видео. Отправьте его следующим стартовым кадром в image-to-video, чтобы склеивать планы без ручной выгрузки кадра. По умолчанию выключено; на цену не влияет.

По умолчанию: false

seedintegerНеобязательно

Целочисленный seed; уберите его — и каждый прогон возьмёт свой. Зафиксируйте при неизменном остальном, чтобы понять, что на самом деле изменила правка prompt. Это инструмент сравнения, а не обещание покадрового повтора.

По умолчанию: Не задано
Ограничения: minimum:0
maximum:2147483647

enable_web_searchbooleanНеобязательно

По умолчанию выключено. Если включить, модель может перед рендером поискать в интернете сведения, связанные с промптом. На цену не влияет.

По умолчанию: false

output_formatstringНеобязательно

Контейнер готового видео: mp4 (по умолчанию) или mov. Картинка в обоих одинаковая; mov хранит звук в несжатом PCM, поэтому файл немного больше и сразу открывается в монтажных программах, которые предпочитают QuickTime. На цену не влияет.

По умолчанию: "mp4"
Допустимые значения: "mp4""mov"

generate_audiobooleanНеобязательно

По умолчанию включён. Даёт родную дорожку, синхронную картинке: тон помещения, эффекты движения, голос. Выключайте для товарных роликов, которые озвучат на посте. Оставляйте включённым, когда шаги и атмосфера — часть замысла.

По умолчанию: true

duration_secondsintegerНеобязательноВлияет на цену

От 4 до 30 секунд, по умолчанию 5. Чем дольше идёт кадровая сцена, тем сильнее она плывёт: анатомия и обстановка деформируются постепенно. Подтвердите направление движения на 5 секундах и только потом удлиняйте. Для по-настоящему длинных сцен несколько коротких дублей, смонтированных подряд, обычно держатся лучше одного дубля на 30 с. Длина линейно масштабирует оплачиваемое количество.

По умолчанию: 5
Допустимые значения: 456789101112131415161718192021222324252627282930

resolutionstringНеобязательноВлияет на цену

480p, 720p или 1080p, по умолчанию 720p. Напрямую влияет на оплачиваемое количество. Учтите: выходная ступень не зависит от исходника — мягкий кадр низкого разрешения, отрендеренный в 1080p, останется увеличенной мягкостью. Выбранная ступень — это ступень рендера, без апскейла и слоя улучшения сверху.

По умолчанию: "720p"
Допустимые значения: "480p""720p""1080p"

aspect_ratiostringНеобязательно

Здесь принимается только `adaptive`: Seedance 2.5 всегда строит кадр image-to-video по геометрии стартового кадра, и фиксированная форма приведёт к ошибке задачи. Если формат доставки задан заранее, обрежьте или дополните кадр до отправки. На тарификацию не влияет.

По умолчанию: "adaptive"
Допустимые значения: "adaptive"

last_image_urlstringНеобязательно

Необязательный финальный кадр, который **нельзя отправить отдельно** — он допустим только вместе с `image_url`. Отправьте оба, и модель поставит переход от одного к другому: это удобно для трансформаций, распаковок и кадров «до/после». Не отправите — финал определит prompt. Кадры, сильно расходящиеся по композиции или свету, делают середину перехода непредсказуемой. Каждая сторона должна быть от 300 до 6000 пикселей; изображения меньшего размера отсекает входная проверка, и списания при этом не происходит.

По умолчанию: Не задано
Ограничения: contentMediaType:["image/jpeg","image/png","image/webp","image/gif"]

promptstringНеобязательно

Здесь необязателен, но писать его стоит: он должен описывать, что происходит после кадра, а не пересказывать видимое — действие, движение камеры, ход времени, звук. Без него движение модель выбирает сама. Картинка уже зафиксирована снимком, поэтому именно этот путь выдерживает задания без цензуры: формулировки, которые защитный слой Seedance отклоняет с чистого листа, обычно проходят, когда содержание несёт сам кадр.

По умолчанию: Не задано

{
  "additionalProperties": false,
  "properties": {
    "aspect_ratio": {
      "default": "adaptive",
      "description": "Aspect ratio of the generated video. Seedance 2.5 frames an image-to-video clip on the first frame, so adaptive is the only accepted value.",
      "enum": [
        "adaptive"
      ],
      "type": "string",
      "x-ui": {
        "affects_price": false,
        "order": 70,
        "widget": "select"
      }
    },
    "duration_seconds": {
      "default": 5,
      "description": "Clip length in seconds. This is the billed quantity.",
      "enum": [
        4,
        5,
        6,
        7,
        8,
        9,
        10,
        11,
        12,
        13,
        14,
        15,
        16,
        17,
        18,
        19,
        20,
        21,
        22,
        23,
        24,
        25,
        26,
        27,
        28,
        29,
        30
      ],
      "type": "integer",
      "x-ui": {
        "advanced": false,
        "affects_price": true,
        "order": 50,
        "unit": "s",
        "widget": "slider"
      }
    },
    "enable_web_search": {
      "default": false,
      "description": "Let the model search the web for information related to the prompt before rendering.",
      "type": "boolean",
      "x-ui": {
        "advanced": true,
        "affects_price": false,
        "order": 35,
        "widget": "switch"
      }
    },
    "generate_audio": {
      "default": true,
      "description": "Generate a native soundtrack synchronised to the picture.",
      "type": "boolean",
      "x-ui": {
        "advanced": false,
        "affects_price": true,
        "order": 40,
        "widget": "switch"
      }
    },
    "image_url": {
      "contentMediaType": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif"
      ],
      "description": "URL of the image used as the first frame.",
      "type": "string",
      "x-ui": {
        "affects_price": false,
        "order": 90,
        "widget": "upload"
      }
    },
    "last_image_url": {
      "contentMediaType": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif"
      ],
      "description": "URL of the image used as the closing frame. Only accepted together with image_url.",
      "type": "string",
      "x-ui": {
        "affects_price": false,
        "order": 80,
        "widget": "upload"
      }
    },
    "output_format": {
      "default": "mp4",
      "description": "Container of the returned video.",
      "enum": [
        "mp4",
        "mov"
      ],
      "type": "string",
      "x-ui": {
        "advanced": true,
        "affects_price": false,
        "order": 36,
        "widget": "radio"
      }
    },
    "prompt": {
      "description": "What to generate: subject, action, camera movement and mood.",
      "type": "string",
      "x-ui": {
        "affects_price": false,
        "order": 100,
        "primary": true,
        "widget": "textarea"
      }
    },
    "resolution": {
      "default": "720p",
      "description": "Output resolution. Super-resolution tiers are not offered.",
      "enum": [
        "480p",
        "720p",
        "1080p"
      ],
      "type": "string",
      "x-ui": {
        "advanced": false,
        "affects_price": true,
        "order": 60,
        "widget": "radio"
      }
    },
    "return_last_frame": {
      "default": false,
      "description": "Also return the clip’s final frame as a separate image.",
      "type": "boolean",
      "x-ui": {
        "affects_price": false,
        "order": 26,
        "widget": "switch"
      }
    },
    "seed": {
      "description": "Random seed. Omit to let the model pick one.",
      "maximum": 2147483647,
      "minimum": 0,
      "type": "integer",
      "x-ui": {
        "affects_price": false,
        "order": 30,
        "widget": "number"
      }
    },
    "watermark": {
      "default": false,
      "description": "Ask the model to watermark the video as AI-generated.",
      "type": "boolean",
      "x-ui": {
        "advanced": true,
        "affects_price": false,
        "order": 22,
        "widget": "switch"
      }
    }
  },
  "required": [
    "image_url"
  ],
  "type": "object",
  "x-pricing": {
    "billingMode": "duration_capped",
    "variantFields": [
      "resolution",
      "generate_audio"
    ]
  }
}

Отследить задачу

HTTP 202 означает принятие задачи, а не завершение генерации. Сохраните полученный taskId и проверяйте эту задачу. Не создавайте новую, пока ждёте результат.

Ответ при приёме задачи

HTTP/1.1 202 Accepted
Location: /api/v1/jobs/recordInfo?taskId=job_01k3m8x9q2z4v7n5p6r8s0t1w3

{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_create",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued",
    "estimatedCost": "0.750000"
  }
}

В ответе о приёме есть оценка стоимости — приложение сможет показать ту же сумму в истории задач и в расчётах.

Получить задачу

curl --get "https://api.spicyapi.ai/api/v1/jobs/recordInfo" \
  --data-urlencode "taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Начните с интервала около 2 секунд и постепенно увеличивайте его. Прекратите опрос при конечном состоянии. После сбоя соединения используйте исходный taskId. Повторно создавать задачу можно только с исходным ключом идемпотентности и исходным телом запроса.

Или пусть вызов придёт сам

import { verifyWebhook } from "@spicyapi/sdk";

// express.raw keeps the bytes we signed; express.json never matches.
app.post("/hooks/spicy", express.raw({ type: "application/json" }), (req, res) => {
  const { payload } = verifyWebhook({
    rawBody: req.body,
    timestamp: req.header("X-Webhook-Timestamp"),
    signature: req.header("X-Webhook-Signature"),
    payloadVersion: Number(req.header("X-Webhook-Payload-Version")),
    secret: process.env.SPICY_WEBHOOK_SECRET,
  });
  res.status(200).end();
  void handleFinishedTask(payload);
});

Передайте callBackUrl при создании задачи — готовая запись придёт к вам POST-запросом, и никакого опроса не понадобится. В каждой доставке есть X-Webhook-Timestamp, X-Webhook-Signature и X-Webhook-Payload-Version. Подпись — это HMAC-SHA256 в base64 от taskId.timestamp.sha256(body), поэтому проверять её нужно по исходным байтам: если разобрать JSON и сериализовать заново, байты изменятся и проверка не пройдёт. Неудачные доставки повторяются, так что один и тот же taskId может прийти дважды — сделайте обработчик идемпотентным. Сначала ответьте 2xx, работу выполняйте после: медленный обработчик считается неудачной доставкой.

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

Обрабатывайте output только при state, равном succeeded. При ошибке проверьте errorCode, errorMessage и request_id. Стоимость и состояния в примерах не являются фактическим счётом.

Пример ответа после завершения

{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_record",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "bytedance/seedance-2.5/image-to-video",
    "state": "succeeded",
    "output": {
      "assets": [
        {
          "key": "tasks/2026/08/28/job_01k3m8x9q2z4v7n5p6r8s0t1w3/3f7a1c9e5b2d48f0a6c1e3d5b7f9a1c3.mp4",
          "mime": "video/mp4",
          "url": "https://example.r2.cloudflarestorage.com/results/job_01k3m8x9q2z4v7n5p6r8s0t1w3/result.mp4?X-Amz-Signature=SIGNATURE_FROM_RESPONSE",
          "expiresAt": "2026-08-28T12:20:08.000Z"
        }
      ]
    },
    "cost": "0.750000",
    "settled": true,
    "createdAt": "2026-08-28T12:00:00Z",
    "completedAt": "2026-08-28T12:00:30Z"
  }
}

Доступные файлы можно открыть или скачать по assets[].url без заголовка API Authorization. Подписанная ссылка действует до expiresAt. Чтобы обновить её, повторно запросите задачу в течение срока хранения файла. У ожидающих или недоступных файлов URL отсутствует. Не передавайте подписанные ссылки посторонним.

SDK и интеграции

Используйте SpicyAPI в приложении, терминале, ИИ-ассистенте или визуальном процессе. Выберите руководство по настройке.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Команды терминала и скрипты автоматизации.

MCP

Claude Code · Cursor · Codex

Agent Skill

Многоразовые инструкции для ИИ-ассистента.

n8n

Узлы сообщества для самостоятельного хостинга и импортируемые шаблоны HTTP Request для n8n Cloud.

ComfyUI

Процессы работы с изображениями, видео и аудио на узловом холсте.

Другие интеграции

SillyTavern Telegram / Discord App proxy OpenAI SDK LangChain Vercel AI SDK

Посмотреть готовые рабочие процессы

Писать код выше вовсе не обязательно. Подключите сервер MCP один раз — и любой агент, который говорит на MCP (Claude Code, Codex, Cursor, Windsurf, VS Code, Gemini CLI, Cline, LibreChat), вызовет эту модель по имени. Либо запустите её из терминала одной командой.

Просто скажите это агенту

Возьми bytedance/seedance-2.5/image-to-video и оживи ./poster.png — медленный наезд, пять секунд — и положи клип рядом.

Агент найдёт модель в каталоге, сам загрузит локальный файл, покажет точную смету и предельную сумму списания — и дождётся вашего согласия. До этого ничего не списывается.

Подключается один раз

claude mcp add spicyapi -e SPICY_API_KEY=$SPICY_API_KEY \
  -- npx --yes --package=@spicyapi/mcp spicyapi-mcp
npx skills add spicyapi-ai/spicy-skill

Первая строка даёт агенту инструменты, вторая — Skill, то есть правила обращения с ними: сначала смета, потом списание; локальные файлы загружать, а не вставлять байтами; URL готового результата читать, а не угадывать. Остальные клиенты подключают тот же сервер через собственный файл настроек — см. раздел для разработчиков.

Или одна команда в терминале

npx @spicyapi/cli tasks create --model bytedance/seedance-2.5/image-to-video \
  --input-json '{"aspect_ratio":"adaptive","duration_seconds":5,"generate_audio":true,"image_url":"https://example.com/reference.png","output_format":"mp4","prompt":"A slow aerial shot drifting over a misty pine forest at sunrise"}' \
  --wait

Входные данные взяты из схемы этого эндпоинта — той же, что и в примерах выше. --wait дождётся завершения задачи и выведет её, а --yes пропустит подтверждение в CI. Сначала задайте SPICY_API_KEY: один ключ работает и для API, и для CLI, и для сервера MCP.

Локальные файлы

npx @spicyapi/cli files upload ./poster.png
# -> spicy://uploads/01k3m8x9q2z4v7n5p6r8s0t1w3

npx @spicyapi/cli tasks create --model bytedance/seedance-2.5/image-to-video \
  --input-json '{"image_url":"spicy://uploads/01k3m8x9q2z4v7n5p6r8s0t1w3"}' \
  --wait

В запрос попадают URL, а не байты. Сначала загрузите файл и подставьте выданный spicy:// URI — имя поля выше взято из схемы этого эндпоинта. Агент через MCP делает это сам, потому фраза выше и может прямо назвать ./poster.png. Медиа, уже доступное по публичному HTTPS, загружать не нужно.

Сколько хранятся результаты

npx @spicyapi/cli tasks create --model bytedance/seedance-2.5/image-to-video \
  --input-json '{…}' --retention 1h --wait

npx @spicyapi/cli tasks get $TASK_ID   # read back the retention that applied

Ключ --retention только сокращает срок — 30m, 1h, 7d или 0, чтобы удалить сразу после перехода задачи в конечное состояние. Реально действует наименьшее из трёх: ваш запрос, настройки аккаунта и предел платформы, — поэтому считайте его из записи задачи, а не исходите из того, что запрошенное число применилось. Запросить срок больше разрешённого аккаунтом нельзя: это ничего не изменит.

Использование в ComfyUI

Установите узлы SpicyAPI через ComfyUI Manager или командой ниже и найдите на холсте Seedance 2.5 · Image to Video. У узла те же параметры, что и на этой странице, а цена показывается до запуска.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi

Готовые воркфлоу Руководство по установке Исходный код на GitHub

Встроенная панель читает ту же схему, что и эта страница, поэтому не может разойтись с API. Если содержимое должно индексироваться поиском по документации, возьмите JSON из /api/embed/models/ и отрисуйте его самостоятельно.

<iframe src="https://spicyapi.ai/embed/ru/models/seedance-2-5/api?model=bytedance%2Fseedance-2.5%2Fimage-to-video" width="100%" height="560" loading="lazy" title="Пример запроса" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Открыть панель

Рабочая область

Отправить запрос

Аутентификация API

Входные параметры

Отследить задачу

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

SDK и интеграции

Использование в ComfyUI