Seedance 2.0 Fast API: Budget-venlig videogenerering endpoint

En HTTP-forespørgsel, et biografkvalitet AI-videoclip, $1,94. Det er enhedsøkonomien ved at bygge oven på Seedance 2.0 Fast API. Dedikerede endpoints til text-to-video og image-to-video, deterministisk prissætning, samme kvalitetsmottor som Seedance 2.0 standard, og en ~20% omkostningsfordel, som betyder noget, når du kører i stor skala.

Her er den fulde udviklerguide.

Hvad Fast API er til

Hvis du bygger en app, tool eller service, der genererer video for brugere - social scheduler, marketing automation-platform, e-commerce content engine, internt kreativt tool - er Seedance 2.0 Fast API det billigste biografkvalitet endpoint, du kan bygge på i 2026.

Samme visuelle kvalitet som Seedance 2.0 standard. Lavere omkostning per sekund. Højere compute throughput. Bygget til integration i workflows, der producerer video i stort omfang.

Den typiske målbrugere er en udvikler eller team, der har brug for at generere video programmatisk baseret på brugerinput - ikke en enkelt skaber, der genererer et clip ad gangen gennem brugergrænsefladen.

De to endpoints

Text-to-video endpoint:

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

Genererer en video fra en tekstprompt. Intet kildebillede påkrævet.

Image-to-video endpoint:

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

Genererer en video startende fra et uploadet kildebillede med en bevægelsesprompt.

Begge endpoints accepterer lignende request bodies og returnerer samme responsformat. Vælg baseret på, om du har et kildebillede at animere.

Godkendelse

Hver anmodning har brug for en API-nøgle i Authorization headeren. Generer en nøgle fra din Arteza dashboard.

Authorization: Bearer YOUR_API_KEY

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

Request Format: Text-To-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, string): Tekstprompten, der beskriver den ønskede video.
• duration (påkrævet, heltal): Clip-længde i sekunder. Interval: 4-15.
• aspect_ratio (påkrævet, string): En af "16:9", "9:16", "1:1".

Request Format: Image-To-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, string): Offentligt tilgængelig URL for kildebildet. Understøttede formater: JPG, PNG, WebP.
• prompt (påkrævet, string): Bevægelsesprompt, der beskriver, hvordan billedet skal animeres.
• duration (påkrævet, heltal): Clip-længde i sekunder. Interval: 4-15.
• aspect_ratio (påkrævet, string): Bør matche kildebildets billedformat for bedste resultater.

Responsformat

Begge endpoints returnerer et async job-id:

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

Poll statusendpointet, 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 dit MP4.

Komplet 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"
    }
    
    # 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"
)

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

  // 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'
);

Klar til at bygge på API'en? 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 løs vægt via kreditniveauer for bedre økonomi pr. kald - Enterprise-niveauet sænker effektive omkostninger med ~17%.

Rate Limits og Throughput

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

Individuelle generering jobs tager 30-150 sekunder afhængigt af varighed. Med 5 samtidige jobs kan du effektivt producere et clip hver ~15-30 sekunds vægtklocke-tid.

For bulk batch-generering (50+ clips) indsender du i bølger af 5-10, venter på gennemførelse, derefter indsender du næste bølge. Overbelast ikke API'en med hundredvis af samtidige anmodninger.

Fejlhåndtering

Almindelige fejlsvar:

400 Bad Request: Ugyldige parametre. Kontroller duration interval, aspect ratio værdier, promptlængde.

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

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

429 Too Many Requests: Rate limit overskredet. Træk tilbage og prøv igen.

500 Internal Server Error: Midlertidigt serverudgift. Prøv igen med eksponentiel backoff.

Byg din integration for at håndtere 429 og 500 elegantligt med retry-logik. En simpel eksponentiel 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 er primært økonomisk:

• Brug Fast til høj-volumen programmatisk generering, omkostningsfølsom apps og alt, der ikke er et hero clip.
• Brug standard til flagship-indhold, hvor den lille kvalitetsforbedring retfærdiggør 20% omkostningspræmien.

De fleste apps bruger standard Fast. Standard-endpointet er typisk reserveret til "premium tier" funktioner eller specifikke brugeranmodninger.

Endpoint-URL'er:

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

Webhook Support

For længerevarende job er polling spild. Seedance 2.0 Fast API understøtter webhook callbacks - inkludér en webhook_url i din request body, og du modtager en POST, når jobbet fuldføres:

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-endpunkt modtager samme JSON payload, som statusendpointet ville returnere ved gennemførelse. Implementér idempotence - webhooks kan prøve igen ved fejl.

Almindelige spørgsmål, hurtige svar

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

Trækkes credits på mislykkede job? Nej. Mislykkede job refunderer credits automatisk.

Kan jeg annullere et job i gang? Ja, via POST /api/v1/jobs/{job_id}/cancel. Refunderer credits, hvis annulleret før gennemførelse.

Hvad filformat er outputtet? MP4, H.264 video, AAC audio, 720p opløsning.

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

Er der en sandbox/testmodus? Ingen dedikeret sandbox. Brug dine gratis 50 tilmeldingscredits til at teste. $10 Starter-niveauet er også en lav-risiko måde at bygge mod rigtige endpoints.

Begynd at bygge på Seedance 2.0 Fast API

API'en er bevidst enkel: to endpoints, deterministisk prissætning, async job-model og en kvalitetsloft, der matcher Seedance 2.0 flagskibsniveauet. Byg på det til sociale tools, marketing automation, creator-platforme, e-commerce content engines eller interne kreative apps. Enhedsøkonomien gør endelig videogenerering mulig som en feature inden for andre produkter.

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

Læs videre: Seedance 2.0 Fast komplet guide • Seedance 2.0 Fast prissætning • Seedance 2.0 Fast batchoprettelse