Sora Videos Generation API Integracja

W artykule przedstawiono instrukcje dotyczące integracji z Sora Videos Generation API, za pomocą którego można wprowadzać niestandardowe parametry do generowania filmów oficjalnych Sora. API obsługuje dwa tryby wersji:

Wersja 1 (tryb klasyczny): obsługuje parametry duration (10/15/25 sekund), orientation (poziomo/pionowo), size (mała/duża jakość), referencyjne obrazy image_urls, link do ### character_url itp.
Wersja 2 (tryb partnera): obsługuje parametry seconds (4/8/12 sekund), rozdzielczość na poziomie pikseli size (np. 1280x720), referencyjne obrazy input_reference itp.

Proces aplikacji

Aby korzystać z Sora Videos Generation API, najpierw przejdź do konsoli Ace Data Cloud, aby uzyskać swój token API, który należy zachować na przyszłość.

Jeśli nie jesteś zalogowany lub zarejestrowany, automatycznie zostaniesz przekierowany na stronę logowania, aby zarejestrować się i zalogować, a po zakończeniu zostaniesz automatycznie przekierowany z powrotem na bieżącą stronę. Jeden token API wystarczy do wywołania wszystkich usług platformy, nie ma potrzeby składania osobnych wniosków dla każdej usługi. Przy pierwszym wniosku przyznawana jest darmowa kwota, aby można było skorzystać z bezpłatnej wersji; w przypadku niewystarczającego salda można doładować saldo ogólne w konsoli.

📘 Pełna dokumentacja: Sora Videos Generation API →

Podstawowe użycie (Wersja 1)

Najpierw zapoznaj się z podstawowym sposobem użycia Wersji 1, polegającym na wprowadzeniu słowa kluczowego prompt, tablicy linków do obrazów image_urls oraz modelu model, aby uzyskać przetworzony wynik, szczegóły są następujące:

Można zauważyć, ż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, po złożeniu wniosku można go bezpośrednio wybrać z rozwijanej listy.

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

model: model generujący wideo, obsługujący sora-2 (tryb standardowy) i sora-2-pro (tryb HD). Model sora-2-pro obsługuje wideo o długości 25 sekund, podczas gdy sora-2 obsługuje tylko 10 i 15 sekund.
size: jakość wideo, small to standardowa jakość, large to jakość HD (tylko Wersja 1).
duration: długość wideo, obsługująca 10, 15, 25 sekund, z czego 25 sekund obsługuje tylko sora-2-pro (tylko Wersja 1).
orientation: kierunek obrazu, obsługujący landscape (poziomo), portrait (pionowo) (tylko Wersja 1).
image_urls: tablica linków do obrazów referencyjnych, używana do generowania wideo (tylko Wersja 1).
character_url: link do ###, wideo nie może zawierać prawdziwych ludzi (tylko Wersja 1).
character_start/character_end: czas pojawienia się postaci, różnica w zakresie od 1 do 3 sekund (tylko Wersja 1).
prompt: słowo kluczowe (wymagane).
callback_url: URL do asynchronicznego zwrotu wyników.
async: opcjonalne, ustawione na true, interfejs natychmiast zwraca task_id, nie ma potrzeby podawania callback_url, a następnie można uzyskać wyniki, korzystając z odpowiedniego interfejsu zapytań o zadania.
version: wersja API, "1.0" (domyślnie) lub "2.0".

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

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

{
  "success": true,
  "task_id": "6bf7fb83-5814-4e3e-a4ad-bfa0c26c0b33",
  "trace_id": "96166698-4b66-478d-a26b-77a7269c9e01",
  "data": [
    {
      "id": "sora-2:task_01k7770rgsevxsmtpbn7xnm5gh",
      "video_url": "https://platform.cdn.acedata.cloud/gptimage/vg-assets/assets%2Ftask_01k7770rgsevxsmtpbn7xnm5gh%2Ftask_01k7770rgsevxsmtpbn7xnm5gh_genid_0bf958d3-cae7-4298-b7b6-99ae439a1ea6_25_10_10_14_06_975715%2Fvideos%2F00000%2Fsrc.mp4?st=2025-10-10T12%3A30%3A38Z&se=2025-10-16T13%3A30%3A38Z&sks=b&skt=2025-10-10T12%3A30%3A38Z&ske=2025-10-16T13%3A30%3A38Z&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skoid=8ebb0df1-a278-4e2e-9c20-f2d373479b3a&skv=2019-02-02&sv=2018-11-09&sr=b&sp=r&spr=https%2Chttp&sig=jigY6Z5qp8%2BTXYobaW0EAJ4%2Fbx6G7t6V1P0iyDeUq48%3D&az=oaivgprodscus",
      "state": "succeeded"
    }
  ]
}

Zwrócone wyniki zawierają wiele pól, które są opisane poniżej:

success, status zadania generowania wideo w danym momencie.
task_id, ID zadania generowania wideo w danym momencie.
trace_id, ID śledzenia generowania wideo w danym momencie.
data, lista wyników zadania generowania wideo w danym momencie.
- id, ID wideo zadania generowania wideo w danym momencie.
- video_url, link do wideo zadania generowania wideo w danym momencie.
- state, status zadania generowania wideo w danym momencie.

Można zauważyć, że uzyskaliśmy satysfakcjonujące informacje o wideo, wystarczy, że na podstawie adresu linku wideo w data uzyskamy wygenerowane wideo Sora. 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.acedata.cloud/sora/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "size": "large",
  "duration": 15,
  "orientation": "landscape",
  "prompt": "cat running on the river",
  "model": "sora-2"
}'

Zadanie generowania wideo z obrazów (Wersja 1)

Jeśli chcesz przeprowadzić zadanie generowania wideo z obrazów, najpierw parametr image_urls musi zawierać linki do referencyjnych obrazów, aby można było określić następujące treści:

image_urls: tablica linków do obrazów referencyjnych używanych w tym zadaniu generowania wideo. Należy pamiętać, aby nie przesyłać prawdziwych obrazów z postaciami z twarzami, ponieważ może to spowodować niepowodzenie zadania.

Przykład wypełnienia jest następujący:

Po wypełnieniu automatycznie wygenerowano kod, jak pokazano poniżej:

Odpowiedni kod:

import requests

url = "https://api.acedata.cloud/sora/videos"

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

payload = {
    "size": "large",
    "duration": 15,
    "orientation": "landscape",
    "prompt": "kot biegający nad rzeką",
    "model": "sora-2",
    "image_urls": ["https://cdn.acedata.cloud/11wfp4.png"]
}

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

Kliknij uruchom, a natychmiast otrzymasz wynik, jak poniżej:

{
  "success": true,
  "task_id": "dd392ff0-dcb7-4c7a-afd0-9bd4f65c803a",
  "trace_id": "04fd151c-e942-4c1c-a6ab-9a1b1fe54172",
  "data": [
    {
      "id": "sora-2:task_01k777af4hfmg9g7yfvwsc6zws",
      "video_url": "https://platform.cdn.acedata.cloud/gptimage/vg-assets/assets%2Ftask_01k777af4hfmg9g7yfvwsc6zws%2Ftask_01k777af4hfmg9g7yfvwsc6zws_genid_92bae0c5-1703-4a5f-9d9f-c9ed2f9e7176_25_10_10_14_12_924695%2Fvideos%2F00000%2Fsrc.mp4?st=2025-10-10T12%3A37%3A32Z&se=2025-10-16T13%3A37%3A32Z&sks=b&skt=2025-10-10T12%3A37%3A32Z&ske=2025-10-16T13%3A37%3A32Z&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skoid=aa5ddad1-c91a-4f0a-9aca-e20682cc8969&skv=2019-02-02&sv=2018-11-09&sr=b&sp=r&spr=https%2Chttp&sig=5j4dibeaSsDmEka5c%2B9CKHZhRPdqfClQ0tIh03TWXsM%3D&az=oaivgprodscus",
      "state": "succeeded"
    }
  ]
}

Można zauważyć, że wygenerowany efekt to wideo stworzone na podstawie obrazu, a wynik jest podobny do powyższego.

Zadanie generowania wideo z postacią (Wersja 1)

Jeśli chcesz przeprowadzić zadanie generowania wideo z postacią, najpierw parametr character_url musi zawierać link do wideo potrzebnego do stworzenia postaci, pamiętaj, że w wideo nie mogą pojawiać się prawdziwe osoby, w przeciwnym razie operacja zakończy się niepowodzeniem, można określić następujące treści:

character_url: link do wideo potrzebnego do stworzenia postaci, pamiętaj, że w wideo nie mogą pojawiać się prawdziwe osoby, w przeciwnym razie operacja zakończy się niepowodzeniem.

Przykład wypełnienia poniżej:

Po wypełnieniu automatycznie wygenerowano poniższy kod:

Odpowiedni kod:

import requests

url = "https://api.acedata.cloud/sora/videos"

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

payload = {
    "size": "small",
    "duration": 10,
    "orientation": "landscape",
    "prompt": "kot biegający nad rzeką",
    "character_url": "https://cdn.acedata.cloud/pdidf5.mp4",
    "model": "sora-2",
    "character_end": 3,
    "character_start": 1
}

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

Kliknij uruchom, a natychmiast otrzymasz wynik, jak poniżej:

{
  "success": true,
  "task_id": "d9bf5461-29b5-47fd-be90-1fe9197df259",
  "trace_id": "b7992643-9207-40d6-956b-7577728acc67",
  "data": [
    {
      "id": "sora-2:task_01k8ykrztefavaypw6xanw305b",
      "video_url": "https://platform.cdn.acedata.cloud/20251101/bee4eeeb4c4660b46dac4548a1ffbc.mp4",
      "state": "succeeded"
    }
  ]
}

Można zauważyć, że wygenerowany efekt to wideo z postacią, a wynik jest podobny do powyższego.

Tryb Wersja 2.0

Oprócz powyższego trybu Wersja 1.0, to API obsługuje również tryb Wersja 2.0, który można włączyć, ustawiając parametr version na "2.0". Tryb Wersja 2.0 obsługuje krótszy czas trwania wideo oraz kontrolę rozdzielczości na poziomie pikseli.

Opis parametrów Wersji 2.0

Parametr	Typ	Czy wymagany	Opis
`version`	string	Tak	Ustaw na `"2.0"`
`prompt`	string	Tak	Wskazówka do generowania wideo
`model`	string	Nie	`sora-2` (domyślnie) lub `sora-2-pro`
`duration`	integer	Nie	Czas trwania wideo: `4` (domyślnie), `8`, `12` sekund
`size`	string	Nie	Rozdzielczość: `720x1280` (domyślnie), `1280x720`, `1024x1792`, `1792x1024`
`image_urls`	array	Nie	Tablica URL obrazów referencyjnych, użyj tylko pierwszego obrazu, rozmiar obrazu musi być zgodny z parametrem `size`
`callback_url`	string	Nie	URL do asynchronicznego wywołania

Podstawowy przykład

curl -X POST 'https://api.acedata.cloud/sora/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "version": "2.0",
  "prompt": "kot biegający nad rzeką",
  "model": "sora-2",
  "duration": 8,
  "size": "1280x720"
}'

Odpowiedni kod w Pythonie:

import requests

url = "https://api.acedata.cloud/sora/videos"

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

payload = {
    "version": "2.0",
    "prompt": "kot biegający nad rzeką",
    "model": "sora-2",
    "seconds": 8,
    "size": "1280x720"
}

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

Odpowiedni kod w JavaScript:

const response = await fetch('https://api.acedata.cloud/sora/videos', {
  method: 'POST',
  headers: {
    'accept': 'application/json',
    'authorization': 'Bearer {token}',
    'content-type': 'application/json'
  },
  body: JSON.stringify({
    version: '2.0',
    prompt: 'kot biegający nad rzeką',
    model: 'sora-2',
    seconds: 8,
    size: '1280x720'
  })
});
const data = await response.json();
console.log(data);

Format zwracanych wyników jest taki sam jak w Wersji 1.

{
  "success": true,
  "task_id": "6bf7fb83-5814-4e3e-a4ad-bfa0c26c0b33",
  "trace_id": "96166698-4b66-478d-a26b-77a7269c9e01",
  "data": [
    {
      "id": "c0cc8dad-0954-421f-be8d-02eb063b3263",
      "video_url": "https://platform.cdn.acedata.cloud/sora/xxxxx.mp4",
      "state": "succeeded"
    }
  ]
}

Użycie obrazów referencyjnych (Wersja 2.0)

W trybie Wersja 2.0 można przekazać obrazy referencyjne za pomocą parametru image_urls, aby prowadzić generację wideo (używając tylko pierwszego obrazu):

import requests

url = "https://api.acedata.cloud/sora/videos"

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

payload = {
    "version": "2.0",
    "prompt": "osoba spacerująca po pięknym ogrodzie",
    "model": "sora-2",
    "duration": 4,
    "size": "1280x720",
    "image_urls": ["https://cdn.acedata.cloud/11wfp4.png"]
}

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

Uwaga: Wymiary obrazów referencyjnych powinny być zgodne z parametrem size, na przykład, gdy size wynosi 1280x720, wymiary obrazu referencyjnego powinny wynosić 1280×720.

Porównanie parametrów Wersji 1.0 i Wersji 2.0

Parametr	Wersja 1.0	Wersja 2.0
`version`	1.0 (domyślnie)	2.0
`prompt`	✅	✅
`model`	✅ sora-2 / sora-2-pro	✅ sora-2 / sora-2-pro
`duration`	✅ 10/15/25 sekund	✅ 4/8/12 sekund
`orientation`	✅ krajobrazowy/portret	❌
`size`	✅ mały/duży	✅ 720x1280/1280x720/1024x1792/1792x1024
`image_urls`	✅ wiele obrazów referencyjnych	✅ używa tylko pierwszego
`character_url`	✅	❌
`callback_url`	✅	✅

Asynchroniczny callback

Ponieważ czas generacji wideo przez API Sora jest stosunkowo długi, wynosi około 1-2 minut, jeśli API nie odpowiada przez dłuższy czas, żądanie HTTP będzie utrzymywać połączenie, co prowadzi do dodatkowego zużycia zasobów systemowych, dlatego to API oferuje również wsparcie dla asynchronicznych callbacków. Cały proces polega na tym, że klient inicjuje żądanie, dodatkowo określając pole callback_url, po wysłaniu żądania API natychmiast zwraca wynik, zawierający pole task_id, które reprezentuje bieżące ID zadania. Po zakończeniu zadania wynik generacji wideo zostanie wysłany do określonego przez klienta callback_url w formie POST JSON, w tym również zawierając pole task_id, dzięki czemu wyniki zadania można powiązać za pomocą ID. Poniżej przedstawiamy przykład, aby zrozumieć, jak to działa. Najpierw, callback Webhook to usługa, która może odbierać żądania HTTP, deweloperzy powinni zastąpić to URL swojego serwera HTTP. Dla wygody demonstracji używamy publicznej strony przykładowej Webhook https://webhook.site/, otwierając tę stronę można uzyskać URL Webhook, jak pokazano na obrazku:

Skopiuj ten URL, aby użyć go jako Webhook, przykładowy URL to https://webhook.site/eb238c4f-da3b-47a5-a922-a93aa5405daa. Następnie możemy ustawić pole callback_url na powyższy URL Webhook, jednocześnie wypełniając odpowiednie parametry, szczegóły jak na obrazku:

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

{
  "task_id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea"
}

Po chwili możemy na https://webhook.site/eb238c4f-da3b-47a5-a922-a93aa5405daa zaobserwować wynik generacji wideo, jak pokazano na obrazku:

Treść jest następująca:

{
    "success": true,
    "task_id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
    "trace_id": "fb751e1e-4705-49ea-9fd4-5024b7865ea2",
    "data": [
        {
            "id": "sora-2:task_01k777hjrbfrgs2060q5zvf2a5",
            "video_url": "https://platform.cdn.acedata.cloud/gptimage/vg-assets/assets%2Ftask_01k777hjrbfrgs2060q5zvf2a5%2Ftask_01k777hjrbfrgs2060q5zvf2a5_genid_b8e2e5d1-a579-49ca-a21c-cb3869685cce_25_10_10_14_15_147334%2Fvideos%2F00000%2Fsrc.mp4?st=2025-10-10T12%3A38%3A49Z&se=2025-10-16T13%3A38%3A49Z&sks=b&skt=2025-10-10T12%3A38%3A49Z&ske=2025-10-16T13%3A38%3A49Z&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skoid=aa5ddad1-c91a-4f0a-9aca-e20682cc8969&skv=2019-02-02&sv=2018-11-09&sr=b&sp=r&spr=https%2Chttp&sig=p4aMqXqkP%2FI1IhOVGCB9JL8vUUvfNBBF12ESpKhKXOk%3D&az=oaivgprodscus",
            "state": "succeeded"
        }
    ]
}

Można zauważyć, że wynik zawiera pole task_id, a inne pola są podobne do powyższych, dzięki czemu można powiązać zadanie za pomocą tego pola.

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": "pobieranie nie powiodło się"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Wnioski

Dzięki temu dokumentowi zrozumiałeś, jak korzystać z API Generacji Wideo Sora, aby generować wideo na podstawie wprowadzonych słów kluczowych oraz zdjęć referencyjnych. Mamy nadzieję, że ten dokument pomoże Ci lepiej zintegrować i korzystać z tego API. W razie jakichkolwiek pytań, skontaktuj się z naszym zespołem wsparcia technicznego.

Getting Started

Czat AI

Obraz AI

Wideo AI

Audio AI

Sieć i dane

CAPTCHA

Tożsamość

Proxy

Advanced

Coding

Sora Videos Generation API Integracja

Proces aplikacji

Podstawowe użycie (Wersja 1)

Zadanie generowania wideo z obrazów (Wersja 1)

Zadanie generowania wideo z postacią (Wersja 1)

Tryb Wersja 2.0

Opis parametrów Wersji 2.0

Podstawowy przykład

Użycie obrazów referencyjnych (Wersja 2.0)

Porównanie parametrów Wersji 1.0 i Wersji 2.0

Asynchroniczny callback

Obsługa błędów

Przykład odpowiedzi błędu

Wnioski

​Proces aplikacji

​Podstawowe użycie (Wersja 1)

​Zadanie generowania wideo z obrazów (Wersja 1)

​Zadanie generowania wideo z postacią (Wersja 1)

​Tryb Wersja 2.0

​Opis parametrów Wersji 2.0

​Podstawowy przykład

​Użycie obrazów referencyjnych (Wersja 2.0)

​Porównanie parametrów Wersji 1.0 i Wersji 2.0

​Asynchroniczny callback

​Obsługa błędów

​Przykład odpowiedzi błędu

​Wnioski

Proces aplikacji

Podstawowe użycie (Wersja 1)

Zadanie generowania wideo z obrazów (Wersja 1)

Zadanie generowania wideo z postacią (Wersja 1)

Tryb Wersja 2.0

Opis parametrów Wersji 2.0

Podstawowy przykład

Użycie obrazów referencyjnych (Wersja 2.0)

Porównanie parametrów Wersji 1.0 i Wersji 2.0

Asynchroniczny callback

Obsługa błędów

Przykład odpowiedzi błędu

Wnioski