Seedance 2.0 Fast API: Punkt końcowy generowania wideo w niskiej cenie

Jedno żądanie HTTP, jeden kinowy klip AI, 1,94 dolary. To jest ekonomika jednostkowa budowania na Seedance 2.0 Fast API. Dedykowane endpointy do 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, gdy pracujesz na dużą skalę.

Oto pełny przewodnik dla deweloperów.

Do czego służy Fast API

Jeśli budujesz aplikację, narzędzie lub usługę, która generuje filmy dla użytkowników - harmonogram mediów społecznych, platforma automatyzacji marketingu, silnik treści e-commerce, wewnętrzne narzędzie twórcze - Seedance 2.0 Fast API to najtańszy kinowy endpoint, 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ść obliczeń. Zbudowany do integracji w przepływach pracy, które generują wideo na dużą skalę.

Typowy użytkownik docelowy to deweloper lub zespół, który musi programowo generować filmy na podstawie danych wejściowych użytkownika - nie pojedynczy twórca generujący jeden klip na raz przez interfejs użytkownika.

Dwa endpointy

Endpoint text-to-video:

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

Generuje film z tekstowego prompta. Obraz źródłowy nie jest wymagany.

Endpoint image-to-video:

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

Generuje film rozpoczynający się od przesłanego obrazu źródłowego z promptem ruchu.

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

Autentykacja

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

Authorization: Bearer YOUR_API_KEY

Klucze są powiązane z Twoim kontem i pobierają z salda kredytowego. Obracaj nimi w razie potrzeby za pośrednictwem panelu.

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 (wymagane, string): Tekstowy prompt opisujący żądany film.
• duration (wymagane, integer): Długość klipu w sekundach. Zakres: 4-15.
• aspect_ratio (wymagane, string): Jeden z "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 (wymagane, string): Publicznie dostępny URL obrazu źródłowego. Obsługiwane formaty: JPG, PNG, WebP.
• prompt (wymagane, string): Prompt ruchu opisujący, jak animować obraz.
• duration (wymagane, integer): Długość klipu w sekundach. Zakres: 4-15.
• aspect_ratio (wymagane, string): Powinno odpowiadać proporcjom obrazu źródłowego dla najlepszych wyników.

Format odpowiedzi

Oba endpointy zwracają asynchroniczny ID zadania:

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

Sprawdzaj status endpointu, aż zadanie będzie ukończone:

GET /api/v1/jobs/sdf_2026_abc123xyz

Ukończona odpowiedź:

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

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

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

Gotowy do budowania na API? Pobierz swój klucz API →

Cena za wywołanie API

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

Kredyty nie wygasają. Kupuj hurtowo za pośrednictwem Poziomy kredytów dla lepszej ekonomiki na wywołanie - warstwa Enterprise obniża efektywny koszt o około 17%.

Limity szybkości i przepustowość

Seedance 2.0 Fast API umożliwia współbieżne przesyłanie zadań w rozsądnych limitach. Typowe konta mogą przesyłać 5-10 zadań równolegle bez uderzenia w przepustnicy. Konta warstwy Enterprise mogą żądać wyższej współbieżności.

Poszczególne zadania generowania zajmują 30-150 sekund w zależności od czasu trwania. Przy 5 równoczesnych zadaniach możesz efektywnie produkować klip co około 15-30 sekund czasu ściennego.

Do zbiorowego generowania partii (50+ klipów), przesyłaj w falach po 5-10, czekaj na zakończenie, a następnie przesyłaj następną falę. Nie zalewa interfejsu API setkami równoczesnych żądań.

Obsługa błędów

Typowe odpowiedzi błędów:

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

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

402 Payment Required: Niewystarczające kredyty. Doładuj za pośrednictwem panelu.

429 Too Many Requests: Limit szybkości przekroczony. Cofnij się i spróbuj ponownie.

500 Internal Server Error: Tymczasowy problem z serwerem. Spróbuj ponownie z wykładniczym wycofywaniem się.

Buduj swoją integrację do elegancji obsługi 429 i 500 za pomocą logiki ponawiania. Proste wykładnicze wycofywanie (1s, 2s, 4s, 8s) obejmuje większość przejściowych awarii.

Fast vs Standard w kontekście API

Wybór między Fast i standardowymi endpointami API jest głównie ekonomiczny:

• Użyj Fast do programowego generowania dużej objętości, aplikacji wrażliwych na koszt i wszystkiego, co nie jest klipu bohatera.
• Użyj standard dla zawartości flagowej, gdzie mała przewaga jakości uzasadnia 20% premię kosztową.

Większość aplikacji domyślnie korzysta z Fast. Standardowy endpoint jest zazwyczaj zarezerwowany dla funkcji "warstwa premium" lub określonych żądań użytkownika.

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 przypadku długotrwałych zadań sondowanie jest nieefektywne. Seedance 2.0 Fast API obsługuje zwrotne połączenia webhook - uwzględnij webhook_url w treści żądania, a otrzymasz 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 webhook odbiera tę samą ładowność JSON, którą zwróciłby endpoint statusu po ukończeniu. Wdrożyć idempotencję - webhoki mogą ponowić się w przypadku niepowodzenia.

Typowe pytania, szybkie odpowiedzi

Jaka jest maksymalna liczba współbieżnych zadań, które mogę przesłać? Konta typowe: 5-10. Enterprise: negocjowalne.

Czy kredyty odejmują się w przypadku nieudanych zadań? Nie. Nieudane zadania automatycznie zwracają kredyty.

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

Jaki format pliku ma dane wyjściowe? MP4, H.264 video, AAC audio, rozdzielczość 720p.

Jak długo pozostają ważne adresy URL danych wyjściowych? Adresy URL wyjściowego CDN są ważne przez 7 dni. Pobierz i przechowuj je w swoim własnym systemie na dłuższy termin.

Czy istnieje tryb piaskownicy/testowania? Brak dedykowanej piaskownicy. Użyj bezpłatnych 50 kredytów rejestracji do testowania. Warstwa Starter za 10 dolarów to również niskorizykowny sposób na zbudowanie na rzeczywistych endpointach.

Zacznij budować na Seedance 2.0 Fast API

API jest celowo proste: dwa endpointy, deterministyczne ceny, asynchroniczny model zadania i sufit jakości, który odpowiada flagowej warstwie Seedance 2.0. Buduj na niej do narzędzi mediów społecznych, automatyzacji marketingu, platform twórców, silników treści e-commerce lub wewnętrznych aplikacji twórczych. Ekonomika jednostkowa wreszcie sprawia, że generowanie wideo jest wykonalne jako funkcja wewnątrz innych produktów.

Gotowy do budowania? Pobierz swój klucz API →

Czytaj dalej: Kompleksowy przewodnik Seedance 2.0 Fast • Cennik Seedance 2.0 Fast • Tworzenie zbiorów Seedance 2.0 Fast