Seedance 2.5
Seedance 2.5 モデルは統一された非同期ジョブ API で呼び出します。POST /api/generate でタスクを開始し、完了するまで GET /api/generate/{taskId} をポーリングします。このファミリーは 10 個のエンドポイントを提供します。
概要
すべてのエンドポイントは同じ外枠を共有し、変わるのは model と input フィールドだけです。モデルマーケットの playground から任意に実行できます。
Three mutually exclusive modes — match fields to the model slug:
- image-to-video:
first_frame_urlonly;aspect_ratiomust beadaptive; setfirst_frame_portrait_kind: skipfor scenes. - first-last-frame:
first_frame_url+last_frame_url; also requiresadaptive. - omni-reference:
reference_image_urlsplus optional video/audio; mark portraitsvirtual/real, backgroundsskip; fixed ratios like16:9work.
On direct routes, only portraits are ingested to the portrait library; scenes, video, and audio stay as direct URLs. Copy the full API doc from the model API tab.
reference_image_urls with reference_portrait_kinds per slot:virtual (portrait library — real or AI; real is equivalent), skip (background/scene — default when omitted). Single-frame and first/last-frame models use first_frame_url / last_frame_url (ingested by default); set first_frame_portrait_kind to skip to keep a direct URL.Seedance 2 参照メディア制限
参照画像
- 形式
- JPEG, PNG, WEBP, BMP, TIFF, GIF
- 幅 / 高さ
- 300-6000 px
- アスペクト比
- 0.4-2.5
- ファイルサイズ
- < 30 MB
参照動画
- 形式
- MP4, MOV
- 解像度
- 480p, 720p
- ファイルごとの長さ
- 2-15 s
- 数 / 合計時間
- 最大 3 個 / 合計 15 秒以内
- 幅 / 高さ
- 300-6000 px
- 総ピクセル数
- 409600-927408
- アスペクト比
- 0.4-2.5
- ファイルサイズ
- <= 50 MB
- フレームレート
- 24-60 FPS
参照音声
- 形式
- WAV, MP3
- ファイルごとの長さ
- 2-15 s
- 数 / 合計時間
- 最大 3 個 / 合計 15 秒以内
- ファイルサイズ
- <= 15 MB
- サンプルレート / チャンネル
- 未公開
- 音声コーデック
- 未公開
出力動画
- resolution
- 480p, 720p, 1080p, 4k
- aspect_ratio
- 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
- 正確なピクセル寸法
- 未公開。固定の幅と高さは保証されません
認証
/api-keys で API キーを作成し、Bearer トークンとして送信します。ログイン中のブラウザからのリクエストはセッション cookie 経由でも動作します。
Authorization: Bearer <YOUR_API_KEY>タスクの作成
POST https://97ai.97claude.com/api/generateボディ:{ "model": "<slug>", "input": { … } }
レスポンス:{ "taskId": "<id>", "state": "waiting" }
結果の照会
GET https://97ai.97claude.com/api/generate/<taskId>レスポンス:{ "taskId", "state": "waiting" | "success" | "fail", "resultUrls": [ … ], "creditsConsumed", "failMsg", "balance" }
state が success または fail になるまでこのエンドポイントをポーリングしてください。失敗したタスクは課金されません。エンドポイント
| モデル | タスク | model slug |
|---|---|---|
| Seedance 2.5 | Text to Video | seedance-2.5-text-to-video |
| Seedance 2.5 Text to Video | Text to Video | seedance-2.5-text-to-video-480p |
| Seedance 2.5 Image to Video | Image to Video | seedance-2.5-image-to-video |
| Seedance 2.5 Image to Video | Image to Video | seedance-2.5-image-to-video-480p |
| Seedance 2.5 First & Last Frame | Image to Video | seedance-2.5-first-last-frame |
| Seedance 2.5 First & Last Frame | Image to Video | seedance-2.5-first-last-frame-480p |
| Seedance 2.5 Omni Reference | Image to Video | seedance-2.5-omni-reference |
| Seedance 2.5 Omni Reference | Image to Video | seedance-2.5-omni-reference-480p |
| Seedance 2.5 Spicy Text to Video | Text to Video | seedance-2.5-spicy-text-to-video |
| Seedance 2.5 Spicy Image to Video | Image to Video | seedance-2.5-spicy-image-to-video |
Seedance 2.5 · Text to Video
seedance-2.5-text-to-videofirst_frame_urlstring任意First-frame image URL or asset://{assetId}. Mutually exclusive with reference_* fields.
last_frame_urlstring任意Last-frame image URL or asset://{assetId}. Requires first_frame_url.
first_frame_portrait_kindenum<string>任意Portrait-library route: ingest hint for first_frame_url. Default skip (direct URL). Use virtual/real to upload portraits to the asset library.
last_frame_portrait_kindenum<string>任意Portrait-library route: ingest hint for last_frame_url. Default skip (direct URL). Use virtual/real to upload portraits to the asset library.
promptstring必須Text prompt describing the video to generate (max 30000 characters).
reference_image_urlsarray<string>任意Reference image URLs (max 30). Mutually exclusive with first/last frame fields.
reference_video_urlsarray<string>任意Reference video URLs (max 10; total duration ≤30s).
reference_audio_urlsarray<string>任意Reference audio URLs (max 10; total duration ≤30s).
generate_audioboolean任意Generate synchronized audio with the video.
return_last_frameboolean任意Return the generated video's last frame. Cannot be true when draft=true.
resolutionenum<string>任意Output video resolution.
aspect_ratioenum<string>任意Output aspect ratio.
durationinteger任意Video duration from 4 to 30 seconds, or -1 for automatic selection.
output_formatenum<string>任意Video output format.
web_searchboolean任意Enable online search for the generation.
nsfw_checkerboolean任意Enable content safety checking.
curl -X POST https://97ai.97claude.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-text-to-video",
"input": {
"aspect_ratio": "16:9",
"duration": 5,
"generate_audio": true,
"output_format": "mp4",
"resolution": "720p",
"return_last_frame": false,
"web_search": false,
"prompt": "在房间里跳舞"
}
}'Seedance 2.5 Text to Video · Text to Video
seedance-2.5-text-to-videofirst_frame_urlstring任意First-frame image URL or asset://{assetId}. Mutually exclusive with reference_* fields.
last_frame_urlstring任意Last-frame image URL or asset://{assetId}. Requires first_frame_url.
first_frame_portrait_kindenum<string>任意Portrait-library route: ingest hint for first_frame_url. Default skip (direct URL). Use virtual/real to upload portraits to the asset library.
last_frame_portrait_kindenum<string>任意Portrait-library route: ingest hint for last_frame_url. Default skip (direct URL). Use virtual/real to upload portraits to the asset library.
promptstring必須Text prompt describing the video to generate (max 30000 characters).
reference_image_urlsarray<string>任意Reference image URLs (max 30). Mutually exclusive with first/last frame fields.
reference_video_urlsarray<string>任意Reference video URLs (max 10; total duration ≤30s).
reference_audio_urlsarray<string>任意Reference audio URLs (max 10; total duration ≤30s).
generate_audioboolean任意Generate synchronized audio with the video.
return_last_frameboolean任意Return the generated video's last frame. Cannot be true when draft=true.
resolutionenum<string>任意Output video resolution.
aspect_ratioenum<string>任意Output aspect ratio.
durationinteger任意Video duration from 4 to 30 seconds, or -1 for automatic selection.
output_formatenum<string>任意Video output format.
web_searchboolean任意Enable online search for the generation.
nsfw_checkerboolean任意Enable content safety checking.
curl -X POST https://97ai.97claude.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-text-to-video",
"input": {
"aspect_ratio": "16:9",
"duration": 5,
"generate_audio": true,
"output_format": "mp4",
"resolution": "480p",
"return_last_frame": false,
"web_search": false,
"prompt": "在房间里跳舞"
}
}'Seedance 2.5 Image to Video · Image to Video
seedance-2.5-image-to-videofirst_frame_urlstring必須URL of the input image to animate, or asset://{assetId} after portrait ingest.
first_frame_portrait_kindenum<string>任意Portrait-library route: ingest hint for first_frame_url. Default skip (direct URL). Use virtual/real to upload portraits to the asset library.
promptstring必須Text prompt describing the video motion and style.
generate_audioboolean任意Generate synchronized audio with the video.
return_last_frameboolean任意Return the generated video's last frame. Cannot be true when draft=true.
resolutionenum<string>任意Output video resolution.
aspect_ratioenum<string>任意Must be adaptive — the direct route follows the input image aspect ratio for keyframe-driven tasks.
durationinteger任意Video duration from 4 to 30 seconds, or -1 for automatic selection.
output_formatenum<string>任意Video output format.
web_searchboolean任意Enable online search for the generation.
nsfw_checkerboolean任意Enable content safety checking.
curl -X POST https://97ai.97claude.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-image-to-video",
"input": {
"aspect_ratio": "adaptive",
"duration": 5,
"generate_audio": true,
"output_format": "mp4",
"resolution": "720p",
"return_last_frame": false,
"web_search": false,
"prompt": "在房间里跳舞",
"first_frame_url": "https://frw-images.aiaipic.win/users/3514640099037941760/ai_generated/20260818/038f9f68-004f-4017-a09d-74b3da84e569.png",
"first_frame_portrait_kind": "virtual"
}
}'Seedance 2.5 Image to Video · Image to Video
seedance-2.5-image-to-video-480pfirst_frame_urlstring必須URL of the input image to animate, or asset://{assetId} after portrait ingest.
first_frame_portrait_kindenum<string>任意Portrait-library route: ingest hint for first_frame_url. Default skip (direct URL). Use virtual/real to upload portraits to the asset library.
promptstring必須Text prompt describing the video motion and style.
generate_audioboolean任意Generate synchronized audio with the video.
return_last_frameboolean任意Return the generated video's last frame. Cannot be true when draft=true.
resolutionenum<string>任意Output video resolution.
aspect_ratioenum<string>任意Must be adaptive — the direct route follows the input image aspect ratio for keyframe-driven tasks.
durationinteger任意Video duration from 4 to 30 seconds, or -1 for automatic selection.
output_formatenum<string>任意Video output format.
web_searchboolean任意Enable online search for the generation.
nsfw_checkerboolean任意Enable content safety checking.
curl -X POST https://97ai.97claude.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-image-to-video-480p",
"input": {
"aspect_ratio": "adaptive",
"duration": 5,
"generate_audio": true,
"output_format": "mp4",
"resolution": "480p",
"return_last_frame": false,
"web_search": false,
"prompt": "在房间里跳舞",
"first_frame_url": "https://frw-images.aiaipic.win/users/3514640099037941760/ai_generated/20260818/038f9f68-004f-4017-a09d-74b3da84e569.png",
"first_frame_portrait_kind": "virtual"
}
}'Seedance 2.5 First & Last Frame · Image to Video
seedance-2.5-first-last-framefirst_frame_urlstring必須First-frame image URL or asset://{assetId}. Mutually exclusive with reference_* fields.
last_frame_urlstring必須Last-frame image URL or asset://{assetId}. Requires first_frame_url.
first_frame_portrait_kindenum<string>任意Portrait-library route: ingest hint for first_frame_url. Default skip (direct URL). Use virtual/real to upload portraits to the asset library.
last_frame_portrait_kindenum<string>任意Portrait-library route: ingest hint for last_frame_url. Default skip (direct URL). Use virtual/real to upload portraits to the asset library.
promptstring必須Text prompt describing the transition and motion.
generate_audioboolean任意Generate synchronized audio with the video.
return_last_frameboolean任意Return the generated video's last frame. Cannot be true when draft=true.
resolutionenum<string>任意Output video resolution.
aspect_ratioenum<string>任意Must be adaptive — the direct route follows the input image aspect ratio for keyframe-driven tasks.
durationinteger任意Video duration from 4 to 30 seconds, or -1 for automatic selection.
output_formatenum<string>任意Video output format.
web_searchboolean任意Enable online search for the generation.
nsfw_checkerboolean任意Enable content safety checking.
curl -X POST https://97ai.97claude.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-first-last-frame",
"input": {
"aspect_ratio": "adaptive",
"duration": 5,
"generate_audio": true,
"output_format": "mp4",
"resolution": "720p",
"return_last_frame": false,
"web_search": false,
"prompt": "在房间里跳舞",
"first_frame_url": "https://frw-images.aiaipic.win/users/3514640099037941760/ai_generated/20260818/038f9f68-004f-4017-a09d-74b3da84e569.png",
"first_frame_portrait_kind": "virtual",
"last_frame_url": "https://frw-images.aiaipic.win/users/3514640099037941760/image/20260819/fb280368-8f54-41eb-aacf-cee1c189b29b.png",
"last_frame_portrait_kind": "skip"
}
}'Seedance 2.5 First & Last Frame · Image to Video
seedance-2.5-first-last-frame-480pfirst_frame_urlstring必須First-frame image URL or asset://{assetId}. Mutually exclusive with reference_* fields.
last_frame_urlstring必須Last-frame image URL or asset://{assetId}. Requires first_frame_url.
first_frame_portrait_kindenum<string>任意Portrait-library route: ingest hint for first_frame_url. Default skip (direct URL). Use virtual/real to upload portraits to the asset library.
last_frame_portrait_kindenum<string>任意Portrait-library route: ingest hint for last_frame_url. Default skip (direct URL). Use virtual/real to upload portraits to the asset library.
promptstring必須Text prompt describing the transition and motion.
generate_audioboolean任意Generate synchronized audio with the video.
return_last_frameboolean任意Return the generated video's last frame. Cannot be true when draft=true.
resolutionenum<string>任意Output video resolution.
aspect_ratioenum<string>任意Must be adaptive — the direct route follows the input image aspect ratio for keyframe-driven tasks.
durationinteger任意Video duration from 4 to 30 seconds, or -1 for automatic selection.
output_formatenum<string>任意Video output format.
web_searchboolean任意Enable online search for the generation.
nsfw_checkerboolean任意Enable content safety checking.
curl -X POST https://97ai.97claude.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-first-last-frame-480p",
"input": {
"aspect_ratio": "adaptive",
"duration": 5,
"generate_audio": true,
"output_format": "mp4",
"resolution": "480p",
"return_last_frame": false,
"web_search": false,
"prompt": "在房间里跳舞",
"first_frame_url": "https://frw-images.aiaipic.win/users/3514640099037941760/ai_generated/20260818/038f9f68-004f-4017-a09d-74b3da84e569.png",
"first_frame_portrait_kind": "virtual",
"last_frame_url": "https://frw-images.aiaipic.win/users/3514640099037941760/image/20260819/fb280368-8f54-41eb-aacf-cee1c189b29b.png",
"last_frame_portrait_kind": "skip"
}
}'Seedance 2.5 Omni Reference · Image to Video
seedance-2.5-omni-referencepromptstring必須Prompt describing the target video, style, dynamics, and atmosphere.
reference_image_urlsarray<string>任意Reference image URLs (max 30). Scene/background images stay as URLs unless marked for portrait ingest.
reference_portrait_kindsarray<string>任意Per-image ingest hint aligned with reference_image_urls: virtual (portrait library — AI or real person), real (optional alias, same as virtual), skip (direct URL; default when omitted).
reference_imagesarray<object>任意Structured reference images: [{ url, portrait: "virtual"|"real"|"skip" }]. Alternative to reference_image_urls + reference_portrait_kinds.
virtual_portraitsarray<string>任意Portrait URLs always uploaded to the virtual portrait library before generation.
real_portraitsarray<string>任意Portrait URLs (including real-person photos) uploaded to the virtual portrait library before generation.
reference_video_urlsarray<string>任意Reference video URLs (max 10; total duration ≤30s). Never uploaded to the asset library.
reference_audio_urlsarray<string>任意Reference audio URLs (max 10; total duration ≤30s). Never uploaded to the asset library.
generate_audioboolean任意Generate synchronized audio with the video.
return_last_frameboolean任意Return the generated video's last frame. Cannot be true when draft=true.
resolutionenum<string>任意Output video resolution.
aspect_ratioenum<string>任意Output aspect ratio.
durationinteger任意Video duration from 4 to 30 seconds, or -1 for automatic selection.
output_formatenum<string>任意Video output format.
web_searchboolean任意Enable online search for the generation.
nsfw_checkerboolean任意Enable content safety checking.
curl -X POST https://97ai.97claude.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-omni-reference",
"input": {
"aspect_ratio": "16:9",
"duration": 5,
"generate_audio": true,
"output_format": "mp4",
"resolution": "720p",
"return_last_frame": false,
"web_search": false,
"prompt": " @image1与 @image2在 @image3的场景中,参考 @video1的运镜,背景音乐参考 @audio1",
"reference_image_urls": [
"https://frw-images.aiaipic.win/users/3514640099037941760/ai_generated/20260818/038f9f68-004f-4017-a09d-74b3da84e569.png",
"https://frw-images.aiaipic.win/users/3514640099037941760/ai_generated/20260818/038f9f68-004f-4017-a09d-74b3da84e569.png",
"https://frw-images.aiaipic.win/users/3514640099037941760/image/20260819/fb280368-8f54-41eb-aacf-cee1c189b29b.png"
],
"reference_portrait_kinds": [
"virtual",
"virtual",
"skip"
],
"reference_video_urls": [
"https://frw-images.aiaipic.win/users/3492453287637028864/video/20260818/3524765235086888960.mp4"
],
"reference_audio_urls": [
"https://frw-images.aiaipic.win/users/3492453287637028864/audio/20260818/3524725649950380032.mp3"
]
}
}'Seedance 2.5 Omni Reference · Image to Video
seedance-2.5-omni-reference-480ppromptstring必須Prompt describing the target video, style, dynamics, and atmosphere.
reference_image_urlsarray<string>任意Reference image URLs (max 30). Scene/background images stay as URLs unless marked for portrait ingest.
reference_portrait_kindsarray<string>任意Per-image ingest hint aligned with reference_image_urls: virtual (portrait library — AI or real person), real (optional alias, same as virtual), skip (direct URL; default when omitted).
reference_imagesarray<object>任意Structured reference images: [{ url, portrait: "virtual"|"real"|"skip" }]. Alternative to reference_image_urls + reference_portrait_kinds.
virtual_portraitsarray<string>任意Portrait URLs always uploaded to the virtual portrait library before generation.
real_portraitsarray<string>任意Portrait URLs (including real-person photos) uploaded to the virtual portrait library before generation.
reference_video_urlsarray<string>任意Reference video URLs (max 10; total duration ≤30s). Never uploaded to the asset library.
reference_audio_urlsarray<string>任意Reference audio URLs (max 10; total duration ≤30s). Never uploaded to the asset library.
generate_audioboolean任意Generate synchronized audio with the video.
return_last_frameboolean任意Return the generated video's last frame. Cannot be true when draft=true.
resolutionenum<string>任意Output video resolution.
aspect_ratioenum<string>任意Output aspect ratio.
durationinteger任意Video duration from 4 to 30 seconds, or -1 for automatic selection.
output_formatenum<string>任意Video output format.
web_searchboolean任意Enable online search for the generation.
nsfw_checkerboolean任意Enable content safety checking.
curl -X POST https://97ai.97claude.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-omni-reference-480p",
"input": {
"aspect_ratio": "16:9",
"duration": 5,
"generate_audio": true,
"output_format": "mp4",
"resolution": "480p",
"return_last_frame": false,
"web_search": false,
"prompt": " @image1与 @image2在 @image3的场景中,参考 @video1的运镜,背景音乐参考 @audio1",
"reference_image_urls": [
"https://frw-images.aiaipic.win/users/3514640099037941760/ai_generated/20260818/038f9f68-004f-4017-a09d-74b3da84e569.png",
"https://frw-images.aiaipic.win/users/3514640099037941760/ai_generated/20260818/038f9f68-004f-4017-a09d-74b3da84e569.png",
"https://frw-images.aiaipic.win/users/3514640099037941760/image/20260819/fb280368-8f54-41eb-aacf-cee1c189b29b.png"
],
"reference_portrait_kinds": [
"virtual",
"virtual",
"skip"
],
"reference_video_urls": [
"https://frw-images.aiaipic.win/users/3492453287637028864/video/20260818/3524765235086888960.mp4"
],
"reference_audio_urls": [
"https://frw-images.aiaipic.win/users/3492453287637028864/audio/20260818/3524725649950380032.mp3"
]
}
}'Seedance 2.5 Spicy Text to Video · Text to Video
seedance-2.5-spicy-text-to-videopromptstring必須Text prompt describing the video motion and style. Spicy mode favors bolder, higher-contrast results.
durationinteger任意Video length in seconds (4-16).
resolutionenum<string>任意Output video resolution.
aspect_ratioenum<string>任意Output video aspect ratio.
camera_fixedboolean任意Whether to keep the camera fixed.
generate_audioboolean任意Whether to generate synchronized audio.
curl -X POST https://97ai.97claude.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-spicy-text-to-video",
"input": {
"aspect_ratio": "16:9",
"duration": 5,
"generate_audio": true,
"output_format": "mp4",
"resolution": "720p",
"return_last_frame": false,
"web_search": false,
"prompt": "在房间里跳舞"
}
}'Seedance 2.5 Spicy Image to Video · Image to Video
seedance-2.5-spicy-image-to-videopromptstring必須Text prompt describing the video motion and style. Spicy mode favors bolder, higher-contrast results.
image_urlstring必須URL of the input image to animate.
last_imagestring任意Optional closing image. Together with image_url, this selects strict first/last-frame keyframe generation.
durationinteger任意Normal mode: 4-16 seconds. Two-image keyframe mode: 4-30 seconds.
resolutionenum<string>任意Normal mode supports its listed tiers. Two-image keyframe mode supports 480p, 720p, or 1080p.
aspect_ratioenum<string>任意Normal mode uses a selected ratio. Two-image keyframe mode requires adaptive and follows the opening image ratio.
camera_fixedboolean任意Whether to keep the camera fixed.
generate_audioboolean任意Whether to generate synchronized audio.
watermarkboolean任意For two-image keyframe mode, add an AI-generated watermark to the output.
curl -X POST https://97ai.97claude.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-spicy-image-to-video",
"input": {
"aspect_ratio": "adaptive",
"duration": 5,
"generate_audio": true,
"output_format": "mp4",
"resolution": "720p",
"return_last_frame": false,
"web_search": false,
"prompt": "在房间里跳舞",
"image_url": "https://frw-images.aiaipic.win/users/3514640099037941760/ai_generated/20260818/038f9f68-004f-4017-a09d-74b3da84e569.png",
"first_frame_portrait_kind": "virtual"
}
}'