Seedance 2.0 Fast API: budgetvenlig endpoint til videogenerering

Én HTTP-forespørgsel, ét biografkvalitets-AI-videoklip, $1,94. Det er enhedsøkonomien ved at bygge oven på Seedance 2.0 Fast API. Dedikerede endpoints til tekst-til-video og billede-til-video, deterministisk prissætning, samme kvalitetsmotor som Seedance 2.0 standard, og en omkostningsfordel på ca. 20%, der gør en forskel, når du kører i stor skala.

Her er den komplette udviklervejledning.

Hvad Fast API er beregnet til

Hvis du bygger en app, et værktøj eller en tjeneste, der genererer video til brugere, f.eks. en social planlægger, en marketingautomatiseringsplatform, en e-handelsindholdsmotor eller et internt kreativt værktøj, er Seedance 2.0 Fast API det billigste biografkvalitets-endpoint, du kan bygge på i 2026.

Samme visuelle kvalitet som Seedance 2.0 standard. Lavere pris pr. sekund. Højere beregningsgennemløb. Bygget til integration i arbejdsgange, der producerer video i store mængder.

Den typiske målbruger er en udvikler eller et team, der skal generere video programmatisk baseret på brugerinput, ikke en enkelt skaber, der genererer ét klip ad gangen via brugergrænsefladen.

De to endpoints

Tekst-til-video-endpoint:

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

Genererer en video ud fra en tekstprompt. Intet kildebillede er nødvendigt.

Billede-til-video-endpoint:

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

Genererer en video med udgangspunkt i et uploadet kildebillede med en bevægelsesprompt.

Begge endpoints accepterer lignende request-bodies og returnerer samme svarformat. Vælg ud fra, om du har et kildebillede, der skal animeres.

Autentificering

Hver forespørgsel kræver en API-nøgle i Authorization-headeren. Generer en nøgle fra dit Arteza dashboard.

Authorization: Bearer YOUR_API_KEY

Nøgler er knyttet til din konto og trækker fra din creditsaldo. Roter dem efter behov via dashboardet.

Requestformat: tekst til 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"
}

Parametre:

• prompt (påkrævet, streng): Tekstprompt, der beskriver den ønskede video.
• duration (påkrævet, heltal): Kliplængde i sekunder. Område: 4-15.
• aspect_ratio (påkrævet, streng): Én af "16:9", "9:16", "1:1".

Requestformat: billede til 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"
}

Parametre:

• image_url (påkrævet, streng): Offentligt tilgængeligt URL til kildebilledet. Understøttede formater: JPG, PNG, WebP.
• prompt (påkrævet, streng): Bevægelsesprompt, der beskriver, hvordan billedet skal animeres.
• duration (påkrævet, heltal): Kliplængde i sekunder. Område: 4-15.
• aspect_ratio (påkrævet, streng): Bør matche kildebilledets billedformat for bedste resultat.

Svarformat

Begge endpoints returnerer et asynkront job-ID:

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

Poll status-endpointet, indtil jobbet er fuldført:

GET /api/v1/jobs/sdf_2026_abc123xyz

Et fuldfø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
}

Download video_url, og du har din MP4.

Fuldt Python-eksempel

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"
    }
    
    # Send genereringsjob
    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 sat i kø: {job_id}, estimeret {job['estimated_seconds']}s")
    
    # Poll for fuldførelse
    while True:
        time.sleep(10)
        status = requests.get(
            f"{BASE_URL}/jobs/{job_id}",
            headers=headers
        ).json()
        
        if status["status"] == "completed":
            print(f"Fuldført: {status['video_url']}")
            return status["video_url"]
        elif status["status"] == "failed":
            raise Exception(f"Generering mislykkedes: {status.get('error')}")
        else:
            print(f"Status: {status['status']}")

# Brug
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"
)

Fuldt JavaScript-eksempel

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

  // Send genereringsjob
  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 sat i kø: ${job.job_id}`);

  // Poll for fuldførelse
  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 mislykkedes: ${status.error}`);
    }
  }
}

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

Klar til at bygge på API'et? Få din API-nøgle →

Prissætning pr. API-kald

Hvert API-kald trækker credits fra din saldo baseret på varighed:

Credits udløber ikke. Køb i store mængder via kredittrin for bedre økonomi pr. kald. Enterprise-niveauet sænker den effektive pris med ca. 17%.

Hastighedsbegrænsninger og gennemløb

Seedance 2.0 Fast API tillader samtidige jobindsendelser inden for rimelige grænser. Typiske konti kan indsende 5-10 job parallelt uden at ramme begrænsninger. Enterprise-konti kan anmode om højere samtidighed.

Individuelle genereringsjob tager 30-150 sekunder afhængigt af varighed. Med 5 samtidige job kan du effektivt producere et klip hvert 15-30 sekunder i reel tid.

Ved massebatchgenerering (50+ klip) bør du indsende i bølger af 5-10, vente på fuldførelse og derefter indsende den næste bølge. Oversvøm ikke API'et med hundredvis af samtidige forespørgsler.

Fejlhåndtering

Almindelige fejlsvar:

400 Bad Request: Ugyldige parametre. Tjek varlighedsområde, billedformatværdier og promptlængde.

401 Unauthorized: Manglende eller ugyldig API-nøgle.

402 Payment Required: Utilstrækkelige credits. Optank via dashboardet.

429 Too Many Requests: Hastighedsgrænse overskredet. Vent og prøv igen.

500 Internal Server Error: Midlertidigt serverprob. Prøv igen med eksponentielt backoff.

Byg din integration til at håndtere 429 og 500 elegant med logik til genforsøg. Et simpelt eksponentielt backoff (1s, 2s, 4s, 8s) dækker de fleste forbigående fejl.

Fast vs. standard i API-kontekst

Valget mellem Fast og standard API-endpoints handler primært om økonomi:

• Brug Fast til højtvolumen programmatisk generering, omkostningsfølsomme apps og alt, der ikke er et flagskibsklip.
• Brug standard til flagskibsindhold, hvor den lille kvalitetsforskel retfærdiggør de 20% ekstra i pris.

De fleste apps bruger Fast som standard. Standard-endpointet er typisk forbeholdt "premium-niveau"-funktioner eller specifikke brugerønsker.

Endpoint-URL'er:

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

Webhook-understøttelse

For langvarige job er polling spild af ressourcer. Seedance 2.0 Fast API understøtter webhook-callbacks. Inkluder en webhook_url i din request-body, og du modtager en POST, når jobbet er fuldført:

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

Dit webhook-endpoint modtager den samme JSON-payload, som status-endpointet ville returnere ved fuldførelse. Implementer idempotens, da webhooks kan forsøge igen ved fejl.

Almindelige spørgsmål og hurtige svar

Hvad er det maksimale antal samtidige job, jeg kan indsende? Typiske konti: 5-10. Enterprise: kan forhandles.

Trækkes der credits ved mislykkede job? Nej. Mislykkede job refunderer automatisk credits.

Kan jeg annullere et igangværende job? Ja, via POST /api/v1/jobs/{job_id}/cancel. Credits refunderes, hvis det annulleres inden fuldførelse.

Hvilket filformat er outputtet? MP4, H.264-video, AAC-lyd, 720p opløsning.

Hvor længe er output-URL'er gyldige? Output-CDN-URL'er er gyldige i 7 dage. Download og gem dem i dit eget system til langtidsbrug.

Er der en sandkasse/testtilstand? Ingen dedikeret sandkasse. Brug dine 10 gratis tilmeldingscredits til at teste. $5-starterplanen er også en lavrisikometode til at bygge mod rigtige endpoints.

Kom i gang med at bygge på Seedance 2.0 Fast API

API'et er bevidst enkelt: to endpoints, deterministisk prissætning, asynkron jobmodel og et kvalitetsloft, der matcher det overordnede Seedance 2.0-niveau. Byg på det til sociale medieværktøjer, marketingautomatisering, skabsplatforme, e-handelsindholdsmotor eller interne kreative apps. Enhedsøkonomien gør endelig videogenerering gennemførlig som en funktion inden i andre produkter.

Klar til at bygge? Få din API-nøgle →

Læs videre: Komplet guide til Seedance 2.0 Fast • Priser for Seedance 2.0 Fast • Batchoprettelse med Seedance 2.0 Fast