高速プレビュー向け
Seedance 2.5 API style requestsでpromptを試し、motion ideasを比較し、大きなrender前にコンパクトなclipsを作れます。
Seedance 2.5 API ガイド
高速AI動画生成のための Seedance 2.5 API
このSeedance 2.5 APIページでは、Seedance API v2上で軽量な生成フローを作る方法を説明します。seedance-2.0モデルを使い、コンパクトなクリップ、プレビュー、ソーシャル動画、高ボリュームのプロダクトワークフローに対応します。
- クリップ長
- 5-15s
- モデル経路
- v2
- 入力
- T2V + I2V
- インターフェース
- REST
4-15秒のjobs
seedance-2.0を使用
Promptまたは画像
HTTPS上のJSON
2.5 planning request
ネイティブの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.0",
"prompt": "A cinematic product reveal with smooth dolly-in camera motion",
"duration": 10,
"aspect_ratio": "16:9"
}'Seedance API v2はMini jobs向けにseedance-2.0を提供します。軽量生成には4-15秒のduration、480pまたは720p output、focused promptsを使います。
Seedance 2.5 APIワークフローを使う理由
Seedance 2.5 APIワークフローは、長いcinematic renderingよりも速度、予測しやすいコスト、シンプルなREST integrationを重視するチームに適しています。
API keyで簡単に接続
Bearer tokenで認証し、POST /v2/generateでjobを作成し、GET /v2/statusでpollingします。full Seedance 2.0 APIと同じpatternです。
productionに合う境界
短いduration、明確なaspect ratios、async status pollingにより、Seedance 2.5 API workflowはproduct queueやmoderation flowに入れやすくなります。
Seedance 2.5 APIの機能
2.5 API workflowは、軽量video appsとautomated preview generationに必要なSeedance 2.0 API機能に集中します。
Native Mini model
素早いiterationと小さなjobsが必要な場合、modelをseedance-2.0に設定します。
Text-to-video clips
短いprompt、aspect ratio、resolution、durationを送り、apps、social media、creative testing向けの短いvideo assetsを生成します。
Image-to-video motion
1から4個のimage URLs、またはMini-compatible reference video URLsを渡し、Seedance 2.5 API payloadをコンパクトに保ちます。
短いduration
4から15秒までの任意のinteger durationを使えます。2.5 API previewsは8秒から始めるのが実用的です。
Async status polling
各requestはtask idを返すため、appはstatusをpollし、UIを更新し、完了時にfinal video URLを取得できます。
共通のv2基盤
Seedance 2.5 API workflowは、広いSeedance 2.0 APIと同じv2 authentication、billing、response shapeを使います。
Seedance 2.5 APIの使い方
既存のSeedance API v2 endpointsから始め、requestをcompact output向けに調整します。
API keyを作成
ログインしてAPI Keysページを開き、server-side use用のkeyをコピーします。keyをbrowser codeやpublic repositoryに置かないでください。
Mini jobを送信
POST /v2/generateにmodel seedance-2.0、tight prompt、duration 8、resolution 720p、必要なaspect ratioを渡します。
pollして表示
返されたtask_idでGET /v2/statusを使います。statusがSUCCESSならdata.response[0]を読み、video URLを表示または保存します。
Seedance 2.5 API request pattern
2.5 API flowは小さく保ちます。authenticate、generation task作成、completionまでpollingです。
POST /v2/generate
Seedance 2.0 Mini generation taskを作成します。text-to-videoはtext prompts、image-to-videoはimages、video inputにはreference_video_urlsを使います。
GET /v2/status
processing state、failure details、またはgenerated video URLを含むfinal response arrayを返します。
Optional callback URL
async systemsでは、integrationが対応する場合にpublic callback_urlを含めます。localhost URLsは使わないでください。
推奨2.5 API parameters
| Parameter | Recommended value |
|---|---|
| model | 2.5 API workflowにはseedance-2.0を使います。 |
| prompt | focusedでspecificにします。最大2000文字です。 |
| duration | 4から15秒までの任意の整数です。 |
| resolution | Mini outputには480pまたは720pを使います。 |
| aspect_ratio | text-to-videoでは16:9、9:16、4:3、3:4、1:1、21:9、adaptiveを使います。 |
| images | image-to-videoでは1から4個のHTTPS image URLsを使います。 |
| reference_video_urls | video-guided generation向けのoptional Mini-compatible reference video URLsです。 |
| reference_audio_urls | Mini-compatible generation向けのoptional reference audio URLsです。 |
| callback_url | async notifications用のoptional public webhook URLです。 |
完全なparameter referenceはSeedance 2.0 API v2 docsを参照してください。このページは同じAPIを2.5 planning implementationに絞っています。
Seedance 2.5 APIの主な用途
2.5 API workflowsは、既存product内でquick motion previewsや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を動かします。
Prompt iteration tools
多くのprompt variantsを素早く試し、resultsを比較し、best promptをlarger renderへ進めます。
High-volume automation
batch previews、content pipelines、predictable throughputが必要なappsにshort fast jobsを使います。
Production integration notes
Seedance 2.5 API workflowにも、production video API integrationと同じoperational careが必要です。
backendから呼び出す
API keysをserverに保存し、backend codeからSeedance APIを呼び、clientsには自分のsafe endpointsだけを公開します。
jobsをqueueしてretry
queueでconcurrencyを管理し、transient failuresをretryし、video jobs処理中もUIをresponsiveに保ちます。
creditsとstatusを追跡
credit usage、task status、error responsesを監視し、2.5 API workflowを予測可能に保ちます。
Seedance 2.5 APIとstandard v2 usage
2.5 APIはSeedance API v2上のworkflow choiceです。fast clipsにはMini、qualityやduration重視ならstandard usageへ切り替えます。
2.5 APIはspeed-oriented
quick feedbackが必要な時はfast routing、shorter durations、tighter promptsを使います。
Standard v2はquality-oriented
cinematic qualityとricher scenesを重視する時はstandard Seedance 2.0 model pathを使います。
同じAPI baseを共有
authentication、billing、status polling、response parsingは2.5 planningとstandard v2 usageで一貫しています。
| Capability | 2.5 planning | Standard v2 usage |
|---|---|---|
| Model hint | seedance-2.0 | seedance-2.0 |
| Best duration | 5-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 |
Seedance 2.5 API FAQ
Seedance 2.5 API style integrationを検討するdevelopers向けの回答です。
別のSeedance 2.5 API endpointはありますか？
はい。Seedance API v2でmodel seedance-2.0を使います。現在のpublic routeはPOST /v2/generate、その後GET /v2/statusです。
Seedance 2.5 APIは何に向いていますか？
short previews、social video tests、product motion drafts、high-volume prompt iterationに向いています。
2.5 API workflowでimage-to-videoは使えますか？
はい。images fieldに1から4個のimage URLsを送り、欲しいmotionにpromptを絞ります。
どのdurationから始めるべきですか？
Miniは4から15秒までの任意のinteger durationをサポートします。quick previewsは8秒から始め、よりcomplete sceneにはdurationを増やします。
対応aspect ratiosは？
text-to-videoでは、Miniは16:9、9:16、4:3、3:4、1:1、21:9、adaptiveを受け付けます。配置に合うratioを選びます。
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などで使えます。
browserから直接APIを呼ぶべきですか？
いいえ。backendまたはBFFでAPI keysを保護し、prompts検証、rate limits、retriesを扱います。
billingはどうなりますか？
Seedance APIはcreditsを使います。costはmodelとdurationに依存するため、short fast jobsは予測しやすいです。
2.5 planningからstandard Seedance 2.0に移れますか？
はい。同じendpointのままmodel hint、duration、prompt strategyを変えるだけで、higher-quality production rendersへ移れます。
完全なAPI docsはどこですか？
Seedance 2.0 API v2 docsでrequest schema、response examples、pricing tables、error codesを確認できます。
最初のSeedance 2.5 API jobを作成
API keyを作成し、短いMini requestを送り、軽量AI video generationを製品に接続します。