Seedance 2.0 Fast API: tani endpoint do generowania wideo

Jedno żądanie HTTP, jeden klip wideo klasy kinowej, 1,94 dolara. Takie są koszty jednostkowe budowania na bazie Seedance 2.0 Fast API. Dedykowane endpointy dla text-to-video i image-to-video, deterministyczne ceny, ten sam silnik jakości co Seedance 2.0 standard, i około 20% przewaga kosztowa, która ma znaczenie przy dużej skali.

Oto kompletny przewodnik dla deweloperów.

Do czego służy Fast API

Jeśli tworzysz aplikację, narzędzie lub usługę generującą wideo dla użytkowników, taką jak harmonogramator mediów społecznościowych, platforma automatyzacji marketingu, silnik treści e-commerce czy wewnętrzne narzędzie kreatywne, Seedance 2.0 Fast API to najtańszy endpoint wideo klasy kinowej, na którym możesz budować w 2026 roku.

Ta sama jakość wizualna co Seedance 2.0 standard. Niższy koszt za sekundę. Wyższa przepustowość obliczeniowa. Zbudowany z myślą o integracji z przepływami pracy produkującymi wideo w dużych ilościach.

Typowym docelowym użytkownikiem jest deweloper lub zespół, który musi generować wideo programowo na podstawie danych wejściowych użytkownika, a nie pojedynczy twórca generujący jeden klip naraz przez interfejs graficzny.

Dwa endpointy

Endpoint text-to-video:

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

Generuje wideo na podstawie prompta tekstowego. Nie wymaga obrazu źródłowego.

Endpoint image-to-video:

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

Generuje wideo zaczynające się od przesłanego obrazu źródłowego z promptem ruchu.

Oba endpointy przyjmują podobne treści żądań i zwracają ten sam format odpowiedzi. Wybierz na podstawie tego, czy masz obraz źródłowy do animowania.

Autoryzacja

Każde żądanie wymaga klucza API w nagłówku Authorization. Wygeneruj klucz w swoim Panel Arteza.

Authorization: Bearer YOUR_API_KEY

Klucze są powiązane z twoim kontem i pobierają środki z salda kredytów. Rotuj je według potrzeb przez panel.

Format żądania: 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"
}

Parametry:

• prompt (wymagany, string): Prompt tekstowy opisujący pożądane wideo.
• duration (wymagany, integer): Długość klipu w sekundach. Zakres: 4-15.
• aspect_ratio (wymagany, string): Jedna z wartości: "16:9", "9:16", "1:1".

Format żądania: 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"
}

Parametry:

• image_url (wymagany, string): Publicznie dostępny URL obrazu źródłowego. Obsługiwane formaty: JPG, PNG, WebP.
• prompt (wymagany, string): Prompt ruchu opisujący sposób animowania obrazu.
• duration (wymagany, integer): Długość klipu w sekundach. Zakres: 4-15.
• aspect_ratio (wymagany, string): Powinien odpowiadać proporcjom obrazu źródłowego dla najlepszych wyników.

Format odpowiedzi

Oba endpointy zwracają asynchroniczne ID zadania:

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

Odpytuj endpoint statusu do momentu ukończenia zadania:

GET /api/v1/jobs/sdf_2026_abc123xyz

Odpowiedź po ukończeniu:

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

Pobierz video_url i masz swój plik MP4.

Pełny przykład w Pythonie

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"
    }
    
    # Wyślij zadanie generacji
    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"Zadanie w kolejce: {job_id}, szacowany czas {job['estimated_seconds']}s")
    
    # Odpytuj o ukończenie
    while True:
        time.sleep(10)
        status = requests.get(
            f"{BASE_URL}/jobs/{job_id}",
            headers=headers
        ).json()
        
        if status["status"] == "completed":
            print(f"Ukończono: {status['video_url']}")
            return status["video_url"]
        elif status["status"] == "failed":
            raise Exception(f"Generacja nie powiodła się: {status.get('error')}")
        else:
            print(f"Status: {status['status']}")

# Użycie
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"
)

Pełny przykład w JavaScript

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

  // Wyślij zadanie generacji
  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(`Zadanie w kolejce: ${job.job_id}`);

  // Odpytuj o ukończenie
  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(`Generacja nie powiodła się: ${status.error}`);
    }
  }
}

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

Gotowy, żeby zbudować coś na API? Pobierz swój klucz API →

Ceny za wywołanie API

Każde wywołanie API odejmuje kredyty z salda na podstawie czasu trwania:

Kredyty nie wygasają. Kupuj hurtowo przez poziomy kredytów, aby uzyskać lepszą ekonomikę wywołań. Tier Enterprise obniża efektywny koszt o około 17%.

Limity szybkości i przepustowość

Seedance 2.0 Fast API umożliwia równoczesne przesyłanie zadań w rozsądnych granicach. Typowe konta mogą przesyłać 5-10 zadań równolegle bez przekraczania limitów. Konta w tierze Enterprise mogą wnioskować o wyższy poziom współbieżności.

Poszczególne zadania generacji trwają 30-150 sekund w zależności od czasu trwania klipu. Przy 5 równoległych zadaniach możesz efektywnie produkować klip co około 15-30 sekund czasu rzeczywistego.

W przypadku masowej generacji wsadowej (50 i więcej klipów) przesyłaj je falami po 5-10, poczekaj na ukończenie, a następnie wyślij kolejną falę. Nie zalewaj API setkami jednoczesnych żądań.

Obsługa błędów

Typowe odpowiedzi z błędami:

400 Bad Request: Nieprawidłowe parametry. Sprawdź zakres czasu trwania, wartości proporcji i długość prompta.

401 Unauthorized: Brakujący lub nieprawidłowy klucz API.

402 Payment Required: Niewystarczająca liczba kredytów. Doładuj przez panel.

429 Too Many Requests: Przekroczono limit szybkości. Odczekaj chwilę i spróbuj ponownie.

500 Internal Server Error: Tymczasowy problem z serwerem. Ponów żądanie z wykładniczym cofnięciem.

Zbuduj integrację tak, aby obsługiwała błędy 429 i 500 z logiką ponownych prób. Proste wykładnicze cofnięcie (1s, 2s, 4s, 8s) pokrywa większość przejściowych awarii.

Fast a standard w kontekście API

Wybór między endpointami Fast i standard jest głównie kwestią ekonomiczną:

• Używaj Fast do wysokonakładowej generacji programowej, aplikacji wrażliwych na koszty i wszystkiego, co nie jest kluczowym klipem.
• Używaj standardowego do flagowych treści, gdzie niewielka przewaga jakościowa uzasadnia 20% wyższy koszt.

Większość aplikacji domyślnie używa Fast. Endpoint standard jest zazwyczaj zarezerwowany dla funkcji "tier premium" lub konkretnych żądań użytkowników.

Adresy URL endpointów:

• 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

Obsługa webhooków

W przypadku długo trwających zadań odpytywanie jest nieefektywne. Seedance 2.0 Fast API obsługuje wywołania zwrotne przez webhook. Dodaj webhook_url do treści żądania, a otrzymasz żądanie POST po ukończeniu zadania:

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

Twój endpoint webhooka otrzymuje ten sam ładunek JSON, który zwróciłby endpoint statusu po ukończeniu. Zadbaj o idempotentność, ponieważ webhooki mogą ponawiać próby w razie awarii.

Częste pytania, szybkie odpowiedzi

Jaka jest maksymalna liczba równoczesnych zadań? Typowe konta: 5-10. Enterprise: do uzgodnienia.

Czy kredyty są odejmowane w przypadku nieudanych zadań? Nie. Nieudane zadania automatycznie zwracają kredyty.

Czy mogę anulować zadanie w trakcie realizacji? Tak, przez POST /api/v1/jobs/{job_id}/cancel. Zwraca kredyty, jeśli anulowano przed ukończeniem.

Jaki format ma plik wyjściowy? MP4, wideo H.264, audio AAC, rozdzielczość 720p.

Jak długo są ważne adresy URL plików wyjściowych? Adresy URL CDN są ważne przez 7 dni. Pobierz je i przechowuj we własnym systemie do długoterminowego użytku.

Czy jest tryb sandbox/testowy? Brak dedykowanego sandboxa. Użyj 10 darmowych kredytów przy rejestracji do testów. Plan Starter za 5 dolarów to także niskobudżetowy sposób na budowanie z użyciem prawdziwych endpointów.

Zacznij budować na Seedance 2.0 Fast API

API jest celowo proste: dwa endpointy, deterministyczne ceny, asynchroniczny model zadań i pułap jakości odpowiadający flagowemu tierowi Seedance 2.0. Buduj na nim narzędzia społecznościowe, automatyzację marketingu, platformy dla twórców, silniki treści e-commerce lub wewnętrzne aplikacje kreatywne. Ekonomika jednostkowa sprawia, że generowanie wideo staje się wreszcie realną funkcją wbudowaną w inne produkty.

Gotowy, żeby budować? Pobierz swój klucz API →

Czytaj dalej: Kompletny przewodnik po Seedance 2.0 Fast • Cennik Seedance 2.0 Fast • Tworzenie wsadowe w Seedance 2.0 Fast