Для быстрых циклов preview
Используйте Seedance 2.0 Mini API style requests, чтобы тестировать prompts, сравнивать motion ideas и делать компактные clips перед production render.
Руководство Seedance 2.0 Mini API
Seedance 2.0 Mini API для быстрой генерации AI-видео
Эта страница Seedance 2.0 Mini API объясняет, как построить легкий поток генерации на Seedance API v2. Используйте модель seedance-2-mini для компактных клипов, превью, social video и больших продуктовых очередей без собственной GPU-инфраструктуры.
- Длина клипа
- 4-15s
- Модель
- Mini
- Ввод
- T2V + I2V
- Интерфейс
- REST
4-15 second jobs
Use seedance-2-mini
Prompt или изображения
JSON по HTTPS
Mini-style запрос
Start with the native Seedance 2.0 Mini model
curl -X POST 'https://seedanceapi.org/v2/generate' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "seedance-2-mini",
"prompt": "A compact product reveal with smooth camera motion",
"duration": 8,
"resolution": "720p",
"aspect_ratio": "1:1"
}'Seedance API v2 exposes seedance-2-mini for Mini jobs. Use 4-15 second durations, 480p or 720p output, and focused prompts for lightweight generation.
Зачем использовать Seedance 2.0 Mini API?
Рабочий процесс Seedance 2.0 Mini API полезен, когда важны скорость, предсказуемая стоимость и простая REST-интеграция, а не длинный cinematic render.
Простой доступ по API key
Разработчики используют Bearer token, создают задачи через POST /v2/generate и опрашивают GET /v2/status так же, как в полном Seedance 2.0 API.
Границы для production
Короткая длительность, четкие aspect ratios и async polling помогают встроить Seedance 2.0 Mini API в очереди продукта и moderation flows.
Возможности Seedance 2.0 Mini API
Mini API workflow фокусируется на функциях Seedance 2.0 API, нужных легким video apps и автоматической preview generation.
Native Mini model
Установите model в seedance-2-mini для Seedance 2.0 Mini API behavior, быстрой итерации и малых jobs.
Text-to-video clips
Отправьте короткий prompt, aspect ratio, resolution и duration, чтобы генерировать короткие assets для apps, social media и creative testing.
Image-to-video motion
Передайте от одного до четырех image URLs или Mini-compatible reference video URLs в компактном Seedance 2.0 Mini API payload.
Короткие durations
Используйте любую целую duration от 4 до 15 секунд; 8 секунд удобно для Mini API preview flow.
Async status polling
Каждый запрос возвращает task id, поэтому приложение может polling status, обновлять UI и получить final video URL.
Общая база v2
Seedance 2.0 Mini API workflow использует те же v2 authentication, billing и response shape, что и широкий Seedance 2.0 API.
Как использовать Seedance 2.0 Mini API
Начните с существующих endpoint Seedance API v2 и настройте request для compact output.
Создайте API key
Войдите, откройте страницу API Keys и скопируйте ключ для server-side use. Не храните ключ в browser code или публичных repositories.
Submit a Mini job
Вызовите POST /v2/generate с model seedance-2-mini, tight prompt, duration 8, resolution 720p и нужным aspect ratio.
Poll and render
Используйте GET /v2/status с task_id. Когда status SUCCESS, прочитайте data.response[0] и покажите или сохраните video URL.
Шаблон запроса Seedance 2.0 Mini API
Mini API flow намеренно мал: authentication, create generation task, затем polling до completion.
POST /v2/generate
Создает Seedance 2.0 Mini generation task. Text prompts для text-to-video, images для image-to-video или reference_video_urls для video input.
GET /v2/status
Возвращает processing state, failure details или final response array с generated video URL.
Optional callback URL
Для async systems передайте public callback_url, если integration поддерживает. Не используйте localhost URLs.
Рекомендуемые параметры Mini API
| Параметр | Рекомендуемое значение |
|---|---|
| model | Используйте seedance-2-mini для Mini API workflow. |
| prompt | Будьте конкретны; максимум 2000 characters. |
| duration | Любое целое число от 4 до 15 секунд. |
| resolution | Используйте 480p или 720p для Mini output. |
| aspect_ratio | 16:9, 9:16, 4:3, 3:4, 1:1, 21:9 или adaptive для text-to-video. |
| images | Один-четыре HTTPS image URLs для image-to-video. |
| reference_video_urls | Optional Mini-compatible reference video URLs для video-guided generation. |
| reference_audio_urls | Optional reference audio URLs для Mini-compatible generation. |
| callback_url | Optional public webhook URL для async notifications. |
Полный reference смотрите в Seedance 2.0 API v2 docs. Эта страница сужает тот же API до Mini-style implementation.
Лучшие сценарии Seedance 2.0 Mini API
Mini API workflows подходят, когда нужны быстрые motion previews или легкое generated video внутри продукта.
Social video previews
Генерируйте компактные vertical clips для feed previews, ad ideas и creator tools.
Product motion tests
Анимируйте product shots или campaign visuals короткими image-to-video requests перед final creative.
Prompt iteration tools
Позвольте пользователям быстро тестировать prompt variants, сравнивать results и продвигать лучший prompt к larger render.
High-volume automation
Используйте short fast jobs для batch previews, content pipelines и apps с predictable throughput.
Заметки по production integration
Seedance 2.0 Mini API workflow требует такой же operational care, как любая production video API integration.
Запускайте calls с backend
Храните API keys на server, вызывайте Seedance API из backend code и открывайте клиентам только собственные safe endpoints.
Queue and retry jobs
Используйте queue для concurrency, retry transient failures и responsive UI во время processing.
Отслеживайте credits и status
Мониторьте credit usage, task status и error responses, чтобы Mini API workflow оставался предсказуемым.
Seedance 2.0 Mini API vs стандартное v2
Mini API — это workflow choice поверх Seedance API v2. Используйте его для fast clips и переходите к standard usage для качества или длительности.
Mini API ориентирован на speed
Используйте fast routing, shorter durations и tighter prompts, когда нужен quick feedback.
Standard v2 ориентирован на quality
Используйте стандартный Seedance 2.0 model path, когда важны cinematic quality и richer scenes.
Одна API base
Authentication, billing, status polling и response parsing одинаковы в Mini workflow и standard v2 usage.
| Capability | Mini workflow | Standard v2 usage |
|---|---|---|
| Model hint | seedance-2-mini | seedance-2.0 |
| Best duration | 4-15 seconds | 5, 10, or 15 seconds |
| Best use | Previews, batches, fast iteration | Final creative, richer storytelling |
| API shape | Same /v2/generate and /v2/status | Same /v2/generate and /v2/status |
FAQ по Seedance 2.0 Mini API
Ответы для developers, оценивающих Seedance 2.0 Mini API style integration.
Есть ли отдельный endpoint Seedance 2.0 Mini API?
Да. Используйте Seedance API v2 с model seedance-2-mini. Public route: POST /v2/generate, затем GET /v2/status.
Для чего лучше Seedance 2.0 Mini API?
Для short previews, social video tests, product motion drafts и high-volume prompt iteration.
Можно ли image-to-video?
Да. Передайте one to four image URLs в поле images и prompt с нужным motion.
С какой duration начать?
Mini поддерживает любую целую duration от 4 до 15 секунд. Начните с 8 секунд для quick previews, затем увеличьте duration для более complete scene.
Какие aspect ratios поддерживаются?
Для text-to-video Mini принимает 16:9, 9:16, 4:3, 3:4, 1:1, 21:9 и adaptive. Выберите ratio под ваш placement.
Как работает authentication?
Передавайте Authorization: Bearer YOUR_API_KEY в каждом request. Храните key на backend.
Как получить final video URL?
Poll GET /v2/status с task_id. Когда status SUCCESS, прочитайте first video URL из data.response[0].
Работает ли это с любым language?
Да. Workflow использует standard HTTPS и JSON, поэтому работает с cURL, Python, Node.js, Go, Java и другими clients.
Нужно ли вызывать API из browser?
Нет. Используйте backend или BFF, чтобы защитить API keys, validate prompts, rate limits и retries.
Как работает billing?
Seedance API использует credits. Cost зависит от model и duration, поэтому short fast jobs проще forecast.
Можно перейти с Mini workflow на standard Seedance 2.0?
Да. Оставьте endpoint и измените model hint, duration и prompt strategy для higher-quality production renders.
Где полная API documentation?
Откройте Seedance 2.0 API v2 docs для full request schema, response examples, pricing tables и error codes.
Создайте первый Seedance 2.0 Mini API job
Создайте API key, отправьте короткий Mini request и подключите lightweight AI video generation к продукту.