Instrukcja integracji Veo Videos Generation API

​

Proces aplikowania

📘 Pełna dokumentacja: Veo Videos Generation API →

​

Podstawowe użycie

• accept: format odpowiedzi, który chcesz otrzymać; tutaj wpisz application/json, czyli format JSON.
• authorization: klucz do wywołania API, który po uzyskaniu można bezpośrednio wybrać z listy rozwijanej.

• model: model generowania wideo; dostępne są głównie modele veo31-fast, veo3, veo31, veo3-fast i veo31-fast-ingredients.
• action: działanie dla tego zadania generowania wideo, obejmujące głównie trzy działania: tekst na wideo (text2video), obraz na wideo (image2video), pobieranie wideo 1080p (get1080p).
• image_urls: linki do obrazów referencyjnych, które należy przesłać, gdy wybrano działanie obraz na wideo image2video. veo31-fast-ingredients obsługuje maksymalnie 3 obrazy (łączenie wielu obrazów), a pozostałe modele obsługują maksymalnie 2 obrazy (tryb pierwszej i ostatniej klatki).
• resolution: wybór rozdzielczości generowanego wideo; model veo31 obsługuje rozdzielczość 4k, pozostałe modele jej nie obsługują. Wszystkie modele obsługują rozdzielczość 1080p oraz gif; jeśli ta wartość nie zostanie przekazana, domyślnie używana jest rozdzielczość 720p. Główne opcje to: 1080p, gif, 4k.
• prompt: prompt.
• callback_url: URL, na który ma zostać zwrócony wynik wywołania zwrotnego.
• async: opcjonalne; po ustawieniu na true interfejs natychmiast zwraca task_id, bez konieczności podawania callback_url, a następnie wynik można uzyskać przez odpytywanie odpowiedniego interfejsu zapytania o zadanie.

​

📌 Podsumowanie opisu modeli

​

🔑 Opis kluczowych zasad

1. Ogólna logika:
   • Brak obrazu wejściowego → automatycznie uruchamia tryb tekst na wideo.
   • Obraz wejściowy obecny → uruchamia tryb obraz na wideo (konkretne działanie zależy od liczby obrazów).
2. Typy trybu obraz na wideo:
   • Tryb pierwszej klatki (1 obraz): pierwsza klatka jest ustalona jako obraz wejściowy.
   • Tryb pierwszej i ostatniej klatki (2 obrazy): pierwsza i ostatnia klatka są ustalone jako obrazy wejściowe.
   • Tryb łączenia wielu obrazów (1-3 obrazy): obsługiwany wyłącznie przez veo31-fast-ingredients, łączy zawartość wielu obrazów w celu wygenerowania wideo.
3. Klasyfikacja trybów:

• Tryb Fast: veo3-fast, veo31-fast, veo31-fast-ingredients.
• Tryb Quality: veo3, veo31 (wyższa jakość generowania).

​

⚠️ Uwagi

• Jedyny model z obowiązkowym przekazaniem obrazu: do veo31-fast-ingredients należy przekazać obrazy (1-3), w przeciwnym razie nie będzie mógł działać.
• Limit liczby obrazów:
  • veo31-fast-ingredients obsługuje wejście 1-3 obrazów (tryb łączenia wielu obrazów).
  • Pozostałe modele obsługują maksymalnie 2 obrazy wejściowe (tryb pierwszej i ostatniej klatki).

{
  "success": true,
  "task_id": "697ea2fc-58fd-48c8-8191-29041ff23c3c",
  "trace_id": "70e1cb12-c619-4292-a416-90191205996b",
  "data": [
    {
      "id": "24ac06a5-9cc7-448f-802e-0b4db19f6e96",
      "video_url": "https://cdn.acedata.cloud/assets/examples/veo/f5389ec0-2eb5-4212-b4a8-04b513b0129a-0b0c3113d691.mp4",
      "created_at": "2026-06-30T04:01:50.364Z",
      "complete_at": "2026-06-30T04:03:20.495Z",
      "state": "succeeded"
    }
  ]
}

• success，stan zadania generowania wideo w tym momencie.
• task_id，ID zadania generowania wideo w tym momencie.
• data，wynik zadania generowania wideo w tym momencie.
  • id，ID wideo zadania generowania wideo w tym momencie.
  • video_url，link do wideo zadania generowania wideo w tym momencie.
  • created_at，czas utworzenia zadania generowania wideo w tym momencie.
  • complete_at，czas ukończenia zadania generowania wideo w tym momencie.
  • state，stan zadania generowania wideo w tym momencie.

curl -X POST 'https://api.acedata.cloud/veo/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "text2video",
  "model": "veo31-fast",
  "prompt": "White ceramic coffee mug on glossy marble countertop with morning window light. Camera slowly rotates 360 degrees around the mug, pausing briefly at the handle."
}'

​

Funkcja generowania wideo z obrazu

• model：model do generowania wideo, głównie veo31-fast、veo3、veo31、veo3-fast i veo31-fast-ingredients。
• image_urls：gdy wybierzesz działanie generowania wideo z obrazu image2video, wymagane są linki do przesłanych obrazów referencyjnych.
• prompt：podpowiedź.

import requests

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

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

payload = {
    "action": "image2video",
    "model": "veo31-fast",
    "prompt": "Let it dance",
    "image_urls": ["https://cdn.acedata.cloud/7p1jhy.png"]
}

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

{
  "success": true,
  "task_id": "98e309f3-35bc-438d-8cb3-4015fc864b87",
  "trace_id": "8bc68066-36de-41ef-ae5e-b7d61ff6aee8",
  "data": [
    {
      "id": "59f12222b1fa4fbe9331ff2400ad1583",
      "video_url": "https://platform.cdn.acedata.cloud/veo/98e309f3-35bc-438d-8cb3-4015fc864b87.mp4",
      "created_at": "2025-07-25 16:13:07",
      "complete_at": "2025-07-25 16:16:12",
      "state": "succeeded"
    }
  ]
}

​

Funkcja pobierania wideo 1080p

"id": "59f12222b1fa4fbe9331ff2400ad1583"

Uwaga, video_id w tym wideo to ID wygenerowanego wideo. Jeśli nie wiesz, jak generować wideo, możesz zapoznać się z podstawowym użyciem powyżej, aby wygenerować wideo.

• model：model do generowania wideo, głównie veo31-fast、veo3、veo31、veo3-fast i veo31-fast-ingredients。
• video_id：ID referencyjnego wideo, używane do pobrania wideo 1080p.

{
  "success": true,
  "task_id": "47a51cfe-2e24-4aba-93b3-546c2dc52984",
  "trace_id": "a8922eec-6f50-4f77-8104-00ded071d59d",
  "data": [
    {
      "id": "59f12222b1fa4fbe9331ff2400ad1583",
      "video_url": "https://platform.cdn.acedata.cloud/veo/47a51cfe-2e24-4aba-93b3-546c2dc52984.mp4",
      "created_at": "2025-07-25 16:13:07",
      "complete_at": "2025-07-25 16:16:12",
      "state": "succeeded"
    }
  ]
}

​

Generowanie z określonym rozmiarem wideo

• model：model do generowania wideo, głównie veo31-fast、veo3、veo31、veo3-fast i veo31-fast-ingredients。
• aspect_ratio：rozmiar wideo, obecnie obsługiwane: 16:9、16:9、3:4、4:3、1:1，domyślnie jest 16:9。
• translation：czy włączyć automatyczne tłumaczenie podpowiedzi, domyślnie false。 Przykład wypełnienia jest następujący:

{
  "success": true,
  "task_id": "d2b93290-ab0e-4d20-ae45-60c062a32687",
  "trace_id": "9834e64d-c8fe-43ae-8114-ee2b5f93d886",
  "data": [
    {
      "id": "fc667e7d3b8f44beaa61a3c339af0e50",
      "video_url": "https://platform.cdn.acedata.cloud/veo/d2b93290-ab0e-4d20-ae45-60c062a32687.mp4",
      "created_at": "2025-08-24 20:09:06",
      "complete_at": "2025-08-24 20:10:45",
      "state": "succeeded"
    }
  ]
}

​

Asynchroniczne wywołanie zwrotne

{
  "task_id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed"
}

{
  "success": true,
  "task_id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed",
  "trace_id": "d1d53c04-58c5-4c40-bb63-f00188540e56",
  "data": [
    {
      "id": "2f43ceed37944b4d836e1a1899dad0a1",
      "video_url": "https://platform.cdn.acedata.cloud/veo/1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed.mp4",
      "created_at": "2025-07-25 17:19:20",
      "complete_at": "2025-07-25 17:21:45",
      "state": "succeeded"
    }
  ]
}

​

Obsługa błędów

• 400 token_mismatched：Nieprawidłowe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
• 400 api_not_implemented：Nieprawidłowe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
• 401 invalid_token：Brak autoryzacji, nieprawidłowy lub brakujący token autoryzacyjny.
• 429 too_many_requests：Zbyt wiele żądań, przekroczono limit częstotliwości.
• 500 api_error：Wewnętrzny błąd 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