Seedance 1.0 Lite API: Szybkie generowanie wideo za pomocą endpointa

Jedno żądanie POST, czekaj 30-60 sekund, a otrzymujesz film MP4 w rozdzielczości 1080p. To całe API Seedance 1.0 Lite. Dla deweloperów budujących zautomatyzowane przepływy pracy wideo - czy to animacje produktów e-commerce, potoki kreatywne dla reklam, czy systemy generowania treści - to jest przewodnik integracyjny.

STRESZCZENIE

• Jeden endpoint POST przyjmuje obraz + prompt ruchu, zwraca film MP4 w 1080p
• Model asynchronicznej pracy: wyślij żądanie, sprawdzaj zakończenie, pobierz wynik
• Koszt na jedno wywołanie: $0.14-$0.84 w zależności od czasu trwania (2-12 sekund)
• Typowe opóźnienie end-to-end: 30-60 sekund
• 50 bezpłatnych kredytów przy rejestracji - wystarczy, aby sprawdzić integrację przed zaangażowaniem
• Sama pula kredytów działa na wszystkich modelach Arteza i Seedream

Dlaczego deweloperzy integrują API

Wersja UI Seedance 1.0 Lite jest świetna do generowania ręcznego. API odblokowuje przepływy pracy, które użycie ręczne nie może obsługiwać:

• Zautomatyzowana animacja katalogów - wyzwól generowanie dla każdego nowego SKU dodanego do backendu e-commerce
• Potoki kreatywne dla reklam - generuj warianty zgodnie z harmonogramem, prześlij na platformy reklamowe przez ich API
• Systemy generowania treści - zasilaj obrazy z CMS do Arteza i odbierz wersje animowane
• Przepływy pracy generowane w czasie rzeczywistym przez użytkowników - pozwól użytkownikom załadować obraz i uzyskać wersję animowaną
• Zadania wsadowe - przetwarzaj setki obrazów źródłowych przez noc

Za $0.14-$0.84 za wywołanie i 30-60 sekund czasu oczekiwania, możesz zbudować automatyzację wideo na poziomie produkcji, która byłaby ekonomicznie niemożliwa 18 miesięcy temu.

Uzyskiwanie dostępu do API

1. Zarejestruj się na platformę - 50 bezpłatnych kredytów pojawi się natychmiast
2. Przejdź do ustawień API w swoim panelu
3. Wygeneruj klucz API - przechowuj go bezpiecznie (nigdy nie zatwierdzaj do git)
4. Opcjonalnie: Kup pakiet kredytów na stronę cennika - $10, $25, $50 lub $100

Twoje 50 bezpłatnych kredytów działa również dla wywołań API. Możesz sprawdzić pełną integrację przed zapłaceniem czegokolwiek.

Model żądania

Podstawowa interakcja to jedno żądanie POST do endpointu generowania Seedance 1.0 Lite.

Parametry wymagane

Parametry opcjonalne

Model odpowiedzi

API zwraca ID zadania i status. Generowanie jest asynchroniczne - sprawdzaj zakończenie lub używaj webhoka.

{
  "job_id": "sd1lite_abc123xyz",
  "status": "processing",
  "credits_charged": 42,
  "estimated_time_seconds": 45,
  "created_at": "2026-04-10T12:00:00Z"
}

Gdy ukończone:

{
  "job_id": "sd1lite_abc123xyz",
  "status": "completed",
  "video_url": "https://cdn.arteza.ai/...",
  "duration_seconds": 6,
  "resolution": "1080p",
  "credits_charged": 42,
  "completed_at": "2026-04-10T12:00:45Z"
}

Uwierzytelnianie

Wszystkie żądania używają uwierzytelniania tokenu nośnika przez nagłówek Authorization:

Authorization: Bearer YOUR_API_KEY

Klucze API są powiązane z Twoim kontem i obciążają Twoje saldo kredytów. Obróć klucze przez panel, jeśli podejrzewasz wyciek.

Przykład kodu: Python

Oto minimalna integracja w Pythonie, która przesyła zadanie, sprawdza zakończenie i pobiera wynik.

import requests
import time
import os

API_KEY = os.environ["SEEDANCE_API_KEY"]
BASE_URL = "https://api.arteza.ai/v1"

def generate_video(image_url, prompt, duration=6, aspect="9:16"):
    # Submit the job
    response = requests.post(
        f"{BASE_URL}/seedance-1-lite/generate",
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={
            "image": image_url,
            "prompt": prompt,
            "duration": duration,
            "resolution": "1080p",
            "aspect_ratio": aspect,
            "camera_lock": True,
        },
    )
    job = response.json()
    job_id = job["job_id"]
    
    # Poll for completion
    while True:
        status_response = requests.get(
            f"{BASE_URL}/jobs/{job_id}",
            headers={"Authorization": f"Bearer {API_KEY}"},
        )
        status = status_response.json()
        if status["status"] == "completed":
            return status["video_url"]
        if status["status"] == "failed":
            raise Exception(f"Generation failed: {status.get('error')}")
        time.sleep(5)

video_url = generate_video(
    image_url="https://example.com/product.jpg",
    prompt="Product rotates smoothly, highlights catch across the surface, camera completely locked",
    duration=6,
    aspect="1:1",
)
print(f"Video ready: {video_url}")

Przykład kodu: Node.js

const axios = require('axios');

const API_KEY = process.env.SEEDANCE_API_KEY;
const BASE_URL = 'https://api.arteza.ai/v1';

async function generateVideo(imageUrl, prompt, duration = 6, aspect = '9:16') {
  // Submit the job
  const { data: job } = await axios.post(
    `${BASE_URL}/seedance-1-lite/generate`,
    {
      image: imageUrl,
      prompt,
      duration,
      resolution: '1080p',
      aspect_ratio: aspect,
      camera_lock: true,
    },
    {
      headers: { Authorization: `Bearer ${API_KEY}` },
    }
  );

  // Poll for completion
  while (true) {
    const { data: status } = await axios.get(
      `${BASE_URL}/jobs/${job.job_id}`,
      { headers: { Authorization: `Bearer ${API_KEY}` } }
    );

    if (status.status === 'completed') return status.video_url;
    if (status.status === 'failed') throw new Error(status.error);

    await new Promise((r) => setTimeout(r, 5000));
  }
}

generateVideo(
  'https://example.com/product.jpg',
  'Product rotates smoothly, highlights catch across the surface, camera completely locked',
  6,
  '1:1'
).then((url) => console.log('Video ready:', url));

Wzór Webhooka (Rekomendowany dla produkcji)

Sprawdzanie działa, ale webhooki są czystsze na dużą skalę. Przekaż webhook_url w swoim żądaniu generowania, a API POSTnie ładunek zakończenia, gdy zadanie będzie gotowe.

response = requests.post(
    f"{BASE_URL}/seedance-1-lite/generate",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "image": image_url,
        "prompt": prompt,
        "duration": 6,
        "webhook_url": "https://your-app.com/webhooks/seedance",
    },
)

Twój obserwator webhooka otrzymuje ten sam JSON zakończenia co endpoint sprawdzania. Nie wymaga pętli sprawdzania.

Chcesz to zrobić sam? Spróbuj Seedance 1.0 Lite za darmo →

Gotów spróbować Seedance 1.0 Lite? Zacznij tworzyć za darmo →

Ograniczenia szybkości i współbieżność

Aby uzyskać wyższą współbieżność lub wolumen, skontaktuj się z pomocą. Platforma może obsługiwać wsadowe obciążenia pracą 10,000+ zadań/dzień na dedykowanych konfiguracjach.

Obsługa błędów

Standardowe kody statusu HTTP mają zastosowanie:

Dla integracji produkcyjnych zawsze wdrażaj:

• Wykładnicze wycofywanie dla błędów 429 i 500
• Sprawdzanie salda kredytów przed dużymi uruchomieniami wsadowymi
• Walidację podpisu webhooka jeśli używasz webhooków
• Klucze idempotencji aby zapobiec zduplikowanym opłatom przy błędach sieci

Zarządzanie kosztami w produkcji

Każde wywołanie obciąża kredyty w standardowej stawce: 7 kredytów na sekundę wideo.

Porady do kontroli kosztów w produkcji:

• Testuj prompty na 2 sekundach przed zaangażowaniem się w uruchomienia wsadowe 12-sekundowe
• Ustaw miesięczny budżet kredytów i niech Twój kod się zatrzyma, gdy zostanie osiągnięty
• Monitoruj pole credits_charged w każdej odpowiedzi, aby śledzić wydatki na przepływ pracy
• Używaj webhooków aby uniknąć marnowania czasu na sprawdzaniu
• Buforuj udane wyniki gdy to możliwe, aby identyczne żądania nie regenerowały

Rzeczywiste wzory integracji

Animacja katalogów e-commerce

Wyzwól zadanie Seedance 1.0 Lite za każdym razem, gdy do katalogu zostanie dodany nowy SKU. Napisz wynikowy adres URL MP4 do bazy danych produktów. Wyświetl na stronach produktów automatycznie.

Potok kreatywny dla reklam

Codzienne zadanie cron generuje 10 nowych wariantów reklam z różnych obrazów źródłowych. Prześlij filmy MP4 bezpośrednio do Meta Ads API jako nowe kreatywne. Zamknij pętlę między generowaniem treści a dostarczaniem reklam.

Aplikacje treści generowanej przez użytkowników

Pozwól użytkownikom załadować zdjęcie w Twojej aplikacji. Twój backend wywołuje Seedance 1.0 Lite z szablonowym promptem. Zwróć wersję animowaną użytkownikowi w mniej niż minutę. Obciąż użytkowników wystarczająco, aby pokryć koszt API ~$0.30 ze zdowym marginesem.

Ulepszenie CMS

Podłącz się do CMS, aby każdy nowy obraz polecany automatycznie otrzymał wygenerowaną wersję Seedance 1.0 Lite. Przechowuj obie wersje: statyczną do powrotu, animowaną do umieszczenia bohaterskiego.

Odświeżenie katalogów wsadowych

Zadanie nocne regeneruje wersje animowane Twoich 500 najlepszych produktów z sezonowymi promptami ruchu. Świeża kreatywność bez interwencji człowieka.

Uaktualnianie do Pro lub 2.0 przez API

Gdy konkretne zadanie wymaga jakości premium, przełącz endpointy:

• /seedance-1-lite/generate - $0.14-$0.84, szybkie, główna siła do dużych wolumenów
• /seedance-1-pro/generate - $0.48-$2.88, premium ruchu, kontrola klatki końcowej
• /seedance-2.0/generate - $2.43-$9.10, jakość kina + natywny dźwięk

Ten sam klucz API, ta sama pula kredytów, ta sama autoryzacja. Przełączaj modele, wywołując inny endpoint. Sprawdź przewodnik porównawczy Pro aby dowiedzieć się kiedy uaktualnić.

Zacznij integrować dzisiaj

Zarejestruj się, weź swój klucz API z panelu i wykonaj swoje pierwsze wywołanie z 50 bezpłatnymi kredytami. Przykład Python powyżej uruchamia się end-to-end w około 45 sekund i daje Ci działający wzór integracji do zbudowania.

Uzyskaj swój klucz API za darmo → - 50 kredytów przy rejestracji, bez wymagania karty, gotowa do produkcji integracja w poniżej godziny.