Seedance 2.5: dokumentacja API

Jednym kluczem API PopNow wywołasz Seedance 2.5 z własnego kodu. Znajdziesz tu identyfikatory modelu, które trzeba wysłać, każde pole wejściowe, koszt zapytania w kredytach i gotowe zapytanie do wklejenia w terminalu.

Opisy parametrów pochodzą ze schematu wejściowego modelu i są dostępne tylko po angielsku.

W skrócie

Twórca: ByteDance
Wynik: Wideo
Od: 11.07 kr. za sekundę wyniku ($0.1107)
Typowy czas: ok. 279 s
Identyfikatory modelu: bytedance/seedance-2.5/text-to-video
bytedance/seedance-2.5/image-to-video
bytedance/seedance-2.5/reference-to-video
bytedance/seedance-2.5/video-extend

1 kredyt = 0,01 USD. Po przyjęciu zadanie blokuje najwyższą możliwą kwotę, a na koniec rozlicza faktyczne zużycie, zaokrąglone w górę do pełnych kredytów; resztę zwalnia. Za zadania zakończone błędem nie płacisz. Dokładną kwotę przed uruchomieniem poda POST /api/v1/jobs/quote.

Utwórz wideo

bytedance/seedance-2.5/text-to-video

Cena

Opcja	Kredyty (za sekundę wyniku)	Dolary 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

Parametry

Pole	Typ	Domyślnie	Dozwolone wartości	Do czego służy
`prompt`Wymagane	`string`	—	—	What to generate: subject, action, camera movement and mood.
`aspect_ratio`Opcjonalne	`string`	`adaptive`	21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptive	Aspect ratio of the generated video.
`resolution`Opcjonalne	`string`	`720p`	480p, 720p, 1080p	Output resolution. Super-resolution tiers are not offered.
`duration_seconds`Opcjonalne	`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_audio`Opcjonalne	`boolean`	`true`	—	Generate a native soundtrack synchronised to the picture.
`output_format`Opcjonalne	`string`	`mp4`	mp4, mov	Container of the returned video.
`enable_web_search`Opcjonalne	`boolean`	`false`	—	Let the model search the web for information related to the prompt before rendering.
`seed`Opcjonalne	`integer`	—	od 0 do 2147483647	Random seed. Omit to let the model pick one.
`return_last_frame`Opcjonalne	`boolean`	`false`	—	Also return the clip’s final frame as a separate image.
`watermark`Opcjonalne	`boolean`	`false`	—	Ask the model to watermark the video as AI-generated.

Przykładowe zapytanie

To zapytanie działa w obecnej postaci; pominięte pola mają wartości domyślne. Najpierw zapisz klucz w zmiennej POPNOW_API_KEY.

POST /api/v1/jobs/createTask

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"
  }
}'

Odpowiedź od razu zawiera taskId. Wynik pobierzesz przez GET /api/v1/jobs/recordInfo albo dodaj callBackUrl, by dostać powiadomienie.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Obraz w wideo

bytedance/seedance-2.5/image-to-video

Cena

Opcja	Kredyty (za sekundę wyniku)	Dolary 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

Parametry

Pole	Typ	Domyślnie	Dozwolone wartości	Do czego służy
`image_url`Wymagane	`string`	—	—	URL of the image used as the first frame.
`prompt`Opcjonalne	`string`	—	—	What to generate: subject, action, camera movement and mood.
`last_image_url`Opcjonalne	`string`	—	—	URL of the image used as the closing frame. Only accepted together with image_url.
`aspect_ratio`Opcjonalne	`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.
`resolution`Opcjonalne	`string`	`720p`	480p, 720p, 1080p	Output resolution. Super-resolution tiers are not offered.
`duration_seconds`Opcjonalne	`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_audio`Opcjonalne	`boolean`	`true`	—	Generate a native soundtrack synchronised to the picture.
`output_format`Opcjonalne	`string`	`mp4`	mp4, mov	Container of the returned video.
`enable_web_search`Opcjonalne	`boolean`	`false`	—	Let the model search the web for information related to the prompt before rendering.
`seed`Opcjonalne	`integer`	—	od 0 do 2147483647	Random seed. Omit to let the model pick one.
`return_last_frame`Opcjonalne	`boolean`	`false`	—	Also return the clip’s final frame as a separate image.
`watermark`Opcjonalne	`boolean`	`false`	—	Ask the model to watermark the video as AI-generated.

Przykładowe zapytanie

To zapytanie działa w obecnej postaci; pominięte pola mają wartości domyślne. Najpierw zapisz klucz w zmiennej POPNOW_API_KEY.

Przykład używa w image_url przykładowych plików PopNow. Zamień je na własne publiczne linki HTTPS, przesłane pliki albo zapisane zasoby.

POST /api/v1/jobs/createTask

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"
  }
}'

Odpowiedź od razu zawiera taskId. Wynik pobierzesz przez GET /api/v1/jobs/recordInfo albo dodaj callBackUrl, by dostać powiadomienie.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Wideo z referencji

bytedance/seedance-2.5/reference-to-video

Cena

Opcja	Kredyty (za sekundę wyniku)	Dolary 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

Parametry

Pole	Typ	Domyślnie	Dozwolone wartości	Do czego służy
`prompt`Wymagane	`string`	—	—	What to generate: subject, action, camera movement and mood.
`reference_image_urls`Opcjonalne	`array<string>`	—	do 30 elementów	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_urls`Opcjonalne	`array<string>`	—	do 10 elementów	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_urls`Opcjonalne	`array<string>`	—	do 10 elementów	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_ratio`Opcjonalne	`string`	`adaptive`	21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptive	Aspect ratio of the generated video.
`resolution`Opcjonalne	`string`	`720p`	480p, 720p, 1080p	Output resolution. Super-resolution tiers are not offered.
`duration_seconds`Opcjonalne	`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_audio`Opcjonalne	`boolean`	`true`	—	Generate a native soundtrack synchronised to the picture.
`output_format`Opcjonalne	`string`	`mp4`	mp4, mov	Container of the returned video.
`enable_web_search`Opcjonalne	`boolean`	`false`	—	Let the model search the web for information related to the prompt before rendering.
`seed`Opcjonalne	`integer`	—	od 0 do 2147483647	Random seed. Omit to let the model pick one.
`return_last_frame`Opcjonalne	`boolean`	`false`	—	Also return the clip’s final frame as a separate image.
`watermark`Opcjonalne	`boolean`	`false`	—	Ask the model to watermark the video as AI-generated.

Przykładowe zapytanie

To zapytanie działa w obecnej postaci; pominięte pola mają wartości domyślne. Najpierw zapisz klucz w zmiennej POPNOW_API_KEY.

Przykład używa w reference_image_urls przykładowych plików PopNow. Zamień je na własne publiczne linki HTTPS, przesłane pliki albo zapisane zasoby.

POST /api/v1/jobs/createTask

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"
  }
}'

Odpowiedź od razu zawiera taskId. Wynik pobierzesz przez GET /api/v1/jobs/recordInfo albo dodaj callBackUrl, by dostać powiadomienie.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Wydłuż wideo

bytedance/seedance-2.5/video-extend

Cena

Opcja	Kredyty (za sekundę wyniku)	Dolary 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

Parametry

Pole	Typ	Domyślnie	Dozwolone wartości	Do czego służy
`prompt`Wymagane	`string`	—	—	Required. Describe what happens next: the action that follows, the camera move and the sound.
`video_url`Wymagane	`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.
`resolution`Opcjonalne	`string`	`720p`	480p, 720p, 1080p	Size of the new segment. Match your source; it only sets the quality of the new segment.
`duration_seconds`Opcjonalne	`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_audio`Opcjonalne	`boolean`	`true`	—	Generate sound for the new segment. The sound of your source is kept either way.
`enable_web_search`Opcjonalne	`boolean`	`false`	—	Let the model search the web for information related to the prompt before rendering.
`seed`Opcjonalne	`integer`	—	od 0 do 2147483647	Random seed. Omit to let the model pick one.
`watermark`Opcjonalne	`boolean`	`false`	—	Ask the model to watermark the new segment as AI-generated.

Przykładowe zapytanie

To zapytanie działa w obecnej postaci; pominięte pola mają wartości domyślne. Najpierw zapisz klucz w zmiennej POPNOW_API_KEY.

Przykład używa w video_url przykładowych plików PopNow. Zamień je na własne publiczne linki HTTPS, przesłane pliki albo zapisane zasoby.

POST /api/v1/jobs/createTask

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"
  }
}'

Odpowiedź od razu zawiera taskId. Wynik pobierzesz przez GET /api/v1/jobs/recordInfo albo dodaj callBackUrl, by dostać powiadomienie.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Seedance 2.5: dokumentacja API

W skrócie

Utwórz wideo

Cena

Parametry

Przykładowe zapytanie

Obraz w wideo

Cena

Parametry

Przykładowe zapytanie

Wideo z referencji

Cena

Parametry

Przykładowe zapytanie

Wydłuż wideo

Cena

Parametry

Przykładowe zapytanie

Co dalej

Na tej stronie