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/apiUwierzytelnianie
Wszystkie żądania API wymagają uwierzytelnienia za pomocą klucza API. Dołącz swój klucz API w nagłówku Authorization:
Authorization: Bearer YOUR_API_KEYMożesz wygenerować klucze API w panelu konta.
Generowanie wideo
Utwórz nowe wideo AI z tekstu lub obrazu.
Endpoint
POST /generate-videoTreść żą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
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
generationType | string | Tak | Typ generowania: text_to_video lub image_to_video |
prompt | string | Tak | Opis wideo, które chcesz wygenerować |
aspectRatio | string | Nie | Proporcje wideo. Domyślnie: auto |
imageUrl | string | Warunkowo | Wymagane jeśli generationType to image_to_video |
imageKey | string | Nie | Klucz 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
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
uuid | string | Tak | UUID 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 przetworzeniaprocessing: Wideo jest generowanecompleted: Wideo jest gotowe i dostępne do pobraniafailed: 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
| Kod | Opis |
|---|---|
| 0 | Sukces |
| 1000 | Nieprawidłowe parametry |
| 1001 | Niewystarczające kredyty |
| 1002 | Błąd uwierzytelniania |
| 1003 | Przekroczono limit żądań |
| 5000 | Błąd serwera |
Przykład odpowiedzi błędu
{
"code": 1001,
"msg": "Insufficient credits",
"data": {
"required": 2,
"current": 0
}
}Najlepsze praktyki
- Odpowiedzialne odpytywanie: Sprawdzaj status wideo co 5-10 sekund, nie ciągle
- Obsługa błędów: Zaimplementuj logikę ponownych prób z wykładniczym opóźnieniem
- Buforowanie wyników: Przechowuj wygenerowane wideo, aby uniknąć ponownego generowania
- Używaj webhooków: Bardziej wydajne niż odpytywanie dla powiadomień o zakończeniu
- Waliduj dane wejściowe: Sprawdź długość promptu i formaty obrazów przed wywołaniami API
Wsparcie
Potrzebujesz pomocy z API?