Seedance 1.0 Lite API: snabb endpoint för videogenerering

En enda POST-förfrågan, 30-60 sekunders väntan och du får tillbaka en 1080p MP4. Det är hela Seedance 1.0 Lite API:et. Den här integrationsguiden riktar sig till utvecklare som bygger automatiserade videoflöden, oavsett om det handlar om animationer för e-handelsprodukter, pipelines för annonskreativ eller system för innehållsgenerering.

Varför utvecklare integrerar API:et

UI-versionen av Seedance 1.0 Lite är utmärkt för manuell generering. API:et låser upp de arbetsflöden som manuell användning inte kan stödja:

• Automatiserad kataloganimation - trigga en generering för varje ny SKU som läggs till i din e-handelsbackend
• Pipelines för annonskreativ - generera varianter enligt ett schema och pusha till annonsplattformar via deras API:er
• System för innehållsgenerering - mata in CMS-bilder i Arteza och få animerade versioner tillbaka
• Realtidsflöden med användargenererat innehåll - låt dina egna användare ladda upp en bild och få en animerad version tillbaka
• Batchjobb - bearbeta hundratals källbilder över natten

Till $0,20-$1,00 per anrop och 30-60 sekunders handläggningstid kan du bygga videoautomatisering i produktionsklass som hade varit ekonomiskt omöjlig för 18 månader sedan.

Få tillgång till API:et

1. Registrera dig på plattformen - 10 gratiskrediter anländer omedelbart
2. Navigera till API-inställningar i din instrumentpanel
3. Generera en API-nyckel - förvara den säkert (commit:a den aldrig till git)
4. Valfritt: Välj en månadsplan på prissidan - $5, $25, $50 eller $120

Dina 10 gratiskrediter fungerar även för API-anrop. Du kan validera hela integrationen innan du betalar något.

Förfrågningsmodellen

Kärnan i interaktionen är en enda POST till Seedance 1.0 Lite:s genereringsendpoint.

Obligatoriska parametrar

Valfria parametrar

Svarsmodell

API:et returnerar ett jobb-ID och en status. Generering är asynkron - pollar efter slutförande eller använd 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 är klart:

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

Autentisering

Alla förfrågningar använder bearer-tokenautentisering via Authorization-headern:

Authorization: Bearer YOUR_API_KEY

API-nycklar är kopplade till ditt konto och debiteras mot ditt kreditsaldo. Rotera nycklar via instrumentpanelen om du misstänker ett intrång.

Kodexempel: Python

Här är en minimal Python-integration som skickar ett jobb, pollar efter slutförande och laddar ned 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"):
    # Skicka 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"]
    
    # Polla efter slutförande
    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 misslyckades: {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}")

Kodexempel: 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') {
  // Skicka 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}` },
    }
  );

  // Polla efter slutförande
  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 (rekommenderas för produktion)

Polling fungerar, men webhooks är smidigare i stor skala. Skicka med en webhook_url i din genereringsförfrågan så POSTar API:et slutförandepaketet när jobbet är klart.

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-hanterare tar emot samma slutförande-JSON som polling-endpointen. Ingen pollingsloop krävs.

Vill du göra det här själv? Prova Seedance 1.0 Lite gratis →

Redo att prova Seedance 1.0 Lite? Börja skapa gratis →

Hastighetsgränser och samtidighet

För högre samtidighet eller volym kontaktar du supporten. Plattformen kan hantera batcharbetsbelastningar på 10 000+ jobb per dag i dedikerade upplägg.

Felhantering

Standardmässiga HTTP-statuskoder gäller:

För produktionsintegrationer ska du alltid implementera:

• Exponentiell backoff för 429- och 500-fel
• Kontroll av kreditsaldo innan stora batchkörningar
• Validering av webhook-signaturer om du använder webhooks
• Idempotensnycklar för att förhindra dubbla debiteringar vid nätverksfel

Kostnadshantering i produktion

Varje anrop debiterar krediter efter längd: 2 krediter för ett klipp på 2-3 sekunder, upp till 7 krediter vid 12 sekunder.

Tips för kostnadskontroll i produktion:

• Testa prompter vid 2 sekunder innan du förbinder dig till batchkörningar på 12 sekunder
• Sätt en månatlig kreditbudget och låt din kod stanna när den nås
• Övervaka fältet credits_charged i varje svar för att spåra utgifter per arbetsflöde
• Använd webhooks för att undvika att slösa tid på polling
• Cachelagra lyckade resultat när det är möjligt så att identiska förfrågningar inte genereras om

Verkliga integrationsmönster

Animering av e-handelskatalog

Trigga ett Seedance 1.0 Lite-jobb varje gång en ny SKU läggs till i din katalog. Skriv den resulterande MP4-URL:en till din produktdatabas. Visa automatiskt på produktdetaljsidor.

Pipeline för annonskreativ

Ett dagligt cron-jobb genererar 10 nya annonskarianter från olika källbilder. Pushar MP4-filer direkt till Meta Ads API som nytt kreativt material. Sluter loopen mellan innehållsgenerering och annonsleverans.

Appar med användargenererat innehåll

Låt användare ladda upp ett foto i din app. Din backend anropar Seedance 1.0 Lite med en mallad prompt. Returnera den animerade versionen till användaren på under en minut. Debitera användarna tillräckligt för att täcka API-kostnaden på ~$0.20 med god marginal.

CMS-förbättring

Koppla in dig i ditt CMS så att varje ny framhävd bild automatiskt får en animerad Seedance 1.0 Lite-version genererad. Lagra båda versionerna, den statiska som reserv och den animerade för hero-placeringar.

Batchförnyelse av katalog

Ett nattligt jobb regenererar animerade versioner av dina 500 bästsäljande produkter med säsongsanpassade rörelseprompter. Fräscht kreativt material utan mänsklig inblandning.

Uppgradering till Pro eller 2.0 via API

När ett specifikt jobb kräver premiumkvalitet byter du endpoint:

• /seedance-1-lite/generate - $0,20-$1,00, snabb, volymens arbetshäst
• /seedance-1-pro/generate - $0,20-$1,00, premiumrörelse, kontroll av slutbild
• /seedance-2.0/generate - $1.20-$4.40, biofilmskvalitet och inbyggt ljud

Samma API-nyckel, samma kreditpool, samma autentisering. Byt modell genom att anropa en annan endpoint. Se Pro-jämförelseguiden för när du bör uppgradera.

Börja integrera idag

Registrera dig, hämta din API-nyckel från instrumentpanelen och gör ditt första anrop med de 10 gratisvkrediterna. Python-exemplet ovan körs från start till mål på ungefär 45 sekunder och ger dig ett fungerande integrationsmönster att bygga vidare på.

Hämta din API-nyckel gratis → - 10 krediter vid registrering, inget kort krävs, produktionsklar integration på under en timme.