Seedance 1.0 Pro API: Profesjonalny punkt końcowy generowania wideo

Jeśli budujesz wideo w produkt, przepływ pracy lub pipeline, interfejs webowy ostatecznie staje się wąskim gardłem. Seedance 1.0 Pro API to ten sam model co za interfejsem, udostępniony jako czyste REST endpoint z uwierzytelnianiem bearer-token, przewidywalnym cennikiem za sekundę i prostym pollingiem zadań. Ten przewodnik obejmuje wszystko, co musisz wiedzieć, aby wdrożyć go w produkcji.

Krótko mówiąc

• REST API do generowania natywnego wideo 1080p Seedance 1.0 Pro
• Autentykacja: bearer token z Twojego panel konta
• Rozliczenia: za sekundę na 0,24 dolara/s (0,12 dolara × 2x marża)
• Schemat: prześlij zadanie → sprawdź status → pobierz MP4
• Najlepsze dla: integracji SaaS, pipeline'ów wsadowych, automatyzacji, produktów white-label

Co API daje ci

Wszystko, co oferuje interfejs webowy Seedance 1.0 Pro, dostępne programowo:

• Generowanie wideo z obrazu ze źródłowym adresem URL obrazu
• Monit ruchu do kierowania animacją
• Kontrola czasu trwania od 2 do 12 sekund
• Kontrola końcowej klatki dla kierowanych przejść
• Blokada kamery przełącznik
• Polling zadań dla statusu i adresu URL wyniku
• Wyjście MP4 w natywnym formacie 1080p

Używaj go dla produktów SaaS wymagających wbudowanego generowania wideo, wewnętrznych pipeline'ów agencji, przepływów pracy produkcji wsadowej lub automatyzacji powtarzających się zadań wideo.

Uwierzytelnianie

Wszystkie połączenia API uwierzytelniane są za pomocą bearer token. Wygeneruj go ze swojego pulpitu konta Arteza na arteza.ai.

Authorization: Bearer YOUR_API_KEY

Reguły bezpieczeństwa:

• Nigdy nie zatwierdzaj kluczy API do kontroli źródła
• Regularnie obracaj kluczami
• Używaj zmiennych środowiskowych lub menedżera tajnych
• W miarę możliwości ograniczaj klucze do określonych źródeł

Główne Endpoints

Prześlij zadanie generowania

POST /v1/seedance-1-pro/generate

Treść żądania:

{
  "source_image_url": "https://your-cdn.com/source.jpg",
  "prompt": "Slow camera push-in on the subject, warm golden hour light, shallow depth of field",
  "duration_seconds": 6,
  "camera_lock": false,
  "end_frame_url": null
}

Parametry:

Odpowiedź:

{
  "job_id": "job_abc123xyz",
  "status": "queued",
  "created_at": "2026-04-10T12:00:00Z",
  "estimated_seconds": 90
}

Sprawdź status zadania

GET /v1/seedance-1-pro/status/{job_id}

Odpowiedź (w trakcie):

{
  "job_id": "job_abc123xyz",
  "status": "processing",
  "progress": 0.45,
  "created_at": "2026-04-10T12:00:00Z"
}

Odpowiedź (ukończone):

{
  "job_id": "job_abc123xyz",
  "status": "completed",
  "video_url": "https://arteza.ai/videos/abc123xyz.mp4",
  "duration_seconds": 6,
  "resolution": "1920x1080",
  "credits_charged": 144
}

Możliwe wartości statusu: queued, processing, completed, failed

Pobierz wynik

Gdy status to completed, video_url wskazuje na plik MP4 1080p. Pobierz go natychmiast i przechowuj we własnej infrastrukturze - nie polegaj na tym, że adres URL będzie ważny na zawsze.

Kompletny przykład Python

import os
import time
import requests

API_KEY = os.environ["SEEDANCE_API_KEY"]
BASE_URL = "https://api.arteza.ai/v1/seedance-1-pro"
HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

def generate_video(source_image_url, prompt, duration=6, camera_lock=False, end_frame=None):
    payload = {
        "source_image_url": source_image_url,
        "prompt": prompt,
        "duration_seconds": duration,
        "camera_lock": camera_lock,
    }
    if end_frame:
        payload["end_frame_url"] = end_frame
    
    response = requests.post(f"{BASE_URL}/generate", headers=HEADERS, json=payload)
    response.raise_for_status()
    return response.json()["job_id"]

def wait_for_completion(job_id, poll_interval=5, timeout=300):
    start = time.time()
    while time.time() - start < timeout:
        r = requests.get(f"{BASE_URL}/status/{job_id}", headers=HEADERS)
        r.raise_for_status()
        data = r.json()
        
        if data["status"] == "completed":
            return data["video_url"]
        if data["status"] == "failed":
            raise RuntimeError(f"Job failed: {data.get('error', 'unknown')}")
        
        time.sleep(poll_interval)
    
    raise TimeoutError(f"Job {job_id} did not complete within {timeout}s")

def download_video(url, output_path):
    response = requests.get(url, stream=True)
    response.raise_for_status()
    with open(output_path, "wb") as f:
        for chunk in response.iter_content(chunk_size=8192):
            f.write(chunk)

# Użyj tego
job_id = generate_video(
    source_image_url="https://example.com/product.jpg",
    prompt="Slow camera orbit around the product, studio lighting, 6 seconds",
    duration=6,
    camera_lock=True
)

video_url = wait_for_completion(job_id)
download_video(video_url, "output.mp4")
print(f"Video saved to output.mp4")

Kompletny przykład Node.js

import fs from 'fs';
import fetch from 'node-fetch';

const API_KEY = process.env.SEEDANCE_API_KEY;
const BASE_URL = 'https://api.arteza.ai/v1/seedance-1-pro';
const HEADERS = {
  'Authorization': `Bearer ${API_KEY}`,
  'Content-Type': 'application/json'
};

async function generateVideo(opts) {
  const response = await fetch(`${BASE_URL}/generate`, {
    method: 'POST',
    headers: HEADERS,
    body: JSON.stringify(opts)
  });
  if (!response.ok) throw new Error(`HTTP ${response.status}`);
  const data = await response.json();
  return data.job_id;
}

async function waitForCompletion(jobId, { pollInterval = 5000, timeout = 300000 } = {}) {
  const start = Date.now();
  while (Date.now() - start < timeout) {
    const r = await fetch(`${BASE_URL}/status/${jobId}`, { headers: HEADERS });
    const data = await r.json();
    if (data.status === 'completed') return data.video_url;
    if (data.status === 'failed') throw new Error(`Job failed: ${data.error}`);
    await new Promise(res => setTimeout(res, pollInterval));
  }
  throw new Error('Timeout');
}

async function downloadVideo(url, path) {
  const response = await fetch(url);
  const buffer = await response.buffer();
  fs.writeFileSync(path, buffer);
}

// Użyj tego
const jobId = await generateVideo({
  source_image_url: 'https://example.com/product.jpg',
  prompt: 'Slow camera orbit around the product, studio lighting, 6 seconds',
  duration_seconds: 6,
  camera_lock: true
});

const videoUrl = await waitForCompletion(jobId);
await downloadVideo(videoUrl, 'output.mp4');
console.log('Saved output.mp4');

Chcesz jakość transmisji jak ta? Spróbuj Seedance 1.0 Pro za darmo →

Ceny i rozliczenia

Stawka: 0,24 dolara za sekundę wyjściowego wideo (24 kredyty/sekundę)

Kredyty są odliczane tylko przy pomyślnych generowaniach. Nieudane zadania nie zużywają kredytów.

Pakiety kredytów są takie same jak interfejs webowy: 10 dolarów / 25 dolarów / 50 dolarów / 100 dolarów. Zobacz strona cennika.

Limity szybkości i równoczesność

Standardowe konta mają limity szybkości odpowiednie dla typowych obciążeń integracyjnych. Aby uzyskać wyższe limity w produkcji o dużej skali, skontaktuj się z pomocą techniczną.

Ogólne wytyczne:

• 5-10 równoczesnych zadań jest niezawodne dla większości kont
• Backoff wykładniczy dla odpowiedzi HTTP 429
• Ponowne próby na poziomie zadania dla przejściowych błędów (do 3 prób)
• Wywołania zwrotne Webhook są dostępne, aby uniknąć nadmiernego poolingu

Webhooks (opcjonalnie)

Zamiast pollingowania, zarejestruj adres URL webhooka w ustawieniach konta lub na żądanie. Po ukończeniu zadania Arteza wysyła POST do Twojego adresu URL:

{
  "event": "job.completed",
  "job_id": "job_abc123xyz",
  "status": "completed",
  "video_url": "https://arteza.ai/videos/abc123xyz.mp4",
  "duration_seconds": 6,
  "credits_charged": 144,
  "timestamp": "2026-04-10T12:02:15Z"
}

Webhooks są podpisane podpisem HMAC w nagłówku X-Seedance-Signature. Przed zaufaniem ładunkowi zweryfikuj.

Obsługa błędów

API zwraca standardowe kody statusu HTTP:

Treści odpowiedzi na błąd zawierają pole error z komunikatem zrozumiałym dla człowieka i pole code do programowej obsługi.

{
  "error": "Source image URL could not be fetched",
  "code": "source_image_unreachable"
}

Wymagania dotyczące obrazu wejściowego

• Formaty: PNG, JPEG, WebP
• Rozmiar: do 10 MB na obraz
• Rozdzielczość: minimum 512x512, wyższa jest lepsza (zalecane 1080p+)
• Dostęp do adresu URL: musi być publicznie dostępny dla serwerów Arteza (bez localhost, bez walled auth)

W przypadku prywatnych obrazów prześlij je na podpisany adres URL S3, CloudFront lub podobny i przekaż podpisany adres URL w żądaniu.

Najlepsze praktyki

1. Przechowuj wyjścia we własnej infrastrukturze. Nie polegaj na adresach URL Arteza na długo.
2. Zaloguj wszystko. Identyfikatory zadań, monity, czasy, przejścia statusu, błędy.
3. Ponów przejściowe błędy. Problemy sieciowe i odpowiedzi 5xx powinny ponowić backoff wykładniczy.
4. Waliduj wejścia wcześnie. Sprawdź adresy URL obrazów i zakresy parametrów przed przesłaniem.
5. Monitoruj saldo kredytów. Alert gdy spadniesz poniżej progu.
6. Używaj webhooks w produkcji. Polling jest w porządku dla małych obciążeń, ale nieefektywny w dużej skali.
7. Buforuj identyczne generowania. Jeśli użytkownik wyśle ten sam obraz + monit dwa razy, zwróć buforowany adres URL.

Testowanie i przygotowanie

Rozpocznij każdą integrację z pakietem kredytów 10 dolarów (1050 kredytów). To wystarczy na kilkadziesiąt testowych generacji. Zbuduj i przetestuj swoją integrację od końca do końca przed zatwierdzeniem wyższych pakietów.

Przypadki użycia

• Platformy SaaS - pozwól użytkownikom generować wideo z ich własnych zasobów
• E-commerce - generuj wideo ruchu produktu z obrazów katalogu
• Nieruchomości - zautomatyzuj produkcję wideo aukcji ze zdjęć
• Automatyzacja marketingu - sparsonalizowane wideo w dużej skali
• Platformy treści - wzbogacaj artykuły, aukcje lub posty społeczne wygenerowanym wideo
• Narzędzia wideo white-label - zbuduj swój własny produkt wideo AI na backendu Arteza

Powiązane czytanie

• Przepływy przetwarzania wsadowego
• Kompleksowy przewodnik Seedance 1.0 Pro
• Seedance 1.0 Pro dla agencji
• Przewodnik API Seedance 2.0

FAQ

Czy mogę używać API dla aplikacji komercyjnych? Tak, wszystkie wyjścia są zatwierdzone do użytku komercyjnego.

Co się dzieje, jeśli generowanie się nie powiedzie? Brak poboru kredytów przy nieudanych generowaniach.

Jak długo wygenerowane wideo jest hostowane? Wideo są dostępne do pobrania przez okres czasu po generowaniu. Pobierz i przechowuj szybko.

Czy obsługujesz biblioteki SDK? Społeczne SDK dla Python i Node są dostępne. Zobacz dokumenty dla deweloperów na arteza.ai.

Czy mogę anulować zadanie w trakcie? Tak, wyślij DELETE /v1/seedance-1-pro/jobs/{job_id}. Kredyty nie są pobierane przy anulowanych zadaniach.

Jak uzyskać pomoc? Wyślij e-mail do pomocy technicznej za pośrednictwem pulpitu konta w celu uzyskania problemów specyficznych dla API.

---

Seedance 1.0 Pro API to gotowa do produkcji ścieżka do wbudowania generowania wideo AI 1080p w Twój produkt lub pipeline.

Zdobądź swój klucz API i zacznij budować → z 50 bezpłatnymi kredytami dołączonymi do rejestracji.