Seedance 1.0 Lite API: hurtig videogenereringsendpoint

Et enkelt POST-kald, 30-60 sekunders ventetid, og du får en 1080p MP4 tilbage. Det er hele Seedance 1.0 Lite API'et. Til udviklere der bygger automatiserede videoworkflows - hvad enten det er e-commerce produktanimationer, annoncepipelines eller indholdsgenerationssystemer - er dette integrationsguiden.

Hvorfor udviklere integrerer API'et

UI-versionen af Seedance 1.0 Lite er fremragende til manuel generering. API'et åbner for de workflows, som manuel brug ikke kan understøtte:

• Automatiseret kataloganimation - udløs en generering for hvert nyt varenummer der tilføjes til din e-commerce-backend
• Annoncepipelines - generer varianter efter en tidsplan og skub dem til annonceplateformer via deres API'er
• Indholdsgenerationssystemer - send CMS-billeder ind i Arteza og få animerede versioner tilbage
• Realtids brugergenerede workflows - lad dine egne brugere uploade et billede og få en animeret version
• Batchjobs - behandl hundredvis af killebilleder hen over natten

Til $0,20-$1,00 pr. kald og 30-60 sekunders gennemløbstid kan du bygge videoautomatisering i produktionskvalitet, som ville have været økonomisk umulig for 18 måneder siden.

Få adgang til API'et

1. Tilmeld dig på platformen - 10 gratis credits ankommer med det samme
2. Gå til API-indstillinger i dit dashboard
3. Generer en API-nøgle - opbevar den sikkert (commit den aldrig til git)
4. Valgfrit: Vælg en månedlig plan på prissiden - $5, $25, $50 eller $120

Dine 10 gratis credits virker også til API-kald. Du kan validere den fulde integration, inden du betaler noget som helst.

Anmodningsmodellen

Den grundlæggende interaktion er et enkelt POST til Seedance 1.0 Lite-genereringsendpointet.

Påkrævede parametre

Valgfrie parametre

Responsmodel

API'et returnerer et job-ID og en status. Generering er asynkron - poll efter færdiggørelse eller brug en webhook.

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

Når det er færdigt:

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

Godkendelse

Alle forespørgsler bruger bearer token-godkendelse via Authorization-headeren:

Authorization: Bearer YOUR_API_KEY

API-nøgler er knyttet til din konto og trækker fra din creditsaldo. Rotér nøgler via dashboardet, hvis du mistænker en lækage.

Kodeeksempel: Python

Her er en minimal Python-integration der indsender et job, poller efter færdiggørelse og downloader resultatet.

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"):
    # Indsend jobbet
    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"]
    
    # Poll efter færdiggørelse
    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"Generering fejlede: {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 klar: {video_url}")

Kodeeksempel: 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') {
  // Indsend jobbet
  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}` },
    }
  );

  // Poll efter færdiggørelse
  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 klar:', url));

Webhook-mønster (anbefalet til produktion)

Polling virker, men webhooks er mere elegante i stor skala. Send en webhook_url med i din genereringsforespørgsel, og API'et vil POST færdiggørelsespayloaden, når jobbet er afsluttet.

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

Din webhook-handler modtager den samme JSON ved færdiggørelse som polling-endpointet. Ingen polling-løkke nødvendig.

Vil du lave dette selv? Prøv Seedance 1.0 Lite gratis →

Klar til at prøve Seedance 1.0 Lite? Begynd at skabe gratis →

Rategrænser og samtidighed

Kontakt support for højere samtidighed eller volumen. Platformen kan understøtte batcharbejdsbyrder på 10.000+ jobs pr. dag på dedikerede opsætninger.

Fejlhåndtering

Standard HTTP-statuskoder gælder:

Til produktionsintegrationer skal du altid implementere:

• Eksponentiel backoff ved 429- og 500-fejl
• Creditsaldotjek inden store batchkørsler
• Webhook-signaturvalidering hvis du bruger webhooks
• Idempotency-nøgler for at forhindre dobbeltopkrævning ved netværksfejl

Omkostningsstyring i produktion

Hvert kald opkræver credits baseret på varighed: 2 credits for et klip på 2-3 sekunder, stigende til 7 credits ved 12 sekunder.

Tips til omkostningsstyring i produktion:

• Test prompts ved 2 sekunder, inden du forpligter dig til 12-sekunders batchkørsler
• Sæt et månedligt creditbudget og lad din kode stoppe, når det er nået
• Overvåg feltet credits_charged i hvert svar for at spore udgifter pr. workflow
• Brug webhooks for at undgå at spilde tid på polling
• Cach vellykkede resultater når det er muligt, så identiske forespørgsler ikke regenererer

Reelle integrationsmønstre

E-commerce kataloganimation

Udløs et Seedance 1.0 Lite-job, hver gang et nyt varenummer tilføjes til dit katalog. Skriv den resulterende MP4-URL til din produktdatabase. Vis den automatisk på produktdetailsider.

Annoncepipeline

Et dagligt cron-job genererer 10 nye annonceversioner fra forskellige killebilleder. Skubber MP4'er direkte til Meta Ads API som nye kreative materialer. Lukker løkken mellem indholdsgenerering og annoncelevering.

Apps med brugergeneret indhold

Lad brugere uploade et foto i din app. Din backend kalder Seedance 1.0 Lite med en skabelonprompt. Returner den animerede version til brugeren på under et minut. Opkræv brugerne nok til at dække de ~$0.20 i API-omkostninger med en god margin.

CMS-forbedring

Hook ind i dit CMS, så ethvert nyt fremhævet billede automatisk får genereret en animeret Seedance 1.0 Lite-version. Gem begge versioner - statisk som fallback, animeret til hero-placeringer.

Masseopdatering af katalog

Et nattligt job regenererer animerede versioner af dine 500 bedste produkter med sæsonbestemte bevægelsesprompter. Frisk kreativt indhold uden menneskelig indgriben.

Opgradering til Pro eller 2.0 via API

Når et specifikt job kræver premium-kvalitet, skift endpoint:

• /seedance-1-lite/generate - $0,20-$1,00, hurtigt, til store mængder
• /seedance-1-pro/generate - $0,20-$1,00, premium bevægelse, slutbilledekontrol
• /seedance-2.0/generate - $1.20-$4.40, biografkvalitet + native lyd

Samme API-nøgle, samme creditpulje, samme godkendelse. Skift modeller ved at kalde et andet endpoint. Se Pro-sammenligningsguiden for hvornår det er værd at opgradere.

Begynd at integrere i dag

Tilmeld dig, hent din API-nøgle fra dashboardet, og foretag dit første kald med de 10 gratis credits. Python-eksemplet ovenfor kører fra ende til anden på ca. 45 sekunder og giver dig et fungerende integrationsmønster at bygge videre på.

Få din API-nøgle gratis → - 10 credits ved tilmelding, intet kort kræves, produktionsklar integration på under en time.