PopNowAPI
Obtenir une clé API

Seedance 2.0 Plus API

par ByteDance

Seedance 2.0 image vers vidéo jusqu’en 4K avec son

bytedance/seedance-2.0-plus/image-to-video
  • Jusqu’à 4K
  • Clips de 4 à 15 s
  • Son inclus
  • Image de début et de fin
  • 6 formats d’image
  • Image vers vidéo
  • Prolonger une vidéo

Appelez-le avec le nom de modèle bytedance/seedance-2.0-plus/image-to-video sur POST /jobs/createTask, à partir de 0,57 $US.

Nom du modèlebytedance/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"

L’input est construit à partir du schéma ci-dessous : il passe la validation tel quel. Remplacez le prompt et les liens par les vôtres.

Prix

OptionUSD par seconde
resolution 480p0,114 $US
resolution 720p0,228 $US
resolution 1080p0,57 $US
resolution 4K1,14 $US

Facturation en USD · Toutes les options et leur prix : GET /models/bytedance/seedance-2.0-plus/image-to-video

Limites

Durée du clip
4–15 s
Résolutions
480p · 720p · 1080p · 4K
Formats d’image
16:9 · 9:16 · 4:3 · 3:4 · 1:1 · 21:9 · adaptive
Longueur du prompt (caractères)
5,000

Paramètres

Ces champs viennent du schéma avec lequel nous vérifions chaque requête. Les champs qui n’y figurent pas sont refusés.

  • image_urlstringObligatoire

    L’image de départ.

    Plage
    image/jpeg, image/png, image/webp, image/gif
  • promptstringFacultatif

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

    Plage
    0 – 5000 chars
  • last_image_urlstringFacultatif

    Image finale facultative, pour que le clip se termine exactement où vous voulez.

    Plage
    image/jpeg, image/png, image/webp, image/gif
  • aspect_ratiostringFacultatif

    La forme du cadre : large, carrée ou verticale.

    Par défaut
    "adaptive"
    Valeurs acceptées
    "16:9""9:16""4:3""3:4""1:1""21:9""adaptive"
  • resolutionstringFacultatifModifie le prix

    Taille de sortie. Plus c’est grand, plus c’est net et plus c’est cher.

    Par défaut
    "720p"
    Valeurs acceptées
    "480p""720p""1080p""4k"
  • duration_secondsintegerFacultatifModifie le prix

    La durée du clip. Facturée à la seconde.

    Par défaut
    5
    Plage
    4 – 15
  • generate_audiobooleanFacultatifModifie le prix

    Ajoute un son assorti à l’image : voix, ambiance et effets.

    Par défaut
    true
  • seedintegerFacultatif

    Le même nombre donne un résultat reproductible.

    Plage
    0 – 2147483647
Schéma JSON brut
{
  "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"
}

Réponses, interrogation et callbacks

Tous les modèles fonctionnent de la même façon : créez une tâche, puis interrogez-la ou attendez le callback.

Connaître le prix d’abord

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

Avant l’exécution, envoyez le même corps de requête à POST /jobs/quote pour connaître les frais estimés et leur plafond en USD. Le devis ne lance aucune tâche et ne débite pas votre solde.

Acceptée

HTTP
HTTP/1.1 202 Accepted

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

HTTP 202 signifie que la tâche est acceptée : le plafond en USD reste réservé jusqu’au décompte final. À l’acceptation d’une tâche, le montant maximal du devis est réservé sur votre solde API. À la fin, la facturation suit l’usage réel, sans dépasser ce montant, et le reste est libéré. En cas d’échec, le montant réservé est libéré.

Vérifier l’état

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

Interrogez toutes les quelques secondes en espaçant progressivement, et arrêtez dès que state vaut succeeded, failed, canceled ou expired.

Tâche terminée

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

Téléchargez depuis l’url avant expiresAt. Besoin d’un nouveau lien plus tard ? Demandez-le à POST /common/download-url.

Vérifier un callback

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
});

Avec une callBackUrl, nous vous envoyons la tâche terminée. Vérifiez la signature sur le corps brut avant de lui faire confiance.

Envoyer un fichier local

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.

Les liens https publics fonctionnent tels quels. Les fichiers locaux passent d’abord par upload-url et commit.

À propos de Seedance 2.0 Plus

Seedance 2.0 image vers vidéo jusqu’en 4K avec son.

Appelez-le avec le nom de modèle bytedance/seedance-2.0-plus/image-to-video sur POST /jobs/createTask, à partir de 0,57 $US.

Paramètres de requête

ParamètreRequisDescription
aspect_ratioNonLa forme du cadre : large, carrée ou verticale. 16:9 · 9:16 · 4:3 · 3:4 · 1:1 · 21:9 · adaptive · Par défaut: adaptive
duration_secondsNonLa durée du clip. Facturée à la seconde. ≥ 4 · ≤ 15 · Par défaut: 5
generate_audioNonAjoute un son assorti à l’image : voix, ambiance et effets. Par défaut: true
image_urlOuiL’image de départ.
last_image_urlNonImage finale facultative, pour que le clip se termine exactement où vous voulez.
promptNonDescribe the scene, action, camera movement, and mood for the video.
resolutionNonTaille de sortie. Plus c’est grand, plus c’est net et plus c’est cher. 480p · 720p · 1080p · 4k · Par défaut: 720p
seedNonLe même nombre donne un résultat reproductible. ≥ 0 · ≤ 2147483647

Tarifs

Les prix sont en USD. L’API utilise un solde distinct en dollars américains. Les crédits du site ne peuvent pas être utilisés pour l’API ni convertis en solde API, et le solde API ne peut pas être converti en crédits du site. À l’acceptation d’une tâche, le montant maximal du devis est réservé sur votre solde API. À la fin, la facturation suit l’usage réel, sans dépasser ce montant, et le reste est libéré. En cas d’échec, le montant réservé est libéré.

OptionUSD par seconde
resolution 480p0,114 $US
resolution 720p0,228 $US
resolution 1080p0,57 $US
resolution 4K1,14 $US

Avant l’exécution, envoyez le même corps de requête à POST /jobs/quote pour connaître les frais estimés et leur plafond en USD. Le devis ne lance aucune tâche et ne débite pas votre solde.

Démarrage rapide de l'API

Appeler l’API Seedance 2.0 Plus en trois étapes

  1. Créer une clé API. Connectez-vous à PopNow et créez une clé dans la console API. Les clés commencent par sk-popnow-. Les appels API utilisent votre solde distinct en dollars américains.
  2. Envoyer la requête. Envoyez POST /jobs/createTask avec model bytedance/seedance-2.0-plus/image-to-video et un objet input conforme au tableau des paramètres. La réponse renvoie aussitôt un ID de tâche.
  3. Récupérer le résultat. Interrogez GET /jobs/recordInfo avec l’ID de tâche, ou passez une callBackUrl et nous y envoyons le résultat. Téléchargez les liens de sortie quand la tâche réussit.
# 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"

Remplacez le prompt et les liens par les vôtres. L'onglet API contient la référence pour la réponse, le polling et le callback.

Questions sur l’API Seedance 2.0 Plus

Combien coûte l’API Seedance 2.0 Plus ?

Seedance 2.0 Plus coûte à partir de 0,57 $US pour un clip de 5 secondes avec Image vers vidéo, sa tâche la moins chère. Prix par option : 480p 0,114 $US par seconde, 720p 0,228 $US par seconde, 1080p 0,57 $US par seconde, 4K 1,14 $US par seconde. L’API utilise un solde distinct en dollars américains. Les crédits du site ne peuvent pas être utilisés pour l’API ni convertis en solde API, et le solde API ne peut pas être converti en crédits du site. À l’acceptation d’une tâche, le montant maximal du devis est réservé sur votre solde API. À la fin, la facturation suit l’usage réel, sans dépasser ce montant, et le reste est libéré. En cas d’échec, le montant réservé est libéré.

Quel est le nom de modèle de Seedance 2.0 Plus dans l’API ?

Indiquez bytedance/seedance-2.0-plus/image-to-video pour Image vers vidéo; bytedance/seedance-2.0-plus/video-extend pour Prolonger une vidéo dans le champ model de POST /jobs/createTask.

Quelles sont les limites de l’API Seedance 2.0 Plus ?

Durée du clip: 4–15 s; Résolutions: 480p · 720p · 1080p · 4K; Formats d’image: 16:9 · 9:16 · 4:3 · 3:4 · 1:1 · 21:9 · adaptive; Longueur du prompt (caractères): 5,000. Les requêtes hors de ces limites sont refusées avant tout débit.

En savoir plus sur Seedance 2.0 Plus