Seedance 1.0 Pro API: professioneel eindpunt voor videogeneratie

Als je video integreert in een product, een workflow of een pipeline, wordt de web-UI uiteindelijk een knelpunt. De Seedance 1.0 Pro API is hetzelfde model als achter de UI, beschikbaar als een overzichtelijk REST-eindpunt met bearer-token-authenticatie, voorspelbare prijzen per seconde en eenvoudige job-polling. Deze handleiding behandelt alles wat je nodig hebt om het in productie te zetten.

Wat de API je biedt

Alles wat de Seedance 1.0 Pro web-UI biedt, nu programmatisch beschikbaar:

• Beeld-naar-video-generatie met een bron-afbeeldings-URL
• Motionprompt om de animatie te sturen
• Duurregeling van 2 tot 12 seconden
• Eindframeregeling voor gerichte overgangen
• Camera-lock aan/uit
• Job-polling voor status en resultaat-URL
• MP4-uitvoer in native 1080p

Gebruik het voor SaaS-producten met ingebouwde videogeneratie, interne bureaupipelines, batchproductieworkflows of de automatisering van repetitieve videotaken.

Authenticatie

Alle API-aanroepen authenticeren met een bearer-token. Genereer er een vanuit je Arteza-accountdashboard op arteza.ai.

Authorization: Bearer YOUR_API_KEY

Beveiligingsregels:

• Sla API-sleutels nooit op in versiebeheer
• Roteer sleutels regelmatig
• Gebruik omgevingsvariabelen of een secrets manager
• Beperk sleutels tot specifieke origins waar mogelijk

De kernendpoints

Een generatiejob indienen

POST /v1/seedance-1-pro/generate

Request body:

{
  "source_image_url": "https://your-cdn.com/source.jpg",
  "prompt": "Slow camera push-in on the subject, warm golden hour light, shallow depth of field",
  "duration_seconds": 6,
  "camera_lock": false,
  "end_frame_url": null
}

Parameters:

Respons:

{
  "job_id": "job_abc123xyz",
  "status": "queued",
  "created_at": "2026-04-10T12:00:00Z",
  "estimated_seconds": 90
}

Jobstatus controleren

GET /v1/seedance-1-pro/status/{job_id}

Respons (bezig):

{
  "job_id": "job_abc123xyz",
  "status": "processing",
  "progress": 0.45,
  "created_at": "2026-04-10T12:00:00Z"
}

Respons (voltooid):

{
  "job_id": "job_abc123xyz",
  "status": "completed",
  "video_url": "https://arteza.ai/videos/abc123xyz.mp4",
  "duration_seconds": 6,
  "resolution": "1920x1080",
  "credits_charged": 144
}

Mogelijke statuswaarden: queued, processing, completed, failed

Het resultaat downloaden

Zodra de status completed is, verwijst de video_url naar een 1080p MP4-bestand. Download het onmiddellijk en sla het op in je eigen infrastructuur. Vertrouw er niet op dat de URL voor onbepaalde tijd geldig blijft.

Een compleet Python-voorbeeld

import os
import time
import requests

API_KEY = os.environ["SEEDANCE_API_KEY"]
BASE_URL = "https://api.arteza.ai/v1/seedance-1-pro"
HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

def generate_video(source_image_url, prompt, duration=6, camera_lock=False, end_frame=None):
    payload = {
        "source_image_url": source_image_url,
        "prompt": prompt,
        "duration_seconds": duration,
        "camera_lock": camera_lock,
    }
    if end_frame:
        payload["end_frame_url"] = end_frame
    
    response = requests.post(f"{BASE_URL}/generate", headers=HEADERS, json=payload)
    response.raise_for_status()
    return response.json()["job_id"]

def wait_for_completion(job_id, poll_interval=5, timeout=300):
    start = time.time()
    while time.time() - start < timeout:
        r = requests.get(f"{BASE_URL}/status/{job_id}", headers=HEADERS)
        r.raise_for_status()
        data = r.json()
        
        if data["status"] == "completed":
            return data["video_url"]
        if data["status"] == "failed":
            raise RuntimeError(f"Job mislukt: {data.get('error', 'onbekend')}")
        
        time.sleep(poll_interval)
    
    raise TimeoutError(f"Job {job_id} niet voltooid binnen {timeout}s")

def download_video(url, output_path):
    response = requests.get(url, stream=True)
    response.raise_for_status()
    with open(output_path, "wb") as f:
        for chunk in response.iter_content(chunk_size=8192):
            f.write(chunk)

# Gebruik
job_id = generate_video(
    source_image_url="https://example.com/product.jpg",
    prompt="Slow camera orbit around the product, studio lighting, 6 seconds",
    duration=6,
    camera_lock=True
)

video_url = wait_for_completion(job_id)
download_video(video_url, "output.mp4")
print(f"Video opgeslagen als output.mp4")

Een compleet Node.js-voorbeeld

import fs from 'fs';
import fetch from 'node-fetch';

const API_KEY = process.env.SEEDANCE_API_KEY;
const BASE_URL = 'https://api.arteza.ai/v1/seedance-1-pro';
const HEADERS = {
  'Authorization': `Bearer ${API_KEY}`,
  'Content-Type': 'application/json'
};

async function generateVideo(opts) {
  const response = await fetch(`${BASE_URL}/generate`, {
    method: 'POST',
    headers: HEADERS,
    body: JSON.stringify(opts)
  });
  if (!response.ok) throw new Error(`HTTP ${response.status}`);
  const data = await response.json();
  return data.job_id;
}

async function waitForCompletion(jobId, { pollInterval = 5000, timeout = 300000 } = {}) {
  const start = Date.now();
  while (Date.now() - start < timeout) {
    const r = await fetch(`${BASE_URL}/status/${jobId}`, { headers: HEADERS });
    const data = await r.json();
    if (data.status === 'completed') return data.video_url;
    if (data.status === 'failed') throw new Error(`Job mislukt: ${data.error}`);
    await new Promise(res => setTimeout(res, pollInterval));
  }
  throw new Error('Timeout');
}

async function downloadVideo(url, path) {
  const response = await fetch(url);
  const buffer = await response.buffer();
  fs.writeFileSync(path, buffer);
}

// Gebruik
const jobId = await generateVideo({
  source_image_url: 'https://example.com/product.jpg',
  prompt: 'Slow camera orbit around the product, studio lighting, 6 seconds',
  duration_seconds: 6,
  camera_lock: true
});

const videoUrl = await waitForCompletion(jobId);
await downloadVideo(videoUrl, 'output.mp4');
console.log('output.mp4 opgeslagen');

Wil je uitzendkwaliteit zoals dit? Probeer Seedance 1.0 Pro gratis →

Prijzen en facturering

Tarief: ongeveer $0,12 per seconde uitvoervideo, naar boven afgerond op het dichtstbijzijnde hele credit

Credits worden alleen in rekening gebracht bij succesvolle generaties. Mislukte jobs kosten geen credits.

De abonnementen zijn hetzelfde als bij de web-UI: $5 Starter, $25 Creator, $50 Pro, $120 Studio. Zie de prijzenpagina.

Snelheidslimieten en gelijktijdigheid

Standaardaccounts hebben snelheidslimieten die geschikt zijn voor typische integratiewerklastens. Neem voor grote productievolumes contact op met support voor verhoogde limieten.

Algemene richtlijnen:

• 5-10 gelijktijdige jobs werkt betrouwbaar voor de meeste accounts
• Exponentieel uitstel bij HTTP 429-antwoorden
• Herhaalpogingen op jobniveau bij tijdelijke fouten (maximaal 3 pogingen)
• Webhook-callbacks zijn beschikbaar om overmatig pollen te vermijden

Webhooks (optioneel)

In plaats van te pollen, registreer je een webhook-URL in je accountinstellingen of per aanvraag. Wanneer een job is voltooid, stuurt Arteza een POST naar je URL:

{
  "event": "job.completed",
  "job_id": "job_abc123xyz",
  "status": "completed",
  "video_url": "https://arteza.ai/videos/abc123xyz.mp4",
  "duration_seconds": 6,
  "credits_charged": 144,
  "timestamp": "2026-04-10T12:02:15Z"
}

Webhooks worden ondertekend met een HMAC-handtekening in de X-Seedance-Signature-header. Verifieer deze voordat je de payload vertrouwt.

Foutafhandeling

De API geeft standaard HTTP-statuscodes terug:

Foutrespons-bodies bevatten een error-veld met een leesbare melding en een code-veld voor programmatische verwerking.

{
  "error": "Bronafbeeldings-URL kon niet worden opgehaald",
  "code": "source_image_unreachable"
}

Vereisten voor invoerAfbeeldingen

• Formaten: PNG, JPEG, WebP
• Grootte: maximaal 10 MB per afbeelding
• Resolutie: minimaal 512x512, hoger is beter (1080p of hoger aanbevolen)
• URL-toegang: moet publiek bereikbaar zijn door de Arteza-servers (geen localhost, geen met authenticatie beveiligde URLs)

Gebruik voor privéafbeeldingen een ondertekende S3-URL, CloudFront of vergelijkbaar, en geef de ondertekende URL mee in de aanvraag.

Best practices

1. Sla uitvoer op in je eigen infrastructuur. Vertrouw niet op Arteza-URLs op de lange termijn.
2. Log alles. Job-ID's, prompts, tijdsduren, statusovergangen en fouten.
3. Herhaal bij tijdelijke fouten. Netwerkstoringen en 5xx-antwoorden moeten opnieuw worden geprobeerd met exponentieel uitstel.
4. Valideer invoer vroeg. Controleer afbeeldings-URLs en parameterwaarden voordat je een aanvraag indient.
5. Monitor je creditbalans. Geef een melding wanneer je onder een drempel zakt.
6. Gebruik webhooks in productie. Pollen is prima voor kleine workloads, maar inefficiënt op grote schaal.
7. Cache identieke generaties. Als een gebruiker dezelfde afbeelding en prompt twee keer indient, geef dan de gecachede URL terug.

Testen en staging

Begin elke integratie met het $5 Starter-abonnement (60 credits per maand). Dat is genoeg voor twintig testgeneraties van 2 seconden. Bouw en test je integratie van begin tot eind voordat je overstapt op een abonnement met hoger volume.

Gebruikssituaties

• SaaS-platforms: laat je gebruikers video genereren vanuit hun eigen bestanden
• E-commerce: genereer productbewegingsvideo's vanuit catalogusafbeeldingen
• Vastgoed: automatiseer de productie van listingvideo's vanuit foto's
• Marketingautomatisering: gepersonaliseerde video op grote schaal
• Contentplatforms: verrijk artikelen, listings of sociale berichten met gegenereerde video
• White-label-videotools: bouw je eigen AI-videoproduct op de Arteza-backend

Verder lezen

• Batchverwerkingsworkflows
• Volledige gids voor Seedance 1.0 Pro
• Seedance 1.0 Pro voor bureaus
• Seedance 2.0 API-gids

Veelgestelde vragen

Mag ik de API gebruiken voor commerciële toepassingen? Ja, alle uitvoer is vrijgegeven voor commercieel gebruik.

Wat gebeurt er als de generatie mislukt? Bij mislukte generaties worden geen credits in rekening gebracht.

Hoe lang zijn gegenereerde video's beschikbaar? Video's kunnen gedurende een bepaald tijdvenster na de generatie worden gedownload. Download en sla ze direct op.

Ondersteunen jullie SDK-bibliotheken? Community-SDK's voor Python en Node zijn beschikbaar. Zie de ontwikkelaarsdocumentatie op arteza.ai.

Kan ik een lopende job annuleren? Ja, stuur DELETE /v1/seedance-1-pro/jobs/{job_id}. Credits worden niet in rekening gebracht bij geannuleerde jobs.

Hoe krijg ik ondersteuning? Stuur een e-mail via het supportformulier in je accountdashboard voor API-specifieke vragen.

---

De Seedance 1.0 Pro API is de productie-klare manier om 1080p AI-videogeneratie in je product of pipeline te integreren.

Haal je API-sleutel op en begin met bouwen → met 10 gratis credits inbegrepen bij aanmelding.