Dokumentacja API

Kompletna dokumentacja API do generowania wideo Veo 3.1 AI

Przegląd

API Veo 3.1 pozwala programowo generować filmy AI z opisów tekstowych lub obrazów. Nasze RESTful API jest zaprojektowane tak, aby było proste, wydajne i łatwe do integracji z aplikacjami.

Bazowy URL

https://veo3o1.com/api

Uwierzytelnianie

Wszystkie żądania API wymagają uwierzytelnienia za pomocą klucza API. Dołącz swój klucz API w nagłówku Authorization:

Authorization: Bearer YOUR_API_KEY

Możesz wygenerować klucze API w panelu konta.


Generowanie wideo

Utwórz nowe wideo AI z tekstu lub obrazu.

Endpoint

POST /generate-video

Treść żądania

{
  "generationType": "text_to_video" | "image_to_video",
  "prompt": "Your video description",
  "aspectRatio": "auto" | "16:9" | "9:16",
  "imageUrl": "https://...", // Required if generationType is "image_to_video"
  "imageKey": "r2-key" // Optional, for uploaded images
}

Parametry

ParametrTypWymaganyOpis
generationTypestringTakTyp generowania: text_to_video lub image_to_video
promptstringTakOpis wideo, które chcesz wygenerować
aspectRatiostringNieProporcje wideo. Domyślnie: auto
imageUrlstringWarunkowoWymagane jeśli generationType to image_to_video
imageKeystringNieKlucz przechowywania dla przesłanych obrazów

Odpowiedź

{
  "code": 0,
  "msg": "Success",
  "data": {
    "uuid": "video-uuid-123",
    "status": "pending",
    "generationType": "text_to_video",
    "prompt": "Your video description",
    "aspectRatio": "16:9",
    "createdAt": "2025-10-16T10:00:00Z"
  }
}

Przykład

curl -X POST https://veo3o1.com/api/generate-video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "generationType": "text_to_video",
    "prompt": "A beautiful sunset over the ocean with waves gently lapping the shore",
    "aspectRatio": "16:9"
  }'

Pobierz status wideo

Sprawdź status żądania generowania wideo.

Endpoint

GET /video-status/{uuid}

Parametry

ParametrTypWymaganyOpis
uuidstringTakUUID wideo z żądania generowania

Odpowiedź

{
  "code": 0,
  "msg": "Success",
  "data": {
    "uuid": "video-uuid-123",
    "status": "completed" | "pending" | "processing" | "failed",
    "videoUrl": "https://...", // Available when status is "completed"
    "progress": 85, // Processing progress (0-100)
    "estimatedTime": 120 // Estimated seconds remaining
  }
}

Wartości statusu

  • pending: Wideo jest w kolejce do przetworzenia
  • processing: Wideo jest generowane
  • completed: Wideo jest gotowe i dostępne do pobrania
  • failed: Generowanie nie powiodło się (sprawdź komunikat błędu)

Przesyłanie obrazu

Prześlij obraz do generowania wideo z obrazu.

Endpoint

POST /upload-video-image

Żądanie

Użyj multipart/form-data do przesłania pliku obrazu.

curl -X POST https://veo3o1.com/api/upload-video-image \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/image.jpg"

Odpowiedź

{
  "code": 0,
  "msg": "Upload successful",
  "data": {
    "imageUrl": "https://...",
    "imageKey": "r2-key-123"
  }
}

Obsługiwane formaty

  • JPEG/JPG
  • PNG
  • WebP
  • Maksymalny rozmiar pliku: 50MB

Kody błędów

KodOpis
0Sukces
1000Nieprawidłowe parametry
1001Niewystarczające kredyty
1002Błąd uwierzytelniania
1003Przekroczono limit żądań
5000Błąd serwera

Przykład odpowiedzi błędu

{
  "code": 1001,
  "msg": "Insufficient credits",
  "data": {
    "required": 2,
    "current": 0
  }
}

Najlepsze praktyki

  1. Odpowiedzialne odpytywanie: Sprawdzaj status wideo co 5-10 sekund, nie ciągle
  2. Obsługa błędów: Zaimplementuj logikę ponownych prób z wykładniczym opóźnieniem
  3. Buforowanie wyników: Przechowuj wygenerowane wideo, aby uniknąć ponownego generowania
  4. Używaj webhooków: Bardziej wydajne niż odpytywanie dla powiadomień o zakończeniu
  5. Waliduj dane wejściowe: Sprawdź długość promptu i formaty obrazów przed wywołaniami API

Wsparcie

Potrzebujesz pomocy z API?