Riferimento API di Seedance 2.5
Il più recente di ByteDance: clip da 30 secondi con audio nativo
Con una sola chiave API di PopNow chiami Seedance 2.5 dal tuo codice. Qui trovi gli ID del modello da inviare, ogni campo di input accettato, quanti crediti costa ogni richiesta e una richiesta da incollare nel terminale così com’è.
Le descrizioni dei parametri provengono dallo schema di input del modello e sono disponibili solo in inglese.
In sintesi
- Sviluppato da
- ByteDance
- Risultato
- Video
- Da
- 11.07 crediti per secondo generato ($0.1107)
- Tempo tipico
- circa 279 s
1 credito = 0,01 $. All’accettazione l’attività trattiene l’importo massimo possibile e alla fine addebita il consumo reale, arrotondato al credito superiore; il resto viene sbloccato. Le attività non riuscite non vengono addebitate. Per conoscere la cifra esatta prima di eseguire, chiama POST /api/v1/jobs/quote.
Crea video
bytedance/seedance-2.5/text-to-video
Prezzo
| Opzione | Crediti (per secondo generato) | Dollari USA |
|---|---|---|
generate_audio = false, resolution = 480p | 18.51 | $0.1851 |
generate_audio = true, resolution = 480p | 18.51 | $0.1851 |
generate_audio = false, resolution = 720p | 41.6 | $0.416 |
generate_audio = true, resolution = 720p | 41.6 | $0.416 |
generate_audio = false, resolution = 1080p | 102.35 | $1.0235 |
generate_audio = true, resolution = 1080p | 102.35 | $1.0235 |
Parametri
| Campo | Tipo | Predefinito | Valori ammessi | A cosa serve |
|---|---|---|---|---|
promptObbligatorio | string | — | — | What to generate: subject, action, camera movement and mood. |
aspect_ratioFacoltativo | string | adaptive | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptive | Aspect ratio of the generated video. |
resolutionFacoltativo | string | 720p | 480p, 720p, 1080p | Output resolution. Super-resolution tiers are not offered. |
duration_secondsFacoltativo | integer | 5 | 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, … (+13) | Clip length in seconds. This is the billed quantity. |
generate_audioFacoltativo | boolean | true | — | Generate a native soundtrack synchronised to the picture. |
output_formatFacoltativo | string | mp4 | mp4, mov | Container of the returned video. |
enable_web_searchFacoltativo | boolean | false | — | Let the model search the web for information related to the prompt before rendering. |
seedFacoltativo | integer | — | da 0 a 2147483647 | Random seed. Omit to let the model pick one. |
return_last_frameFacoltativo | boolean | false | — | Also return the clip’s final frame as a separate image. |
watermarkFacoltativo | boolean | false | — | Ask the model to watermark the video as AI-generated. |
Richiesta di esempio
Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "bytedance/seedance-2.5/text-to-video",
"input": {
"prompt": "A paper boat drifts down a rain-soaked street at dusk, neon signs reflecting in the water, slow tracking shot at ground level",
"generate_audio": true,
"duration_seconds": 5,
"resolution": "720p"
}
}'La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"Da immagine a video
bytedance/seedance-2.5/image-to-video
Prezzo
| Opzione | Crediti (per secondo generato) | Dollari USA |
|---|---|---|
generate_audio = false, resolution = 480p | 18.51 | $0.1851 |
generate_audio = true, resolution = 480p | 18.51 | $0.1851 |
generate_audio = false, resolution = 720p | 41.6 | $0.416 |
generate_audio = true, resolution = 720p | 41.6 | $0.416 |
generate_audio = false, resolution = 1080p | 102.35 | $1.0235 |
generate_audio = true, resolution = 1080p | 102.35 | $1.0235 |
Parametri
| Campo | Tipo | Predefinito | Valori ammessi | A cosa serve |
|---|---|---|---|---|
image_urlObbligatorio | string | — | — | URL of the image used as the first frame. |
promptFacoltativo | string | — | — | What to generate: subject, action, camera movement and mood. |
last_image_urlFacoltativo | string | — | — | URL of the image used as the closing frame. Only accepted together with image_url. |
aspect_ratioFacoltativo | string | adaptive | adaptive | 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. |
resolutionFacoltativo | string | 720p | 480p, 720p, 1080p | Output resolution. Super-resolution tiers are not offered. |
duration_secondsFacoltativo | integer | 5 | 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, … (+13) | Clip length in seconds. This is the billed quantity. |
generate_audioFacoltativo | boolean | true | — | Generate a native soundtrack synchronised to the picture. |
output_formatFacoltativo | string | mp4 | mp4, mov | Container of the returned video. |
enable_web_searchFacoltativo | boolean | false | — | Let the model search the web for information related to the prompt before rendering. |
seedFacoltativo | integer | — | da 0 a 2147483647 | Random seed. Omit to let the model pick one. |
return_last_frameFacoltativo | boolean | false | — | Also return the clip’s final frame as a separate image. |
watermarkFacoltativo | boolean | false | — | Ask the model to watermark the video as AI-generated. |
Richiesta di esempio
Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.
L’esempio usa file di prova di PopNow in image_url. Sostituiscili con i tuoi link HTTPS pubblici, file caricati o asset salvati.
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "bytedance/seedance-2.5/image-to-video",
"input": {
"prompt": "He lands softly on the rooftop, laughs and turns toward the camera while the balloons sway in the evening breeze; slow push-in",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"generate_audio": true,
"duration_seconds": 5,
"resolution": "720p"
}
}'La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"Da riferimenti a video
bytedance/seedance-2.5/reference-to-video
Prezzo
| Opzione | Crediti (per secondo generato) | Dollari USA |
|---|---|---|
generate_audio = false, resolution = 480p, with_video = true | 11.07 | $0.1107 |
generate_audio = true, resolution = 480p, with_video = true | 11.07 | $0.1107 |
generate_audio = false, resolution = 480p, with_video = false | 18.51 | $0.1851 |
generate_audio = true, resolution = 480p, with_video = false | 18.51 | $0.1851 |
generate_audio = false, resolution = 720p, with_video = true | 24.89 | $0.2489 |
generate_audio = true, resolution = 720p, with_video = true | 24.89 | $0.2489 |
generate_audio = false, resolution = 720p, with_video = false | 41.6 | $0.416 |
generate_audio = true, resolution = 720p, with_video = false | 41.6 | $0.416 |
generate_audio = false, resolution = 1080p, with_video = true | 61.23 | $0.6123 |
generate_audio = true, resolution = 1080p, with_video = true | 61.23 | $0.6123 |
generate_audio = false, resolution = 1080p, with_video = false | 102.35 | $1.0235 |
generate_audio = true, resolution = 1080p, with_video = false | 102.35 | $1.0235 |
Parametri
| Campo | Tipo | Predefinito | Valori ammessi | A cosa serve |
|---|---|---|---|---|
promptObbligatorio | string | — | — | What to generate: subject, action, camera movement and mood. |
reference_image_urlsFacoltativo | array<string> | — | fino a 30 elementi | Reference image URLs that carry over characters, style or scene composition. Up to 30 images. Cannot be combined with a first-frame image. |
reference_video_urlsFacoltativo | array<string> | — | fino a 10 elementi | Reference video URLs that carry over motion and pacing. Up to 10 clips, 2-30 seconds each and 30 seconds in total. Reference footage is added to the billed duration. |
reference_audio_urlsFacoltativo | array<string> | — | fino a 10 elementi | Reference audio URLs the generated soundtrack follows, for beat matching or lip sync. Up to 10 clips, 2-30 seconds each and 30 seconds in total. |
aspect_ratioFacoltativo | string | adaptive | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptive | Aspect ratio of the generated video. |
resolutionFacoltativo | string | 720p | 480p, 720p, 1080p | Output resolution. Super-resolution tiers are not offered. |
duration_secondsFacoltativo | integer | 5 | 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, … (+13) | Clip length in seconds. This is the billed quantity. |
generate_audioFacoltativo | boolean | true | — | Generate a native soundtrack synchronised to the picture. |
output_formatFacoltativo | string | mp4 | mp4, mov | Container of the returned video. |
enable_web_searchFacoltativo | boolean | false | — | Let the model search the web for information related to the prompt before rendering. |
seedFacoltativo | integer | — | da 0 a 2147483647 | Random seed. Omit to let the model pick one. |
return_last_frameFacoltativo | boolean | false | — | Also return the clip’s final frame as a separate image. |
watermarkFacoltativo | boolean | false | — | Ask the model to watermark the video as AI-generated. |
Richiesta di esempio
Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.
L’esempio usa file di prova di PopNow in reference_image_urls. Sostituiscili con i tuoi link HTTPS pubblici, file caricati o asset salvati.
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "bytedance/seedance-2.5/reference-to-video",
"input": {
"prompt": "The man from the reference image jogs across a sunlit rooftop at golden hour and smiles at the camera; smooth tracking shot",
"reference_image_urls": [
"https://media.popnow.ai/influencer/examples/ava.webp"
],
"generate_audio": true,
"duration_seconds": 5,
"resolution": "720p"
}
}'La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"Allunga video
bytedance/seedance-2.5/video-extend
Prezzo
| Opzione | Crediti (per secondo generato) | Dollari USA |
|---|---|---|
generate_audio = false, resolution = 480p, with_video = true | 11.07 | $0.1107 |
generate_audio = true, resolution = 480p, with_video = true | 11.07 | $0.1107 |
generate_audio = false, resolution = 480p, with_video = false | 18.51 | $0.1851 |
generate_audio = true, resolution = 480p, with_video = false | 18.51 | $0.1851 |
generate_audio = false, resolution = 720p, with_video = true | 24.89 | $0.2489 |
generate_audio = true, resolution = 720p, with_video = true | 24.89 | $0.2489 |
generate_audio = false, resolution = 720p, with_video = false | 41.6 | $0.416 |
generate_audio = true, resolution = 720p, with_video = false | 41.6 | $0.416 |
generate_audio = false, resolution = 1080p, with_video = true | 61.23 | $0.6123 |
generate_audio = true, resolution = 1080p, with_video = true | 61.23 | $0.6123 |
generate_audio = false, resolution = 1080p, with_video = false | 102.35 | $1.0235 |
generate_audio = true, resolution = 1080p, with_video = false | 102.35 | $1.0235 |
Parametri
| Campo | Tipo | Predefinito | Valori ammessi | A cosa serve |
|---|---|---|---|---|
promptObbligatorio | string | — | — | Required. Describe what happens next: the action that follows, the camera move and the sound. |
video_urlObbligatorio | string (uri) | — | — | The clip to continue: MP4, MOV or WebM, 2 to 60 seconds. Its last 30 seconds at most become reference footage for the new segment and are billed as reference seconds; anything earlier is only joined back on. |
resolutionFacoltativo | string | 720p | 480p, 720p, 1080p | Size of the new segment. Match your source; it only sets the quality of the new segment. |
duration_secondsFacoltativo | integer | 5 | 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, … (+13) | Length of the new segment in seconds. The reference seconds taken from your clip are billed on top. |
generate_audioFacoltativo | boolean | true | — | Generate sound for the new segment. The sound of your source is kept either way. |
enable_web_searchFacoltativo | boolean | false | — | Let the model search the web for information related to the prompt before rendering. |
seedFacoltativo | integer | — | da 0 a 2147483647 | Random seed. Omit to let the model pick one. |
watermarkFacoltativo | boolean | false | — | Ask the model to watermark the new segment as AI-generated. |
Richiesta di esempio
Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.
L’esempio usa file di prova di PopNow in video_url. Sostituiscili con i tuoi link HTTPS pubblici, file caricati o asset salvati.
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "bytedance/seedance-2.5/video-extend",
"input": {
"prompt": "The flowers keep opening while the camera slowly pulls back to reveal a sunlit meadow",
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
"generate_audio": true,
"duration_seconds": 5,
"resolution": "720p"
}
}'La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"
