PopNowAPI
Odbierz klucz API

Seedance 2.0 Plus API

od ByteDance

Seedance 2.0: wideo z obrazu do 4K z dźwiękiem

bytedance/seedance-2.0-plus/image-to-video
  • Do 4K
  • Klipy 4–15 s
  • Z dźwiękiem
  • Pierwsza i ostatnia klatka
  • Proporcje obrazu: 6
  • Obraz w wideo
  • Wydłuż wideo

Wywołujesz go nazwą modelu bytedance/seedance-2.0-plus/image-to-video w POST /jobs/createTask, od 0,57 USD.

Nazwa modelubytedance/seedance-2.0-plus/image-to-video
EndpointPOST https://api.popnow.ai/api/v1/jobs/createTask
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
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: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "bytedance/seedance-2.0-plus/image-to-video",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "aspect_ratio": "adaptive",
    "resolution": "720p",
    "duration_seconds": 5,
    "generate_audio": true
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

input jest zbudowany ze schematu poniżej, więc przechodzi walidację bez zmian. Zamień prompt i linki na własne.

Cena

OpcjaUSD za sekundę
resolution 480p0,114 USD
resolution 720p0,228 USD
resolution 1080p0,57 USD
resolution 4K1,14 USD

Rozliczenie w USD · Wszystkie opcje i ceny: GET /models/bytedance/seedance-2.0-plus/image-to-video

Limity

Długość klipu
4–15 s
Rozdzielczości
480p · 720p · 1080p · 4K
Proporcje obrazu
16:9 · 9:16 · 4:3 · 3:4 · 1:1 · 21:9 · adaptive
Długość promptu (znaki)
5,000

Parametry

Te pola pochodzą z tego samego schematu, którym sprawdzamy każde żądanie. Pola spoza listy są odrzucane.

  • image_urlstringWymagane

    Obraz, od którego zaczynasz.

    Zakres
    image/jpeg, image/png, image/webp, image/gif
  • promptstringOpcjonalne

    Describe the scene, action, camera movement, and mood for the video.

    Zakres
    0 – 5000 chars
  • last_image_urlstringOpcjonalne

    Opcjonalna ostatnia klatka, żeby klip skończył się dokładnie tam, gdzie chcesz.

    Zakres
    image/jpeg, image/png, image/webp, image/gif
  • aspect_ratiostringOpcjonalne

    Kształt kadru: szeroki, kwadratowy albo pionowy.

    Domyślnie
    "adaptive"
    Dozwolone wartości
    "16:9""9:16""4:3""3:4""1:1""21:9""adaptive"
  • resolutionstringOpcjonalneZmienia cenę

    Rozmiar wyniku. Większy jest ostrzejszy i droższy.

    Domyślnie
    "720p"
    Dozwolone wartości
    "480p""720p""1080p""4k"
  • duration_secondsintegerOpcjonalneZmienia cenę

    Długość klipu. Płacisz za każdą sekundę.

    Domyślnie
    5
    Zakres
    4 – 15
  • generate_audiobooleanOpcjonalneZmienia cenę

    Dodaje dźwięk pasujący do obrazu: głosy, tło i efekty.

    Domyślnie
    true
  • seedintegerOpcjonalne

    Ta sama liczba daje powtarzalny wynik.

    Zakres
    0 – 2147483647
Surowy JSON Schema
{
  "additionalProperties": false,
  "properties": {
    "aspect_ratio": {
      "default": "adaptive",
      "description": "The aspect ratio of the generated video. Use adaptive to follow the input image.",
      "enum": [
        "16:9",
        "9:16",
        "4:3",
        "3:4",
        "1:1",
        "21:9",
        "adaptive"
      ],
      "type": "string"
    },
    "duration_seconds": {
      "default": 5,
      "description": "The duration of the generated video in seconds (4-15s).",
      "maximum": 15,
      "minimum": 4,
      "type": "integer"
    },
    "generate_audio": {
      "default": true,
      "description": "Whether to generate native audio synchronized with the output video. Defaults to true.",
      "type": "boolean"
    },
    "image_url": {
      "contentMediaType": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif"
      ],
      "description": "Start image URL to guide the video generation.",
      "type": "string"
    },
    "last_image_url": {
      "contentMediaType": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif"
      ],
      "description": "Last frame image URL for video continuation.",
      "type": "string"
    },
    "prompt": {
      "description": "Describe the scene, action, camera movement, and mood for the video.",
      "maxLength": 5000,
      "type": "string"
    },
    "resolution": {
      "default": "720p",
      "description": "The output video resolution.",
      "enum": [
        "480p",
        "720p",
        "1080p",
        "4k"
      ],
      "type": "string"
    },
    "seed": {
      "description": "Random seed. Omit to let the model pick one.",
      "maximum": 2147483647,
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "image_url"
  ],
  "type": "object"
}

Odpowiedzi, odpytywanie i callbacki

Wszystkie modele działają tak samo: utwórz zadanie, a potem odpytuj je albo poczekaj na callback.

Najpierw cena

cURL
curl -X POST https://api.popnow.ai/api/v1/jobs/quote \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedance-2.0-plus/image-to-video",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "aspect_ratio": "adaptive",
    "resolution": "720p",
    "duration_seconds": 5,
    "generate_audio": true
  }
}'

Przed uruchomieniem wyślij tę samą treść żądania do POST /jobs/quote, aby zobaczyć szacowaną i maksymalną opłatę w USD. Wycena nie uruchamia zadania ani nie obciąża salda.

Przyjęte

HTTP
HTTP/1.1 202 Accepted

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued"
  },
  "request_id": "req_example_create"
}

HTTP 202 oznacza przyjęcie zadania: maksymalna kwota w USD pozostaje zarezerwowana do rozliczenia. Po przyjęciu zadania rezerwujemy maksymalną kwotę wyceny na saldzie API. Po zakończeniu naliczamy opłatę za rzeczywiste użycie, nie wyższą niż rezerwacja, i zwalniamy resztę. Jeśli zadanie się nie powiedzie, rezerwacja zostaje zwolniona.

Sprawdź status

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

Odpytuj co kilka sekund, stopniowo wydłużając odstęp, i przestań, gdy state ma wartość succeeded, failed, canceled lub expired.

Gotowe zadanie

JSON
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "bytedance/seedance-2.0-plus/image-to-video",
    "state": "succeeded",
    "output": {
      "assets": [
        {
          "url": "https://cdn.popnow.ai/tasks/task_01k3m8x9q2z4v7n5p6r8s0t1w3/output.mp4?signature=FROM_RESPONSE",
          "expiresAt": "2026-10-17T12:20:00Z",
          "mime": "video/mp4",
          "width": 1280,
          "height": 720,
          "durationSeconds": 5
        }
      ]
    },
    "settled": true
  },
  "request_id": "req_example_record"
}

Pobierz plik z url przed expiresAt. Potrzebujesz później nowego linku? Poproś o niego przez POST /common/download-url.

Weryfikacja callbacku

Node.js
import { createHash, createHmac, timingSafeEqual } from "node:crypto";
import express from "express";

const app = express();
// express.raw keeps the exact bytes that were signed; express.json would not match.
app.post("/hooks/popnow", express.raw({ type: "application/json" }), (req, res) => {
  const timestamp = req.header("X-Webhook-Timestamp");
  const signature = req.header("X-Webhook-Signature") ?? "";
  const body = JSON.parse(req.body.toString("utf8"));
  const taskId = body.data?.taskId ?? body.task_id;
  const digest = createHash("sha256").update(req.body).digest("hex");
  const expected = createHmac("sha256", process.env.POPNOW_WEBHOOK_SECRET)
    .update(`${taskId}.${timestamp}.${digest}`)
    .digest("base64");
  const ok = expected.length === signature.length && timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
  // Check the signature first, then reject anything older than five minutes.
  if (!ok || Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return res.status(401).end();
  res.status(200).end(); // answer fast, then fetch the task and store its files
});

Gdy ustawisz callBackUrl, wyślemy ci gotowe zadanie. Zanim mu zaufasz, sprawdź podpis na surowym ciele żądania.

Wysyłanie pliku lokalnego

cURL
curl -X POST https://api.popnow.ai/api/v1/common/upload-url \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contentType": "image/png", "bytes": 482113}'

# PUT the file bytes to data.uploadUrl with every header in data.headers, then commit it:
curl -X POST https://api.popnow.ai/api/v1/files/$FILE_ID/commit \
  -H "Authorization: Bearer $POPNOW_API_KEY"
# The commit returns a popnow://f/... reference. Put it in any image, video or
# audio field of the task input instead of a public https URL.

Publiczne linki https działają bez zmian. Pliki lokalne przechodzą najpierw przez upload-url i commit.

O modelu Seedance 2.0 Plus

Seedance 2.0: wideo z obrazu do 4K z dźwiękiem.

Wywołujesz go nazwą modelu bytedance/seedance-2.0-plus/image-to-video w POST /jobs/createTask, od 0,57 USD.

Parametry żądania

ParametrWymaganyOpis
aspect_ratioNieKształt kadru: szeroki, kwadratowy albo pionowy. 16:9 · 9:16 · 4:3 · 3:4 · 1:1 · 21:9 · adaptive · Domyślnie: adaptive
duration_secondsNieDługość klipu. Płacisz za każdą sekundę. ≥ 4 · ≤ 15 · Domyślnie: 5
generate_audioNieDodaje dźwięk pasujący do obrazu: głosy, tło i efekty. Domyślnie: true
image_urlTakObraz, od którego zaczynasz.
last_image_urlNieOpcjonalna ostatnia klatka, żeby klip skończył się dokładnie tam, gdzie chcesz.
promptNieDescribe the scene, action, camera movement, and mood for the video.
resolutionNieRozmiar wyniku. Większy jest ostrzejszy i droższy. 480p · 720p · 1080p · 4k · Domyślnie: 720p
seedNieTa sama liczba daje powtarzalny wynik. ≥ 0 · ≤ 2147483647

Ceny

Ceny podano w USD. API korzysta z oddzielnego salda w dolarach amerykańskich. Kredytów strony nie można używać w API ani zamieniać na saldo API. Nie można też zamieniać salda API na kredyty strony. Po przyjęciu zadania rezerwujemy maksymalną kwotę wyceny na saldzie API. Po zakończeniu naliczamy opłatę za rzeczywiste użycie, nie wyższą niż rezerwacja, i zwalniamy resztę. Jeśli zadanie się nie powiedzie, rezerwacja zostaje zwolniona.

OpcjaUSD za sekundę
resolution 480p0,114 USD
resolution 720p0,228 USD
resolution 1080p0,57 USD
resolution 4K1,14 USD

Przed uruchomieniem wyślij tę samą treść żądania do POST /jobs/quote, aby zobaczyć szacowaną i maksymalną opłatę w USD. Wycena nie uruchamia zadania ani nie obciąża salda.

Szybki start z API

Wywołaj API Seedance 2.0 Plus w trzech krokach

  1. Utwórz klucz API. Zaloguj się do PopNow i utwórz klucz w konsoli API. Klucze zaczynają się od sk-popnow-. Wywołania korzystają z oddzielnego salda w dolarach amerykańskich.
  2. Wyślij żądanie. Wyślij POST /jobs/createTask z model bytedance/seedance-2.0-plus/image-to-video i obiektem input zgodnym z tabelą parametrów. Odpowiedź od razu zwraca ID zadania.
  3. Odbierz wynik. Odpytuj GET /jobs/recordInfo po ID zadania albo podaj callBackUrl, a wyślemy tam wynik. Gdy zadanie się powiedzie, pobierz pliki z linków wyjściowych.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
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: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "bytedance/seedance-2.0-plus/image-to-video",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "aspect_ratio": "adaptive",
    "resolution": "720p",
    "duration_seconds": 5,
    "generate_audio": true
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Podmień prompt i linki na własne. Odniesienie do odpowiedzi, odpytywania i callbacku znajdziesz na karcie API.

Pytania o API Seedance 2.0 Plus

Ile kosztuje API Seedance 2.0 Plus?

Seedance 2.0 Plus kosztuje od 0,57 USD za klip 5-sekundowy – najtańsze zadanie to „Obraz w wideo”. Ceny według opcji: 480p 0,114 USD za sekundę, 720p 0,228 USD za sekundę, 1080p 0,57 USD za sekundę, 4K 1,14 USD za sekundę. API korzysta z oddzielnego salda w dolarach amerykańskich. Kredytów strony nie można używać w API ani zamieniać na saldo API. Nie można też zamieniać salda API na kredyty strony. Po przyjęciu zadania rezerwujemy maksymalną kwotę wyceny na saldzie API. Po zakończeniu naliczamy opłatę za rzeczywiste użycie, nie wyższą niż rezerwacja, i zwalniamy resztę. Jeśli zadanie się nie powiedzie, rezerwacja zostaje zwolniona.

Jaka jest nazwa modelu Seedance 2.0 Plus w API?

Wpisz bytedance/seedance-2.0-plus/image-to-video do zadania Obraz w wideo; bytedance/seedance-2.0-plus/video-extend do zadania Wydłuż wideo w polu model żądania POST /jobs/createTask.

Jakie limity ma API Seedance 2.0 Plus?

Długość klipu: 4–15 s; Rozdzielczości: 480p · 720p · 1080p · 4K; Proporcje obrazu: 16:9 · 9:16 · 4:3 · 3:4 · 1:1 · 21:9 · adaptive; Długość promptu (znaki): 5,000. Żądania poza tymi limitami są odrzucane, zanim cokolwiek zostanie pobrane.

Więcej o Seedance 2.0 Plus