LogoSD 2.0 API

Seedance 2.0 Mini API 가이드

빠른 AI video generation을 위한 Seedance 2.0 Mini API

이 Seedance 2.0 Mini API 페이지는 Seedance API v2 위에서 lightweight generation flow를 만드는 방법을 설명합니다. short clips, previews, social video, high-volume product workflows에는 fast model path를 사용하세요.

API key 받기 v2 docs 보기
Clip length
5/10/15s

Compact jobs용

Model path
Fast

v2 Fast mode 사용

Inputs
T2V + I2V

Prompt 또는 images

Interface
REST

HTTPS JSON

Mini-style request

빠른 Seedance 2.0 route로 시작

seedance-2.0-fast 
curl -X POST 'https://seedanceapi.org/v2/generate' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "seedance-2.0-fast",
    "prompt": "A compact product reveal with smooth camera motion",
    "duration": 5,
    "aspect_ratio": "9:16"
  }'

Seedance API v2는 현재 seedance-2.0과 seedance-2.0-fast를 제공합니다. Mini API workflow에는 fast route, short duration, focused prompts를 사용하세요.

왜 Seedance 2.0 Mini API workflow를 쓰나요?

Seedance 2.0 Mini API workflow는 long-form cinematic rendering보다 speed, predictable costs, simple REST integration이 중요할 때 유용합니다.

빠른 preview loops

Seedance 2.0 Mini API style requests로 prompts를 테스트하고 motion ideas를 비교하며, longer production renders 전 compact clips를 만드세요.

간단한 API-key access

Bearer tokens로 인증하고 POST /v2/generate로 jobs를 만들며 GET /v2/status를 polling합니다. full Seedance 2.0 API와 같은 pattern입니다.

Production-friendly boundaries

Short duration, clear aspect ratios, async status polling은 Seedance 2.0 Mini API workflow를 product queues와 moderation flows에 맞추기 쉽게 합니다.

Seedance 2.0 Mini API capabilities

Mini API workflow는 lightweight video apps와 automated preview generation에 필요한 Seedance 2.0 API subset에 집중합니다.

Fast model routing

더 빠른 iteration과 smaller jobs가 필요하면 model을 seedance-2.0-fast로 설정하세요.

Text-to-video clips

Concise prompt, aspect ratio, duration을 보내 apps, social media, creative testing용 short video assets를 생성합니다.

Image-to-video motion

1~4개의 image URLs를 제공해 static references를 compact Seedance 2.0 Mini API payload로 animate합니다.

Short durations

5, 10, 15 second jobs를 사용하며 Mini API preview flow는 5초가 좋은 시작점입니다.

Async status polling

각 request는 task id를 반환하므로 app은 status를 poll하고 UI를 업데이트하며 final video URL을 가져올 수 있습니다.

Shared v2 foundation

Seedance 2.0 Mini API workflow는 broader Seedance 2.0 API와 같은 v2 authentication, billing, response shape를 사용합니다.

Seedance 2.0 Mini API 사용 방법

기존 Seedance API v2 endpoints로 시작하고 request를 compact output에 맞게 조정하세요.

1

API key 만들기

Sign in 후 API Keys 페이지에서 server-side use용 key를 복사하세요. key를 browser code나 public repositories에 넣지 마세요.

2

Fast job 제출

POST /v2/generate에 model seedance-2.0-fast, tight prompt, duration 5, 필요한 aspect ratio를 전달하세요.

3

Poll and render

returned task_id로 GET /v2/status를 호출하세요. status가 SUCCESS이면 data.response[0]에서 video URL을 읽습니다.

Seedance 2.0 Mini API request pattern

Mini API flow는 의도적으로 작게 유지됩니다: authenticate, generation task create, completion까지 poll.

POST /v2/generate

Seedance 2.0 Fast generation task를 만듭니다. text-to-video에는 text prompts, image-to-video에는 images를 사용합니다.

GET /v2/status

processing state, failure details 또는 generated video URL이 담긴 final response array를 반환합니다.

Optional callback URL

Async systems에서는 integration이 지원할 때 public callback_url을 포함하세요. localhost URLs는 사용하지 마세요.

Recommended Mini API parameters

ParameterRecommended value
modelMini API workflow에는 seedance-2.0-fast를 사용하세요.
promptFocused and specific하게 작성하세요. max 2000 characters.
durationPreviews는 5 seconds, richer clips는 10 또는 15 seconds.
aspect_ratioText-to-video에는 16:9, 9:16, 4:3, 3:4를 사용합니다.
imagesImage-to-video에는 1~4개의 HTTPS image URLs를 사용합니다.
callback_urlAsync notifications용 optional public webhook URL.

Full parameter reference는 Seedance 2.0 API v2 documentation을 보세요. 이 페이지는 같은 API를 Mini-style implementation으로 좁힌 것입니다.

Best Seedance 2.0 Mini API use cases

Mini API workflows는 quick motion previews나 existing product 안의 lightweight generated video가 필요할 때 적합합니다.

Social video previews

Feed previews, ad ideas, creator tools용 compact vertical clips를 생성하세요.

Product motion tests

Final creative 승인 전 short image-to-video requests로 product shots나 campaign visuals를 animate합니다.

Prompt iteration tools

Users가 many prompt variants를 빠르게 test, compare하고 best prompt를 larger render로 promote하게 하세요.

High-volume automation

Batch previews, content pipelines, predictable throughput이 필요한 apps에 short fast jobs를 사용하세요.

Production integration notes

Seedance 2.0 Mini API workflow도 모든 production video API integration과 같은 operational care가 필요합니다.

Backend에서 calls 실행

API keys를 server에 저장하고 backend code에서 Seedance API를 호출하며 clients에는 own safe endpoints만 expose하세요.

Queue and retry jobs

Queue로 concurrency를 관리하고 transient failures를 retry하며 video jobs processing 중 UI를 responsive하게 유지하세요.

Credits와 status 추적

Credit usage, task status, error responses를 monitor해 Mini API workflow가 scale해도 predictable하게 유지하세요.

Seedance 2.0 Mini API vs standard v2 usage

Mini API는 Seedance API v2 위의 workflow choice입니다. Fast clips에는 Mini, quality나 duration이 중요하면 standard usage로 전환하세요.

Mini API는 speed-oriented

Quick feedback이 필요할 때 fast routing, shorter durations, tighter prompts를 사용하세요.

Standard v2는 quality-oriented

Cinematic quality와 richer scenes가 priority이면 standard Seedance 2.0 model path를 사용하세요.

Both share one API base

Authentication, billing, status polling, response parsing은 Mini workflow와 standard v2 usage에서 일관됩니다.

CapabilityMini workflowStandard v2 usage
Model hintseedance-2.0-fastseedance-2.0
Best duration5 seconds10 or 15 seconds
Best usePreviews, batches, fast iterationFinal creative, richer storytelling
API shapeSame /v2/generate and /v2/statusSame /v2/generate and /v2/status

Seedance 2.0 Mini API FAQ

Seedance 2.0 Mini API style integration을 평가하는 developers를 위한 답변입니다.

별도 Seedance 2.0 Mini API endpoint가 있나요?

Mini-style behavior에는 Seedance API v2와 model hint seedance-2.0-fast를 사용하세요. 현재 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에 적합합니다.

Mini API workflow에서 image-to-video를 쓸 수 있나요?

예. images field에 1~4개의 image URLs를 보내고 원하는 motion에 prompt를 집중하세요.

어떤 duration으로 시작해야 하나요?

Quick Mini API previews는 5 seconds부터 시작하고 더 complete scene에는 10 또는 15 seconds를 사용하세요.

지원 aspect ratios는 무엇인가요?

Text-to-video에서 Seedance API v2는 16:9, 9:16, 4:3, 3:4를 지원합니다.

Requests 인증은 어떻게 하나요?

모든 request에 Authorization: Bearer YOUR_API_KEY를 전달하세요. key는 backend에 보관하세요.

Final video URL은 어떻게 얻나요?

task_id로 GET /v2/status를 poll합니다. status가 SUCCESS이면 data.response[0]에서 first video URL을 읽으세요.

어떤 programming language에서도 되나요?

예. Standard HTTPS와 JSON이라 cURL, Python, Node.js, Go, Java 등 HTTP clients와 작동합니다.

Browser에서 API를 직접 호출해야 하나요?

아니요. backend나 BFF를 사용해 API keys 보호, prompt validation, 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 docs는 어디에 있나요?

Seedance 2.0 API v2 docs에서 full request schema, response examples, pricing tables, error codes를 확인하세요.

첫 Seedance 2.0 Mini API job 만들기

API key를 만들고 short fast request를 보내 lightweight AI video generation을 product에 연결하세요.

API key로 시작 API documentation 열기