Seedance 2.0 Fast API: betaalbaar video-generatie-eindpunt

Één HTTP-verzoek, één bioscoopwaardige AI-videoclip, 1,94 dollar. Dat zijn de eenheidskosten van bouwen op de Seedance 2.0 Fast API. Toegewijde endpoints voor tekst-naar-video en afbeelding-naar-video, deterministische prijzen, dezelfde kwaliteitsengine als Seedance 2.0 standaard, en een kostenvoordeel van ~20% dat telt als je op schaal werkt.

Dit is de volledige ontwikkelaarsgids.

Waarvoor de Fast API bedoeld is

Als je een app, tool of dienst bouwt die video genereert voor gebruikers, zoals een social scheduler, een marketingautomatiseringsplatform, een e-commerce contentengine of een intern creatief hulpmiddel, dan is de Seedance 2.0 Fast API het goedkoopste bioscoopwaardige endpoint waarop je in 2026 kunt bouwen.

Dezelfde beeldkwaliteit als Seedance 2.0 standaard. Lagere kosten per seconde. Hogere rekendoorvoer. Gebouwd voor integratie in workflows die video op grote schaal produceren.

De typische doelgebruiker is een ontwikkelaar of team dat video programmatisch moet genereren op basis van gebruikersinvoer, geen individuele maker die via de UI één clip tegelijk maakt.

De twee endpoints

Tekst-naar-video endpoint:

POST https://arteza.ai/api/v1/bytedance/seedance-2.0/fast/text-to-video

Genereert een video op basis van een tekstprompt. Geen bronafbeelding vereist.

Afbeelding-naar-video endpoint:

POST https://arteza.ai/api/v1/bytedance/seedance-2.0/fast/image-to-video

Genereert een video die start vanuit een geüploade bronafbeelding met een bewegingsprompt.

Beide endpoints accepteren vergelijkbare verzoekbodies en retourneren hetzelfde antwoordformaat. Kies op basis van of je een bronafbeelding hebt om te animeren.

Authenticatie

Elk verzoek heeft een API-sleutel nodig in de Authorization-header. Genereer een sleutel via je Arteza dashboard.

Authorization: Bearer YOUR_API_KEY

Sleutels zijn gekoppeld aan je account en worden afgeschreven van je creditbalans. Roteer ze indien nodig via het dashboard.

Verzoekformaat: tekst naar video

POST /api/v1/bytedance/seedance-2.0/fast/text-to-video
{
  "prompt": "Slow dolly in on a ceramic coffee cup on a wooden cafe table, morning window light, shallow depth of field, cinematic 35mm film look",
  "duration": 5,
  "aspect_ratio": "16:9"
}

Parameters:

• prompt (verplicht, string): De tekstprompt die de gewenste video beschrijft.
• duration (verplicht, integer): Cliplengte in seconden. Bereik: 4-15.
• aspect_ratio (verplicht, string): Één van "16:9", "9:16", "1:1".

Verzoekformaat: afbeelding naar video

POST /api/v1/bytedance/seedance-2.0/fast/image-to-video
{
  "image_url": "https://your-cdn.com/source-image.jpg",
  "prompt": "Slow push in with shallow depth of field, cinematic 35mm film look",
  "duration": 5,
  "aspect_ratio": "16:9"
}

Parameters:

• image_url (verplicht, string): Publiek toegankelijke URL van de bronafbeelding. Ondersteunde formaten: JPG, PNG, WebP.
• prompt (verplicht, string): Bewegingsprompt die beschrijft hoe de afbeelding geanimeerd moet worden.
• duration (verplicht, integer): Cliplengte in seconden. Bereik: 4-15.
• aspect_ratio (verplicht, string): Moet overeenkomen met de beeldverhouding van de bronafbeelding voor het beste resultaat.

Antwoordformaat

Beide endpoints retourneren een asynchroon job-ID:

{
  "job_id": "sdf_2026_abc123xyz",
  "status": "queued",
  "estimated_seconds": 45,
  "cost_credits": 242
}

Poll het statusendpoint totdat de job voltooid is:

GET /api/v1/jobs/sdf_2026_abc123xyz

Een voltooid antwoord:

{
  "job_id": "sdf_2026_abc123xyz",
  "status": "completed",
  "video_url": "https://cdn.arteza.ai/output/sdf_2026_abc123xyz.mp4",
  "duration_seconds": 5,
  "resolution": "720p",
  "credits_consumed": 242
}

Download de video_url en je hebt je MP4.

Volledig Python-voorbeeld

import requests
import time

API_KEY = "your_api_key_here"
BASE_URL = "https://arteza.ai/api/v1"

def generate_fast_video(prompt, duration=5, aspect_ratio="16:9"):
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    }
    
    # Generatiejob indienen
    response = requests.post(
        f"{BASE_URL}/bytedance/seedance-2.0/fast/text-to-video",
        headers=headers,
        json={
            "prompt": prompt,
            "duration": duration,
            "aspect_ratio": aspect_ratio
        }
    )
    job = response.json()
    job_id = job["job_id"]
    print(f"Job in wachtrij: {job_id}, geschat {job['estimated_seconds']}s")
    
    # Poll op voltooiing
    while True:
        time.sleep(10)
        status = requests.get(
            f"{BASE_URL}/jobs/{job_id}",
            headers=headers
        ).json()
        
        if status["status"] == "completed":
            print(f"Voltooid: {status['video_url']}")
            return status["video_url"]
        elif status["status"] == "failed":
            raise Exception(f"Generatie mislukt: {status.get('error')}")
        else:
            print(f"Status: {status['status']}")

# Gebruik
video_url = generate_fast_video(
    "Slow tracking shot of a golden retriever running through autumn leaves, golden hour, cinematic 35mm film look",
    duration=5,
    aspect_ratio="16:9"
)

Volledig JavaScript-voorbeeld

const API_KEY = 'your_api_key_here';
const BASE_URL = 'https://arteza.ai/api/v1';

async function generateFastVideo(prompt, duration = 5, aspectRatio = '16:9') {
  const headers = {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  };

  // Generatiejob indienen
  const submitRes = await fetch(
    `${BASE_URL}/bytedance/seedance-2.0/fast/text-to-video`,
    {
      method: 'POST',
      headers,
      body: JSON.stringify({ prompt, duration, aspect_ratio: aspectRatio })
    }
  );
  const job = await submitRes.json();
  console.log(`Job in wachtrij: ${job.job_id}`);

  // Poll op voltooiing
  while (true) {
    await new Promise(r => setTimeout(r, 10000));
    const statusRes = await fetch(
      `${BASE_URL}/jobs/${job.job_id}`,
      { headers }
    );
    const status = await statusRes.json();

    if (status.status === 'completed') {
      return status.video_url;
    } else if (status.status === 'failed') {
      throw new Error(`Generatie mislukt: ${status.error}`);
    }
  }
}

// Gebruik
const videoUrl = await generateFastVideo(
  'Slow dolly in on a matcha latte in a ceramic cup, morning window light, cinematic 35mm',
  5,
  '9:16'
);

Klaar om op de API te bouwen? Haal je API-sleutel op →

Prijzen per API-aanroep

Elke API-aanroep trekt credits af van je balans op basis van de duur:

Credits vervallen niet. Koop in bulk via de creditniveaus voor betere kosten per aanroep: de Enterprise-laag verlaagt de effectieve kosten met ~17%.

Limieten en doorvoer

De Seedance 2.0 Fast API staat gelijktijdige jobindieningen toe binnen redelijke grenzen. Standaardaccounts kunnen 5-10 jobs parallel indienen zonder throttling te raken. Enterprise-accounts kunnen een hogere gelijktijdigheid aanvragen.

Individuele generatiejobs duren 30-150 seconden afhankelijk van de duur. Met 5 gelijktijdige jobs kun je effectief elke ~15-30 seconden wandkloktijd een clip produceren.

Voor bulkbatchgeneratie (50+ clips) dien je in golven van 5-10 in, wacht op voltooiing en dien daarna de volgende golf in. Overspoel de API niet met honderden gelijktijdige verzoeken.

Foutafhandeling

Veelvoorkomende foutantwoorden:

400 Bad Request: Ongeldige parameters. Controleer het duurbereik, de beeldverhoudingswaarden en de promptlengte.

401 Unauthorized: Ontbrekende of ongeldige API-sleutel.

402 Payment Required: Onvoldoende credits. Laad bij via het dashboard.

429 Too Many Requests: Ratelimiet overschreden. Wacht even en probeer opnieuw.

500 Internal Server Error: Tijdelijk serverprobleem. Probeer opnieuw met exponentiële backoff.

Bouw je integratie zo dat 429 en 500 netjes worden afgehandeld met herhaalpogingen. Een eenvoudige exponentiële backoff (1s, 2s, 4s, 8s) dekt de meeste tijdelijke fouten af.

Fast versus standaard in API-context

De keuze tussen Fast en standaard API-endpoints is grotendeels economisch:

• Gebruik Fast voor programmatische generatie op grote schaal, kostengevoelige apps en alles wat geen hoofdclip is.
• Gebruik standaard voor flagship-inhoud waarbij het kleine kwaliteitsvoordeel de 20% kostenpremie rechtvaardigt.

De meeste apps gebruiken Fast als standaard. Het standaardendpoint is doorgaans gereserveerd voor "premium"-functies of specifieke gebruikersverzoeken.

Endpoint-URL's:

• Fast tekst: bytedance/seedance-2.0/fast/text-to-video
• Fast afbeelding: bytedance/seedance-2.0/fast/image-to-video
• Standaard tekst: bytedance/seedance-2.0/text-to-video
• Standaard afbeelding: bytedance/seedance-2.0/image-to-video

Webhookondersteuning

Voor langlopende jobs is pollen verspilling. De Seedance 2.0 Fast API ondersteunt webhookcallbacks: voeg een webhook_url toe aan je verzoekbody en je ontvangt een POST zodra de job voltooid is:

POST /api/v1/bytedance/seedance-2.0/fast/text-to-video
{
  "prompt": "...",
  "duration": 5,
  "aspect_ratio": "16:9",
  "webhook_url": "https://your-app.com/api/seedance-callback"
}

Je webhookendpoint ontvangt dezelfde JSON-payload als het statusendpoint bij voltooiing zou retourneren. Implementeer idempotentie: webhooks kunnen opnieuw worden geprobeerd bij een fout.

Veelgestelde vragen, korte antwoorden

Wat is het maximale aantal gelijktijdige jobs dat ik kan indienen? Standaardaccounts: 5-10. Enterprise: bespreekbaar.

Worden credits afgeschreven bij mislukte jobs? Nee. Mislukte jobs worden automatisch teruggestort.

Kan ik een lopende job annuleren? Ja, via POST /api/v1/jobs/{job_id}/cancel. Credits worden teruggestort als de annulering vóór voltooiing plaatsvindt.

In welk bestandsformaat is de uitvoer? MP4, H.264-video, AAC-audio, 720p-resolutie.

Hoe lang blijven uitvoer-URL's geldig? CDN-URL's van uitvoer zijn 7 dagen geldig. Download en sla ze op in je eigen systeem voor langdurig gebruik.

Is er een sandbox- of testmodus? Geen speciale sandbox. Gebruik je 10 gratis registratiecredits om te testen. Het Starter-plan van $5 is ook een laagdrempelige manier om te bouwen tegen echte endpoints.

Begin met bouwen op de Seedance 2.0 Fast API

De API is bewust eenvoudig: twee endpoints, deterministische prijzen, asynchroon jobmodel en een kwaliteitsplafond dat overeenkomt met de flagship Seedance 2.0-laag. Bouw erop voor social tools, marketingautomatisering, creatorsplatforms, e-commerce contentengines of interne creatieve apps. De eenheidseconomie maakt videogeneratie eindelijk haalbaar als functie binnen andere producten.

Klaar om te bouwen? Haal je API-sleutel op →

Verder lezen: Volledige gids voor Seedance 2.0 Fast • Prijzen van Seedance 2.0 Fast • Batchcreatie met Seedance 2.0 Fast