SeeDance Videos Generation API Integracja Opis

Dokument ten przedstawia sposób integracji z SeeDance Videos Generation API, które umożliwia generowanie oficjalnych filmów SeeDance poprzez wprowadzenie niestandardowych parametrów.

Proces aplikacji

Aby skorzystać z API, należy najpierw przejść do strony SeeDance Videos Generation API i złożyć wniosek o odpowiednią usługę. Po wejściu na stronę, kliknij przycisk „Acquire”, jak pokazano na obrazku:

Jeśli nie jesteś zalogowany lub zarejestrowany, automatycznie zostaniesz przekierowany na stronę logowania, aby zarejestrować się i zalogować. Po zalogowaniu lub rejestracji automatycznie wrócisz na bieżącą stronę. Podczas pierwszej aplikacji otrzymasz darmowy limit, który pozwala na bezpłatne korzystanie z tego API.

Podstawowe użycie

Najpierw zapoznaj się z podstawowym sposobem użycia, czyli wprowadzeniem słów kluczowych content.text, typu content.type=text oraz modelu model, aby uzyskać przetworzony wynik. Szczegóły są następujące:

Możemy zobaczyć, że ustawiliśmy nagłówki żądania, w tym:

accept: format odpowiedzi, który chcemy otrzymać, tutaj wpisujemy application/json, czyli format JSON.
authorization: klucz do wywołania API, który można wybrać z rozwijanej listy po złożeniu wniosku.

Dodatkowo ustawiono ciało żądania, w tym:

model: model generujący wideo, dostępne wartości: doubao-seedance-1-0-pro-250528, doubao-seedance-1-0-pro-fast-251015, doubao-seedance-1-5-pro-251215, doubao-seedance-1-0-lite-t2v-250428, doubao-seedance-1-0-lite-i2v-250428.
content: tablica wprowadzonych treści, type może być text lub image_url.
resolution: rozdzielczość wyjściowa, dostępne opcje 480p / 720p / 1080p.
ratio: proporcje, dostępne opcje 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive.
duration: długość wideo (sekundy), zakres 2–12.
seed: losowe ziarno, liczba całkowita, -1 do 4294967295.
camerafixed: czy kamera jest stała, true / false.
watermark: czy dodać znak wodny, true / false.
generate_audio: czy generować wideo z dźwiękiem, true / false, tylko doubao-seedance-1-5-pro-251215 wspiera.
service_tier: tryb wnioskowania, default (online) lub flex (offline, cena 50% ceny online).
return_last_frame: czy w wynikach zwrócić URL ostatniej klatki wideo.
execution_expires_after: czas wygaśnięcia zadania (sekundy), zakres 3600–259200.
callback_url: adres asynchronicznego wywołania zwrotnego, po ustawieniu API natychmiast zwraca task_id, a po zakończeniu zadania wynik zostanie przesłany na ten adres.

Po dokonaniu wyboru, można zauważyć, że po prawej stronie wygenerowano odpowiedni kod, jak pokazano na obrazku:

Kliknij przycisk „Try”, aby przeprowadzić test, jak pokazano na powyższym obrazku, a otrzymamy następujący wynik:

{
  "success": true,
  "task_id": "ec22ae22-0140-4033-8c86-a48b536da595",
  "trace_id": "1cc87db0-8ee5-4436-969b-35cc571a9fd5",
  "data": {
    "task_id": "cgt-20251222005129-62fhb",
    "status": "succeeded",
    "video_url": "https://platform.cdn.xhuoapi.ai/seedance/f592800a-b87c-4705-8796-cbb8018cae35.mp4",
    "model": "doubao-seedance-1-0-pro-250528"
  }
}

Wynik zwrotny zawiera wiele pól, które są opisane poniżej:

success, status zadania generowania wideo.
task_id, ID zadania generowania wideo.
trace_id, ID śledzenia generowania wideo.
data, lista wyników zadania generowania wideo.
- task_id, ID serwera zadania generowania wideo.
- video_url, link do wideo z zadania generowania wideo.
- status, status zadania generowania wideo.
  - model, model użyty do generowania wideo.

Możemy zobaczyć, że otrzymaliśmy satysfakcjonujące informacje o wideo, wystarczy, że na podstawie adresu URL wideo w data uzyskamy wygenerowane wideo SeeDance. Dodatkowo, jeśli chcesz wygenerować odpowiedni kod integracyjny, możesz go bezpośrednio skopiować, na przykład kod CURL wygląda następująco:

curl -X POST 'https://api.xhuoapi.ai/v1/seedance/videos' \
-H 'authorization: Bearer ${bearer_token}' \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-d '{
  "content": [{"text":"A kitten yawning at the camera. --rs 720p --rt 16:9 --dur 5 --fps 24 --wm true --seed 11 --cf false","type":"text"}],
  "model": "doubao-seedance-1-0-pro-250528"
}'

Opis parametrów inline

Na końcu słów kluczowych content[].text można przekazać parametry generowania w formie --parameter value (stara metoda, słaba walidacja, w przypadku błędnego wypełnienia automatycznie używane są wartości domyślne). Pełna lista parametrów jest następująca:

Parametr inline	Odpowiednie pole	Opis	Zakres wartości
`--rs`	`resolution`	Rozdzielczość wyjściowa	`480p` / `720p` / `1080p`
`--rt`	`ratio`	Proporcje	`16:9` / `4:3` / `1:1` / `3:4` / `9:16` / `21:9` / `adaptive`
`--dur`	`duration`	Długość wideo (sekundy)	2–12
`--frames`	`frames`	Liczba klatek wideo	Liczby całkowite spełniające 25+4n w zakresie [29, 289]
`--fps`	`framespersecond`	Liczba klatek na sekundę	Tylko `24`
`--seed`	`seed`	Losowe ziarno	-1 do 4294967295
`--cf`	`camerafixed`	Czy kamera jest stała	`true` / `false`
`--wm`	`watermark`	Czy dodać znak wodny	`true` / `false`

Zalecana praktyka: bezpośrednio w ciele żądania używaj odpowiednich pól najwyższego poziomu (takich jak resolution, ratio itp.), aby uzyskać tryb silnej walidacji, w przypadku błędnego wypełnienia parametrów zwróci wyraźny komunikat o błędzie, co ułatwia diagnozowanie problemów.

Generowanie wideo z dźwiękiem

doubao-seedance-1-5-pro-251215 wspiera generowanie wideo z dźwiękiem za pomocą parametru generate_audio:

{
  "model": "doubao-seedance-1-5-pro-251215",
  "content": [
    {
      "type": "text",
      "text": "A girl holds a fox, the wind blows her hair, you can hear the sound of the wind"
    }
  ],
  "generate_audio": true,
  "ratio": "16:9",
  "duration": 5
}

Inne modele nie obsługują tego parametru, po przekazaniu zostanie on zignorowany.

Generowanie wideo z obrazu - pierwsza klatka

Jeśli chcesz wygenerować wideo z obrazu, najpierw parametr content musi zawierać element z type równym image_url, a pole image_url musi być w formacie obiektowym: {"url": "https://..."} lub w formacie Base64 {"url": "data:image/png;base64,..."}.

Uwaga: image_url nie obsługuje bezpośredniego przekazywania w formacie string (np. "image_url": "https://..."), musi być użyty format obiektowy "image_url": {"url": "https://..."}, w przeciwnym razie zwróci błąd 400.

Odpowiedni kod:

import requests

url = "https://api.xhuoapi.ai/v1/seedance/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "content": [
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
            }
        },
        {
            "type": "text",
            "text": "Dziewczyna trzyma lisa w ramionach. Otwiera oczy i patrzy czule w kamerę, podczas gdy lis z czułością trzyma ją z powrotem. Gdy kamera powoli się oddala, jej włosy są delikatnie powiewane przez wiatr. --ratio adaptive  --dur 5"
        }
    ],
    "model": "doubao-seedance-1-0-pro-250528"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Klikając uruchom, można zauważyć, że natychmiast otrzymuje się wynik, jak poniżej:

{
    "success": true,
    "task_id": "dc7cceb5-3c12-4de7-a5f4-abcbba3e8e39",
    "trace_id": "b3b09de3-b7fa-4bb0-88b5-aad4b4a96fd4",
    "data": {
        "task_id": "cgt-20251222072003-x2259",
        "status": "succeeded",
        "video_url": "https://platform.cdn.xhuoapi.ai/seedance/6afb78b8-5ba8-424f-adcd-69423a700b50.mp4",
        "model": "doubao-seedance-1-0-pro-250528"
    }
}

Można zobaczyć, że wygenerowany efekt to wideo z obrazu, wynik jest podobny do powyższego.

Generowanie wideo z obrazu - pierwsza i ostatnia klatka

Jeśli chcesz wygenerować wideo z pierwszą i ostatnią klatką, najpierw parametr content musi zawierać typ image_url, a także należy ustawić role na first_frame i last_frame, aby określić następujące treści:

role: określa pierwszą lub ostatnią klatkę.
image_url
- url link do obrazu Równocześnie content musi również zawierać typ text jako prompt.

Odpowiedni kod:

import requests

url = "https://api.xhuoapi.ai/v1/seedance/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
   "model": "doubao-seedance-1-0-pro-250528",
    "content": [
         {
            "type": "text",
            "text": "Ujęcie 360 stopni"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg"
            },
            "role": "first_frame"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg"
            },
            "role": "last_frame"
        }
    ]
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Klikając uruchom, można zauważyć, że natychmiast otrzymuje się wynik, jak poniżej:

{
    "success": true,
    "task_id": "f7096c6c-9430-4392-8201-d259632d7afd",
    "trace_id": "4a4a3721-00fb-43d2-aff2-3b516ac01a8a",
    "data": {
        "task_id": "cgt-20251222073134-54qcw",
        "status": "succeeded",
        "video_url": "https://platform.cdn.xhuoapi.ai/seedance/95f9f5f0-fc50-4c71-bc6f-e154582c141e.mp4",
        "model": "doubao-seedance-1-0-pro-250528"
    }
}

Można zobaczyć, że wygenerowany efekt to wideo z postaciami, wynik jest podobny do powyższego.

Asynchroniczny callback

Ponieważ czas generowania wideo przez API SeeDance jest dość długi (około 1-2 minut), można użyć pola callback_url w trybie asynchronicznym, aby uniknąć długiego zajmowania połączenia HTTP. Cały proces: klient inicjuje żądanie, określając callback_url, API natychmiast zwraca odpowiedź zawierającą task_id; po zakończeniu zadania platforma wysyła wyniki w formacie POST JSON do callback_url, w wynikach również znajduje się task_id, aby umożliwić powiązanie.

{
  "task_id": "f7096c6c-9430-4392-8201-d259632d7afd"
}

Gdy zadanie zostanie zakończone, zawartość wysyłana do callback_url przez platformę wygląda następująco:

{
  "success": true,
  "task_id": "f7096c6c-9430-4392-8201-d259632d7afd",
  "trace_id": "4a4a3721-00fb-43d2-aff2-3b516ac01a8a",
  "data": {
    "task_id": "cgt-20251222073134-54qcw",
    "status": "succeeded",
    "video_url": "https://platform.cdn.xhuoapi.ai/seedance/95f9f5f0-fc50-4c71-bc6f-e154582c141e.mp4",
    "model": "doubao-seedance-1-0-pro-250528"
  }
}

Pole task_id w wynikach jest zgodne z tym, które zostało zwrócone podczas żądania, dzięki czemu można powiązać zadania.

Obsługa błędów

Podczas wywoływania API, jeśli wystąpią błędy, API zwróci odpowiedni kod błędu i informacje. Na przykład:

400 token_mismatched: Złe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
400 api_not_implemented: Złe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
401 invalid_token: Nieautoryzowany, nieprawidłowy lub brakujący token autoryzacyjny.
429 too_many_requests: Zbyt wiele żądań, przekroczono limit.
500 api_error: Błąd wewnętrzny serwera, coś poszło nie tak na serwerze.

Przykład odpowiedzi błędu

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Wnioski

Dzięki tej dokumentacji zrozumiałeś, jak korzystać z API generowania wideo SeeDance, aby generować wideo na podstawie wprowadzonych słów kluczowych oraz obrazów referencyjnych. Mamy nadzieję, że ta dokumentacja pomoże Ci lepiej zintegrować i korzystać z tego API. W razie jakichkolwiek pytań, prosimy o kontakt z naszym zespołem wsparcia technicznego.

Getting Started

Czat AI

Obraz AI

Wideo AI

Audio AI

Sieć i dane

CAPTCHA

Tożsamość

Proxy

Advanced

SeeDance Videos Generation API Integracja Opis

Proces aplikacji

Podstawowe użycie

Opis parametrów inline

Generowanie wideo z dźwiękiem

Generowanie wideo z obrazu - pierwsza klatka

Generowanie wideo z obrazu - pierwsza i ostatnia klatka

Asynchroniczny callback

Obsługa błędów

Przykład odpowiedzi błędu

Wnioski

​Proces aplikacji

​Podstawowe użycie

​Opis parametrów inline

​Generowanie wideo z dźwiękiem

​Generowanie wideo z obrazu - pierwsza klatka

​Generowanie wideo z obrazu - pierwsza i ostatnia klatka

​Asynchroniczny callback

​Obsługa błędów

​Przykład odpowiedzi błędu

​Wnioski

Proces aplikacji

Podstawowe użycie

Opis parametrów inline

Generowanie wideo z dźwiękiem

Generowanie wideo z obrazu - pierwsza klatka

Generowanie wideo z obrazu - pierwsza i ostatnia klatka

Asynchroniczny callback

Obsługa błędów

Przykład odpowiedzi błędu

Wnioski