Seedance 1.0 Lite API: snel endpoint voor videogeneratie

Een enkele POST-aanvraag, 30-60 seconden wachten, en je krijgt een 1080p MP4 terug. Dat is de hele Seedance 1.0 Lite API. Voor ontwikkelaars die geautomatiseerde videoworkflows bouwen, zoals e-commerce productanimaties, advertentiecreatie-pipelines of contentgeneratiesystemen, is dit de integratiegids.

Waarom ontwikkelaars de API integreren

De UI-versie van Seedance 1.0 Lite is prima voor handmatige generatie. De API maakt workflows mogelijk die handmatig gebruik niet ondersteunt:

• Geautomatiseerde catalogusanimatie - start een generatie voor elk nieuw SKU dat aan je e-commercebackend wordt toegevoegd
• Advertentiecreatie-pipelines - genereer varianten op schema en push ze via hun API's naar advertentieplatforms
• Contentgeneratiesystemen - voer CMS-afbeeldingen in bij Arteza en ontvang geanimeerde versies terug
• Realtime workflows voor gebruikersgegenereerde content - laat je eigen gebruikers een afbeelding uploaden en een geanimeerde versie ontvangen
• Batchjobs - verwerk honderden bronafbeeldingen 's nachts

Voor $0,20-$1,00 per aanroep en een doorlooptijd van 30-60 seconden kun je productiewaardige videoautomatisering bouwen die 18 maanden geleden economisch onmogelijk was.

API-toegang verkrijgen

1. Meld je aan op het platform - 10 gratis credits worden direct toegekend
2. Ga naar API-instellingen in je dashboard
3. Genereer een API-sleutel - bewaar deze veilig (nooit committen naar git)
4. Optioneel: kies een maandelijks abonnement via de prijzenpagina - $5, $25, $50 of $120

Je 10 gratis credits werken ook voor API-aanroepen. Je kunt de volledige integratie valideren voordat je iets betaalt.

Het aanvraagmodel

De kerninteractie is één enkele POST naar het generatie-endpoint van Seedance 1.0 Lite.

Verplichte parameters

Optionele parameters

Responsmodel

De API geeft een job-ID en status terug. Generatie is asynchroon: poll op voltooiing of gebruik een webhook.

{
  "job_id": "sd1lite_abc123xyz",
  "status": "processing",
  "credits_charged": 42,
  "estimated_time_seconds": 45,
  "created_at": "2026-04-10T12:00:00Z"
}

Wanneer voltooid:

{
  "job_id": "sd1lite_abc123xyz",
  "status": "completed",
  "video_url": "https://cdn.arteza.ai/...",
  "duration_seconds": 6,
  "resolution": "1080p",
  "credits_charged": 42,
  "completed_at": "2026-04-10T12:00:45Z"
}

Authenticatie

Alle aanvragen gebruiken bearer-tokenauthenticatie via de Authorization-header:

Authorization: Bearer YOUR_API_KEY

API-sleutels zijn gekoppeld aan je account en worden verrekend met je creditsaldo. Roteer sleutels via het dashboard als je vermoedt dat er een lek is.

Codevoorbeeld: Python

Hieronder een minimale Python-integratie die een job indient, op voltooiing pollt en het resultaat downloadt.

import requests
import time
import os

API_KEY = os.environ["SEEDANCE_API_KEY"]
BASE_URL = "https://api.arteza.ai/v1"

def generate_video(image_url, prompt, duration=6, aspect="9:16"):
    # Job indienen
    response = requests.post(
        f"{BASE_URL}/seedance-1-lite/generate",
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={
            "image": image_url,
            "prompt": prompt,
            "duration": duration,
            "resolution": "1080p",
            "aspect_ratio": aspect,
            "camera_lock": True,
        },
    )
    job = response.json()
    job_id = job["job_id"]
    
    # Pollen op voltooiing
    while True:
        status_response = requests.get(
            f"{BASE_URL}/jobs/{job_id}",
            headers={"Authorization": f"Bearer {API_KEY}"},
        )
        status = status_response.json()
        if status["status"] == "completed":
            return status["video_url"]
        if status["status"] == "failed":
            raise Exception(f"Generatie mislukt: {status.get('error')}")
        time.sleep(5)

video_url = generate_video(
    image_url="https://example.com/product.jpg",
    prompt="Product rotates smoothly, highlights catch across the surface, camera completely locked",
    duration=6,
    aspect="1:1",
)
print(f"Video klaar: {video_url}")

Codevoorbeeld: Node.js

const axios = require('axios');

const API_KEY = process.env.SEEDANCE_API_KEY;
const BASE_URL = 'https://api.arteza.ai/v1';

async function generateVideo(imageUrl, prompt, duration = 6, aspect = '9:16') {
  // Job indienen
  const { data: job } = await axios.post(
    `${BASE_URL}/seedance-1-lite/generate`,
    {
      image: imageUrl,
      prompt,
      duration,
      resolution: '1080p',
      aspect_ratio: aspect,
      camera_lock: true,
    },
    {
      headers: { Authorization: `Bearer ${API_KEY}` },
    }
  );

  // Pollen op voltooiing
  while (true) {
    const { data: status } = await axios.get(
      `${BASE_URL}/jobs/${job.job_id}`,
      { headers: { Authorization: `Bearer ${API_KEY}` } }
    );

    if (status.status === 'completed') return status.video_url;
    if (status.status === 'failed') throw new Error(status.error);

    await new Promise((r) => setTimeout(r, 5000));
  }
}

generateVideo(
  'https://example.com/product.jpg',
  'Product rotates smoothly, highlights catch across the surface, camera completely locked',
  6,
  '1:1'
).then((url) => console.log('Video klaar:', url));

Webhookpatroon (aanbevolen voor productie)

Pollen werkt, maar webhooks zijn overzichtelijker op schaal. Geef een webhook_url mee in je generatieverzoek en de API POST de voltooiingspayload wanneer de job klaar is.

response = requests.post(
    f"{BASE_URL}/seedance-1-lite/generate",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "image": image_url,
        "prompt": prompt,
        "duration": 6,
        "webhook_url": "https://your-app.com/webhooks/seedance",
    },
)

Je webhookhandler ontvangt dezelfde voltooiings-JSON als het polling-endpoint. Geen polling-lus nodig.

Wil je dit zelf maken? Probeer Seedance 1.0 Lite gratis →

Klaar om Seedance 1.0 Lite uit te proberen? Begin gratis te maken →

Limieten en gelijktijdigheid

Neem voor hogere gelijktijdigheid of volume contact op met de ondersteuning. Het platform kan batchworkloads van meer dan 10.000 jobs per dag ondersteunen op dedicated setups.

Foutafhandeling

Standaard HTTP-statuscodes zijn van toepassing:

Implementeer voor productie-integraties altijd:

• Exponentiële backoff voor 429- en 500-fouten
• Controle van creditsaldo vóór grote batchruns
• Validatie van webhookhandtekening bij gebruik van webhooks
• Idempotentiesleutels om dubbele kosten bij netwerkfouten te voorkomen

Kostenbeheer in productie

Elke aanroep brengt credits in rekening op basis van duur: 2 credits voor een clip van 2-3 seconden, oplopend tot 7 credits bij 12 seconden.

Tips voor kostenbeheer in productie:

• Test prompts bij 2 seconden voordat je vastlegt aan batchruns van 12 seconden
• Stel een maandelijks creditbudget in en laat je code stoppen wanneer dit is bereikt
• Monitor het veld credits_charged in elke respons om de uitgaven per workflow bij te houden
• Gebruik webhooks om tijd te besparen op pollen
• Cache geslaagde resultaten waar mogelijk, zodat identieke verzoeken niet opnieuw worden gegenereerd

Praktische integratiepatronen

E-commerce catalogusanimatie

Start een Seedance 1.0 Lite-job elke keer dat een nieuw SKU aan je catalogus wordt toegevoegd. Schrijf de resulterende MP4-URL naar je productdatabase. Toon deze automatisch op productdetailpagina's.

Advertentiecreatie-pipeline

Een dagelijkse cron-job genereert 10 nieuwe advertentievarianten van verschillende bronafbeeldingen. MP4's worden rechtstreeks naar de Meta Ads API gepusht als nieuwe creatieven. Zo sluit je de cirkel tussen contentgeneratie en advertentielevering.

Apps voor gebruikersgegenereerde content

Laat gebruikers een foto uploaden in je app. Je backend roept Seedance 1.0 Lite aan met een sjabloonprompt. De geanimeerde versie wordt binnen een minuut aan de gebruiker teruggegeven. Reken gebruikers genoeg aan om de API-kosten van circa $0.20 met een gezonde marge te dekken.

CMS-verrijking

Koppel aan je CMS zodat voor elke nieuwe uitgelichte afbeelding automatisch een geanimeerde Seedance 1.0 Lite-versie wordt gegenereerd. Bewaar beide versies: de statische als fallback en de geanimeerde voor hero-plaatsingen.

Bulk catalogusverversing

Een nachtelijke job genereert opnieuw geanimeerde versies van je top 500 producten met seizoensgebonden bewegingsprompts. Verse creatieven zonder menselijke tussenkomst.

Upgraden naar Pro of 2.0 via API

Wanneer een specifieke job premium kwaliteit vereist, schakel je van endpoint:

• /seedance-1-lite/generate - $0,20-$1,00, snel, de werkezel voor grote volumes
• /seedance-1-pro/generate - $0,20-$1,00, premium beweging, eindframe-controle
• /seedance-2.0/generate - $1.20-$4.40, bioscoopkwaliteit met native audio

Dezelfde API-sleutel, dezelfde creditpool, dezelfde authenticatie. Wissel van model door een ander endpoint aan te roepen. Bekijk de Pro-vergelijkingsgids voor wanneer upgraden zinvol is.

Begin vandaag nog met integreren

Meld je aan, haal je API-sleutel op via het dashboard en maak je eerste aanroep met de 10 gratis credits. Het bovenstaande Python-voorbeeld draait end-to-end in ongeveer 45 seconden en geeft je een werkend integratiepatroon om op voort te bouwen.

Ontvang je API-sleutel gratis → - 10 credits bij aanmelding, geen creditcard vereist, productie-integratie klaar in minder dan een uur.