Seedance 2.0 Fast API: Budget videogenerering slutpunkt

En HTTP-begäran, ett premiärklass-AI-videoclip, $1,94. Det är enhetsekonomin för att bygga ovanpå 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 ~20% kostnadsfördel 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 för användare - social scheduler, marknadsföringsautomationsplattform, e-handelsinnehållsmotor, internt kreativt verktyg - är Seedance 2.0 Fast API den billigaste premiärklass-endpoint du kan bygga på under 2026.

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

Den typiska målgruppen är en utvecklare eller ett team som behöver generera video programmässigt baserat på användarinmatning - inte en enskild skapare som genererar ett clip i taget genom användargrä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örelseprompet.

Båda endpoints accepterar liknande förfrågningsstrukturer och returnerar samma svarsformat. Välj baserat på om du har en källbild att animera.

Autentisering

Varje begäran behöver en API-nyckel i Authorization-huvudet. Generera en nyckel från din Arteza instrumentpanel.

Authorization: Bearer YOUR_API_KEY

Nycklar är knutna till ditt konto och dras från ditt kreditbilans. Rotera dem efter behov genom instrumentpanelen.

Förfrågningsformat: 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): Textprompten som beskriver den önskade videon.
• duration (obligatorisk, heltal): Clipets längd i sekunder. Intervall: 4-15.
• aspect_ratio (obligatorisk, sträng): En av "16:9", "9:16", "1:1".

Förfrågningsformat: 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 åtkomlig URL för källbilden. Stödda format: JPG, PNG, WebP.
• prompt (obligatorisk, sträng): Rörelseprompet som beskriver hur bilden ska animeras.
• duration (obligatorisk, heltal): Clipets längd i sekunder. Intervall: 4-15.
• aspect_ratio (obligatorisk, sträng): Bör matcha källbildens bildformat för bäst resultat.

Svarsformat

Båda endpoints returnerar ett asynkront jobb-ID:

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

Avsöka statusendpointen tills jobbet är klart:

GET /api/v1/jobs/sdf_2026_abc123xyz

Ett slutfört 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 ner video_url och du har 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"
    }
    
    # Submit generation job
    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 queued: {job_id}, estimated {job['estimated_seconds']}s")
    
    # Poll for completion
    while True:
        time.sleep(10)
        status = requests.get(
            f"{BASE_URL}/jobs/{job_id}",
            headers=headers
        ).json()
        
        if status["status"] == "completed":
            print(f"Complete: {status['video_url']}")
            return status["video_url"]
        elif status["status"] == "failed":
            raise Exception(f"Generation failed: {status.get('error')}")
        else:
            print(f"Status: {status['status']}")

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

  // Submit generation job
  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 queued: ${job.job_id}`);

  // Poll for completion
  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(`Generation failed: ${status.error}`);
    }
  }
}

// Usage
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:n? Få din API-nyckel →

Prissättning per API-anrop

Varje API-anrop drar krediter från ditt saldo baserat på varaktighet:

Krediter löper inte ut. Köp i bulk via kredittieringar för bättre per-anrop-ekonomi - Enterprise-nivån sänker effektiv kostnad med ~17%.

Hastighetsgränser och dataflöde

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

Individuella genereringsjobb tar 30-150 sekunder beroende på varaktighet. Med 5 samtidiga jobb kan du effektivt producera ett clip var ~15-30 sekund väggklocksid.

För stora gruppgenereringar (50+ clips), skicka in i vågor om 5-10, vänta på slutförande, skicka sedan nästa våg. Flöda inte API:n med hundratals samtidiga förfrågningar.

Felhantering

Vanliga felsvar:

400 Bad Request: Ogiltiga parametrar. Kontrollera varaktighetsintervall, bildformat-värden, promptlängd.

401 Unauthorized: Saknad eller ogiltig API-nyckel.

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

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

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

Bygga din integrering för att hantera 429 och 500 på ett väl sätt med omförsökslogik. En enkel exponentiell backoff (1s, 2s, 4s, 8s) täcker de flesta övergående fel.

Fast kontra Standard i API-sammanhang

Valet mellan Fast och standard API-endpoints är mestadels ekonomiskt:

• Använd Fast för storskalig programmässig generering, kostnadsmedvetna appar, och allt som inte är ett hjälteclip.
• Använd standard för flaggskeppinnehål där den lilla kvalitetskanten rättfärdigar den 20% högre kostnaden.

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

Endpoint-URLer:

• 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 avsökning slöseri. Seedance 2.0 Fast API stöder webhook-callbacks - inkludera en webhook_url i din förfrågningsstruktur och du får ett POST när jobbet slutförs:

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-nyttolast som statusendpointen skulle returnera vid slutförande. Implementera idempotens - webhooks kan försöka igen vid misslyckande.

Vanliga frågor, snabba svar

Vad är det maximala antalet samtidiga jobb jag kan skicka in? Typiska konton: 5-10. Enterprise: förhandlingsbar.

Avdrag krediter på misslyckade jobb? Nej. Misslyckade jobb återbetalar automatiskt krediter.

Kan jag avbryta ett pågående jobb? Ja, via POST /api/v1/jobs/{job_id}/cancel. Återbetalar krediter om de avbryts innan slutförande.

Vilket filformat är utmatningen? MP4, H.264-video, AAC-ljud, 720p-upplösning.

Hur länge är utgångs-CDN-URLer giltiga? Utgångs-CDN-URLer är giltiga i 7 dagar. Ladda ner och lagra dem i ditt eget system för långtidsanvändning.

Finns det ett sandbox-/testläge? Inget dedicerat sandbox. Använd dina gratis 50 anmälningskrediter för att testa. $10 Starter-nivån är också ett lågrisk-sätt att bygga mot verkliga endpoints.

Börja bygga på Seedance 2.0 Fast API

API:n är avsiktligt enkel: två endpoints, deterministisk prissättning, asynkront jobbmodell, och ett kvalitetstak som matchar flaggskeppsnivån Seedance 2.0. Bygg på den för sociala verktyg, marknadsföringsautomation, skapande-plattformar, e-handelsinnehållsmotorer eller interna kreativa appar. Enhetsekonomin gör slutligen videogenerering genomförbar som en funktion inuti andra produkter.

Redo att bygga? Få din API-nyckel →

Fortsätt läsa: Seedance 2.0 Fast komplett guide • Seedance 2.0 Fast prissättning • Seedance 2.0 Fast batchskapande