Seedance 1.0 Lite API: szybki endpoint do generowania wideo

Jedno żądanie POST, 30-60 sekund oczekiwania i otrzymujesz plik MP4 w rozdzielczości 1080p. Na tym polega cały interfejs API Seedance 1.0 Lite. Dla programistów budujących zautomatyzowane przepływy pracy z wideo - czy to animacje produktów w e-commerce, potoki kreacji reklamowych czy systemy generowania treści - jest to przewodnik integracji.

Dlaczego programiści integrują API

Wersja UI Seedance 1.0 Lite świetnie sprawdza się przy ręcznym generowaniu. API odblokowuje przepływy pracy, których ręczne użytkowanie nie jest w stanie obsłużyć:

• Automatyczna animacja katalogu - wyzwalaj generowanie dla każdego nowego SKU dodanego do backendu e-commerce
• Potoki kreacji reklamowych - generuj warianty według harmonogramu i publikuj je na platformach reklamowych przez ich API
• Systemy generowania treści - przekazuj obrazy z CMS do Arteza i odbieraj ich animowane wersje
• Przepływy pracy generowane przez użytkowników w czasie rzeczywistym - pozwól własnym użytkownikom przesłać obraz i otrzymać jego animowaną wersję
• Zadania wsadowe - przetwarzaj setki obrazów źródłowych przez noc

Przy koszcie $0,20-$1,00 za wywołanie i czasie realizacji 30-60 sekund możesz budować produkcyjną automatyzację wideo, która jeszcze 18 miesięcy temu była ekonomicznie niemożliwa.

Uzyskanie dostępu do API

1. Zarejestruj się na platformę - 10 darmowych kredytów pojawia się natychmiast
2. Przejdź do ustawień API w panelu
3. Wygeneruj klucz API - przechowuj go bezpiecznie (nigdy nie umieszczaj w repozytorium git)
4. Opcjonalnie: Wybierz miesięczny plan na stronę z cenami - $5, $25, $50 lub $120

Twoje 10 darmowych kredytów działa również dla wywołań API. Możesz zweryfikować pełną integrację przed zapłaceniem czegokolwiek.

Model żądania

Podstawowa interakcja to pojedyncze żądanie POST do punktu końcowego generowania Seedance 1.0 Lite.

Wymagane parametry

Opcjonalne parametry

Model odpowiedzi

API zwraca identyfikator zadania i status. Generowanie jest asynchroniczne - sprawdzaj status lub użyj webhooka.

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

Po zakończeniu:

{
  "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 tokenem Bearer przez nagłówek Authorization:

Authorization: Bearer YOUR_API_KEY

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

Przykład kodu: Python

Oto minimalna integracja w Pythonie, która przesyła zadanie, sprawdza jego status 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"):
    # Wyślij zadanie
    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"]
    
    # Sprawdzaj status do zakończenia
    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"Generowanie nie powiodło się: {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"Wideo gotowe: {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') {
  // Wyślij zadanie
  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}` },
    }
  );

  // Sprawdzaj status do zakończenia
  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('Wideo gotowe:', url));

Wzorzec webhook (zalecany do produkcji)

Odpytywanie działa, ale webhooki są bardziej eleganckim rozwiązaniem w dużej skali. Przekaż webhook_url w żądaniu generowania, a API wyśle payload z informacją o zakończeniu, gdy zadanie dobiegnie końca.

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 handler webhooka otrzymuje ten sam JSON zakończenia co endpoint odpytywania. Żadna pętla odpytywania nie jest wymagana.

Chcesz zrobić to samodzielnie? Wypróbuj Seedance 1.0 Lite za darmo →

Gotowy, żeby wypróbować Seedance 1.0 Lite? Zacznij tworzyć za darmo →

Limity żądań i współbieżność

W przypadku wyższej współbieżności lub wolumenu skontaktuj się z pomocą techniczną. Platforma może obsługiwać zadania wsadowe o wolumenie ponad 10 000 zadań dziennie przy dedykowanych konfiguracjach.

Obsługa błędów

Obowiązują standardowe kody statusu HTTP:

W przypadku integracji produkcyjnych zawsze implementuj:

• Wykładnicze opóźnienie dla błędów 429 i 500
• Sprawdzanie salda kredytów przed dużymi zadaniami wsadowymi
• Weryfikację podpisu webhooka jeśli używasz webhooków
• Klucze idempotentności aby zapobiec podwójnym obciążeniom przy błędach sieciowych

Zarządzanie kosztami w produkcji

Każde wywołanie obciąża kredyty według czasu trwania: 2 kredyty za klip 2-3 sekundowy, rosnąc do 7 kredytów przy 12 sekundach.

Wskazówki dotyczące kontroli kosztów w produkcji:

• Testuj prompty przy 2 sekundach przed realizacją 12-sekundowych zadań wsadowych
• Ustaw miesięczny budżet kredytów i zatrzymaj kod, 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 odpytywanie
• Buforuj udane wyniki, gdy to możliwe, aby identyczne żądania nie były ponownie generowane

Praktyczne wzorce integracji

Animacja katalogu e-commerce

Wyzwalaj zadanie Seedance 1.0 Lite za każdym razem, gdy do katalogu zostanie dodany nowy SKU. Zapisuj wynikowy adres URL pliku MP4 w bazie danych produktów. Wyświetlaj go automatycznie na stronach szczegółów produktu.

Potok kreacji reklamowych

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

Aplikacje z treściami generowanymi przez użytkowników

Pozwól użytkownikom przesłać zdjęcie w Twojej aplikacji. Twój backend wywołuje Seedance 1.0 Lite z szablonowym promptem. Zwróć animowaną wersję użytkownikowi w czasie krótszym niż minuta. Pobieraj od użytkowników wystarczającą opłatę, aby pokryć koszt API ~$0.20 ze zdrową marżą.

Wzbogacanie CMS

Podepnij się do swojego CMS tak, aby każdy nowy obraz wyróżniający automatycznie otrzymywał wygenerowaną animowaną wersję Seedance 1.0 Lite. Przechowuj obie wersje - statyczną jako zapasową i animowaną do umieszczania na głównych miejscach.

Wsadowe odświeżanie katalogu

Nocne zadanie regeneruje animowane wersje 500 najlepszych produktów z sezonowymi promptami ruchu. Świeże kreacje bez ludzkiej interwencji.

Przejście na Pro lub 2.0 przez API

Gdy konkretne zadanie wymaga najwyższej jakości, zmień endpoint:

• /seedance-1-lite/generate - $0,20-$1,00, szybki, roboczy koń do dużych wolumenów
• /seedance-1-pro/generate - $0,20-$1,00, premium ruch, kontrola ostatniej klatki
• /seedance-2.0/generate - $1.20-$4.40, jakość kinowa i natywne audio

Ten sam klucz API, ta sama pula kredytów, to samo uwierzytelnianie. Zmieniaj modele, wywołując inny endpoint. Zobacz przewodnik porównawczy Pro, kiedy warto się uaktualnić.

Zacznij integrację już dziś

Zarejestruj się, pobierz klucz API z panelu i wykonaj pierwsze wywołanie z 10 darmowymi kredytami. Przykład w Pythonie powyżej działa end-to-end w około 45 sekund i daje gotowy wzorzec integracji do dalszego rozwijania.

Uzyskaj klucz API za darmo → - 10 kredytów przy rejestracji, bez karty kredytowej, gotowa do produkcji integracja w mniej niż godzinę.