Seedance 2.0 Fast API: budgetvänlig endpoint för videogenerering

En HTTP-förfrågan, ett bioklipp med AI-kvalitet, 1,94 dollar. Det är enhetskostnaderna för att bygga på Seedance 2.0 Fast API. Dedikerade endpoints för text-till-video och bild-till-video, deterministisk prissättning, samma kvalitetsmotor som Seedance 2.0 standard och en kostnadsförbättring på ungefär 20 % som spelar roll när du kör i stor skala.

Här är den fullständiga utvecklarguiden.

Vad Fast API är till för

Om du bygger en app, ett verktyg eller en tjänst som genererar video åt användare, till exempel en schemaläggare för sociala medier, en marknadsföringsautomationsplattform, en innehållsmotor för e-handel eller ett internt kreativt verktyg, är Seedance 2.0 Fast API den billigaste endpoint med biokvalietet du kan bygga på under 2026.

Samma visuella kvalitet som Seedance 2.0 standard. Lägre kostnad per sekund. Högre beräkningskapacitet. Byggd för integrering i arbetsflöden som producerar video i stor volym.

Den typiska målanvändaren är en utvecklare eller ett team som behöver generera video programmatiskt baserat på användarinput, inte en enskild skapare som genererar ett klipp i taget via gränssnittet.

De två endpoints

Text-till-video-endpoint:

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

Genererar en video från en textprompt. Ingen källbild krävs.

Bild-till-video-endpoint:

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

Genererar en video med start från en uppladdad källbild med en rörelseprompt.

Båda endpoints accepterar liknande request-body och returnerar samma svarsformat. Välj utifrån om du har en källbild att animera.

Autentisering

Varje förfrågan kräver en API-nyckel i Authorization-headern. Generera en nyckel från ditt Arteza dashboard.

Authorization: Bearer YOUR_API_KEY

Nycklar är kopplade till ditt konto och drar från ditt kreditssaldo. Rotera dem efter behov via instrumentpanelen.

Request-format: text till 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"
}

Parametrar:

• prompt (obligatorisk, sträng): Textprompt som beskriver önskad video.
• duration (obligatorisk, heltal): Klipplängd i sekunder. Intervall: 4-15.
• aspect_ratio (obligatorisk, sträng): En av "16:9", "9:16", "1:1".

Request-format: bild till 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"
}

Parametrar:

• image_url (obligatorisk, sträng): Offentligt tillgänglig URL till källbilden. Format som stöds: JPG, PNG, WebP.
• prompt (obligatorisk, sträng): Rörelseprompt som beskriver hur bilden ska animeras.
• duration (obligatorisk, heltal): Klipplängd i sekunder. Intervall: 4-15.
• aspect_ratio (obligatorisk, sträng): Bör matcha källbildens bildförhållande för bästa resultat.

Svarsformat

Båda endpoints returnerar ett asynkront jobb-ID:

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

Polla status-endpointen tills jobbet är klart:

GET /api/v1/jobs/sdf_2026_abc123xyz

Ett avslutat svar:

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

Ladda ned video_url så har du din MP4.

Fullständigt Python-exempel

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"
    }
    
    # Skicka in genereringsjobb
    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"Jobb i kö: {job_id}, beräknad tid {job['estimated_seconds']}s")
    
    # Polla tills klart
    while True:
        time.sleep(10)
        status = requests.get(
            f"{BASE_URL}/jobs/{job_id}",
            headers=headers
        ).json()
        
        if status["status"] == "completed":
            print(f"Klart: {status['video_url']}")
            return status["video_url"]
        elif status["status"] == "failed":
            raise Exception(f"Generering misslyckades: {status.get('error')}")
        else:
            print(f"Status: {status['status']}")

# Användning
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"
)

Fullständigt JavaScript-exempel

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'
  };

  // Skicka in genereringsjobb
  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(`Jobb i kö: ${job.job_id}`);

  // Polla tills klart
  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(`Generering misslyckades: ${status.error}`);
    }
  }
}

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

Redo att bygga på API:et? Hämta din API-nyckel →

Prissättning per API-anrop

Varje API-anrop drar krediter från ditt saldo baserat på längd:

Krediter löper inte ut. Köp i bulk via kreditnivåer för bättre kostnad per anrop. Enterprise-nivån sänker den effektiva kostnaden med ungefär 17 %.

Hastighetsgränser och kapacitet

Seedance 2.0 Fast API tillåter parallella jobbinskickningar inom rimliga gränser. Typiska konton kan skicka in 5-10 jobb parallellt utan att träffa begränsningar. Enterprise-konton kan begära högre samtidighet.

Enskilda genereringsjobb tar 30-150 sekunder beroende på längd. Med 5 parallella jobb kan du effektivt producera ett klipp var 15-30 sekunder i realtid.

Vid massvis batchgenerering (50 eller fler klipp) skickar du in i omgångar om 5-10, väntar på att de slutförs och skickar sedan in nästa omgång. Översvämma inte API:et med hundratals simultana förfrågningar.

Felhantering

Vanliga felsvar:

400 Bad Request: Ogiltiga parametrar. Kontrollera durationsintervall, bildförhållandets värden och promptlängd.

401 Unauthorized: Saknad eller ogiltig API-nyckel.

402 Payment Required: Otillräckliga krediter. Fyll på via instrumentpanelen.

429 Too Many Requests: Hastighetsgränsen överskreds. Backa av och försök igen.

500 Internal Server Error: Tillfälligt serverfel. Försök igen med exponentiell backoff.

Bygg din integration för att hantera 429 och 500 på ett smidigt sätt med retry-logik. En enkel exponentiell backoff (1 s, 2 s, 4 s, 8 s) täcker de flesta tillfälliga fel.

Fast jämfört med standard i API-sammanhang

Valet mellan Fast och standard-API-endpoints handlar i huvudsak om ekonomi:

• Använd Fast för storskalig programmatisk generering, kostnadskänsliga appar och allt som inte är ett flaggskepp-klipp.
• Använd standard för premiuminnehåll där den lilla kvalitetsfördelen motiverar 20 % högre kostnad.

De flesta appar använder Fast som standard. Standard-endpointen är typiskt reserverad för "premium"-funktioner eller specifika användarförfrågningar.

Endpoint-URL:er:

• Fast text: bytedance/seedance-2.0/fast/text-to-video
• Fast bild: bytedance/seedance-2.0/fast/image-to-video
• Standard text: bytedance/seedance-2.0/text-to-video
• Standard bild: bytedance/seedance-2.0/image-to-video

Webhook-stöd

För långvariga jobb är polling ineffektivt. Seedance 2.0 Fast API stöder webhook-callbacks. Inkludera en webhook_url i din request-body så får du en POST när jobbet är klart:

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

Din webhook-endpoint tar emot samma JSON-payload som status-endpointen returnerar vid slutförande. Implementera idempotens: webhooks kan göra nya försök vid fel.

Vanliga frågor med snabba svar

Hur många jobb kan jag skicka in parallellt? Typiska konton: 5-10. Enterprise: förhandlingsbart.

Dras krediter av vid misslyckade jobb? Nej. Misslyckade jobb återbetalar krediterna automatiskt.

Kan jag avbryta ett pågående jobb? Ja, via POST /api/v1/jobs/{job_id}/cancel. Krediterna återbetalas om jobbet avbryts innan det slutförs.

Vilket filformat har utdata? MP4, H.264-video, AAC-ljud, 720p-upplösning.

Hur länge är utdata-URL:erna giltiga? CDN-URL:er för utdata är giltiga i 7 dagar. Ladda ned och lagra dem i ditt eget system för långsiktig användning.

Finns det ett sandlåde- eller testläge? Ingen dedikerad sandlåda. Använd dina 10 gratis registreringskrediter för att testa. Starter-planen för 5 dollar är också ett riskfritt sätt att bygga mot riktiga endpoints.

Börja bygga på Seedance 2.0 Fast API

API:et är medvetet enkelt: två endpoints, deterministisk prissättning, asynkron jobbmodell och ett kvalitetstak som matchar det ledande Seedance 2.0-nivån. Bygg på det för sociala verktyg, marknadsföringsautomation, kreatörplattformar, innehållsmotorer för e-handel eller interna kreativa appar. Enhetskostnaderna gör äntligen videogenerering genomförbart som en funktion i andra produkter.

Redo att bygga? Hämta din API-nyckel →

Fortsätt läsa: Komplett guide till Seedance 2.0 Fast • Prissättning för Seedance 2.0 Fast • Batchskapande med Seedance 2.0 Fast