Veo 3 Podpowiedzi JSON

Struktura mistrzowska podpowiedźs dla precyzyjnej kontroli nad generowaniem wideo AI. Idealny do integracji Odniesienie do API, przetwarzania wsadowego i profesjonalnych przepływów pracy.

🔧 Ucz się Format JSON 📚 Dokumentacja API

Podstawy JSON-a Parametry Przykłady Integracja API Najlepsze praktyki

Podstawy podpowiedzi JSON

Dlaczego warto używać JSON prompt?

Precyzyjna kontrola

Określ dokładne parametry, aby uzyskać spójne, przewidywalne wyniki dla wielu pokoleń.

Gotowy do API

Idealny do programowego generowania wideo i zautomatyzowanych przepływów pracy.

Odtwarzalny

Zapisz i ponownie wykorzystuj pomyślne konfiguracje do przetwarzania wsadowego.

Kontrola wersji

Śledź zmiany i współpracuj nad nimi podpowiedź konfiguracje skutecznie.

Podstawowa struktura JSON

{
  "prompt": "Your detailed video description",
  "style": "cinematic",
  "camera": {
    "type": "wide_shot",
    "movement": "slow_pan"
  },
  "lighting": "golden_hour",
  "quality": "4k",
  "duration": "10s",
  "aspect_ratio": "16:9"
}

Wymagane: podpowiedź (ciąg)

Opcjonalnie: Wszystkie pozostałe parametry mają wartości domyślne

Format: Wymagana jest prawidłowa składnia JSON

Pełne odniesienie do parametrów

🎯 Rdzeń Parametry

podpowiedź

Główny opis treści wideo

string (required)

styl

Ogólnie wizualnie styl i estetyczne

"cinematic" | "realistic" | "artistic" | "documentary"

jakość

Rozdzielczość wyjściowa i poziom szczegółowości

"4k" | "hd" | "standard" | "high"

czas trwania

Specyfikacja długości wideo

"5s" | "10s" | "15s" | "short" | "medium"

📹 Sterowanie kamerą

camera.type

Kadrowanie i perspektywa ujęcia

"wide_shot" | "close_up" | "medium_shot" | "extreme_wide"

camera.movement

Ruch i dynamika kamery

"static" | "pan_left" | "pan_right" | "dolly_in" | "crane"

camera.angle

Pozycjonowanie w pionie względem obiektu

"eye_level" | "low_angle" | "high_angle" | "birds_eye"

camera.lens

Charakterystyka obiektywu i ogniskowa

"wide_angle" | "standard" | "telephoto" | "macro"

🎨 Kontrola scen

oświetlenie

Warunki oświetleniowe i nastrój

"golden_hour" | "blue_hour" | "studio" | "natural" | "dramatic"

nastrój

Emocjonalny ton i atmosfera

"serene" | "energetic" | "mysterious" | "uplifting" | "dramatic"

color_palette

Schemat kolorów i stopniowanie

"warm" | "cool" | "vibrant" | "muted" | "monochrome"

aspect_ratio

Wymiary i format wideo

"16:9" | "9:16" | "1:1" | "21:9" | "4:3"

JSONPrompt Przykłady

🎬 Scena filmowa

{
  "prompt": "Aerial shot of red sports car racing through mountain curves at sunset",
  "style": "cinematic",
  "camera": {
    "type": "aerial",
    "movement": "tracking",
    "angle": "high_angle"
  },
  "lighting": "golden_hour",
  "mood": "dramatic",
  "quality": "4k",
  "duration": "15s",
  "aspect_ratio": "21:9",
  "color_palette": "warm"
}

Przypadek użycia: Sekwencje akcji, reklamy samochodów

Kluczowe cechy: Szeroki format kinowy, śledzenie z lotu ptaka

👤 Profesjonalny portret

{
  "prompt": "Professional headshot of confident businesswoman, warm smile, eye contact",
  "style": "realistic",
  "camera": {
    "type": "close_up",
    "movement": "static",
    "angle": "eye_level",
    "lens": "85mm"
  },
  "lighting": "studio",
  "mood": "professional",
  "quality": "4k",
  "duration": "8s",
  "aspect_ratio": "16:9",
  "color_palette": "neutral"
}

Przypadek użycia: Filmy korporacyjne, profile LinkedIn

Kluczowe cechy: Oświetlenie studyjne, obiektyw portretowy

📱 Prezentacja produktów

{
  "prompt": "Sleek smartphone rotating on white surface, premium materials visible",
  "style": "commercial",
  "camera": {
    "type": "medium_shot",
    "movement": "orbit",
    "angle": "slightly_low"
  },
  "lighting": "studio",
  "mood": "clean",
  "quality": "4k",
  "duration": "10s",
  "aspect_ratio": "16:9",
  "color_palette": "minimal",
  "background": "clean_white"
}

Przypadek użycia: Marketing produktów, e-commerce

Kluczowe cechy: Kamera orbitalna, czyste tło

🎨 Abstrakcyjny ruch

{
  "prompt": "Fluid abstract shapes morphing in vibrant neon colors",
  "style": "artistic",
  "camera": {
    "type": "macro",
    "movement": "floating",
    "angle": "dynamic"
  },
  "lighting": "neon",
  "mood": "energetic",
  "quality": "4k",
  "duration": "12s",
  "aspect_ratio": "16:9",
  "color_palette": "vibrant",
  "effects": ["glow", "particle_systems"],
  "speed": "slow_motion"
}

Przypadek użycia: Teledyski, treści artystyczne

Kluczowe cechy: Efekty specjalne, zwolnione tempo

🎭 Zaawansowany wielosceniczny JSON

{
  "project": {
    "title": "Brand Story Campaign",
    "total_duration": "45s",
    "aspect_ratio": "16:9",
    "quality": "4k"
  },
  "scenes": [
    {
      "id": "scene_1",
      "prompt": "Wide establishing shot of modern office building at sunrise",
      "style": "cinematic",
      "camera": {
        "type": "extreme_wide",
        "movement": "slow_push_in",
        "angle": "slightly_low"
      },
      "lighting": "golden_hour",
      "duration": "8s",
      "mood": "inspiring"
    },
    {
      "id": "scene_2",
      "prompt": "Medium shot of diverse team collaborating around conference table",
      "style": "realistic",
      "camera": {
        "type": "medium_shot",
        "movement": "subtle_pan",
        "angle": "eye_level"
      },
      "lighting": "natural_office",
      "duration": "12s",
      "mood": "professional"
    },
    {
      "id": "scene_3",
      "prompt": "Close-up of hands typing on laptop, screen reflecting innovation",
      "style": "commercial",
      "camera": {
        "type": "macro",
        "movement": "static",
        "angle": "overhead"
      },
      "lighting": "screen_glow",
      "duration": "10s",
      "mood": "focused"
    }
  ],
  "transitions": {
    "type": "fade",
    "duration": "1s"
  },
  "audio": {
    "style": "corporate_uplifting",
    "volume": "background"
  }
}

Wskazówka dla profesjonalistów: Wielosceniczny JSON pozwala na tworzenie złożonych narracji z precyzyjną kontrolą każdego segmentu.

Integracja API Przewodnik

🌐 Przykład żądania HTTP

curl -X POST https://ulazai.com/api/v1/video/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Cinematic aerial shot of mountain landscape",
    "style": "cinematic",
    "camera": {
      "type": "aerial",
      "movement": "forward_dolly"
    },
    "quality": "4k",
    "duration": "10s",
    "aspect_ratio": "16:9"
  }'

Forma odpowiedzi

{
  "success": true,
  "job_id": "veo3_abc123def456",
  "status": "processing",
  "estimated_time": "varies by queue",
  "webhook_url": "https://your-app.com/webhook",
  "cost": "returned with the current quote"
}

🐍 Integracja z Pythonem

import requests
import json

# Your API configuration
API_KEY = "your_api_key_here"
BASE_URL = "https://ulazai.com/api/v1"

# JSON podpowiedź configuration
video_config = {
    "prompt": "Professional product demo video",
    "style": "commercial",
    "camera": {
        "type": "medium_shot",
        "movement": "orbit"
    },
    "lighting": "studio",
    "quality": "4k",
    "duration": "15s"
}

# Send generation request
response = requests.post(
    f"{BASE_URL}/video/generate",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    },
    json=video_config
)

result = response.json()
print(f"Job ID: {result['job_id']}")
print(f"Status: {result['status']}")

Odpytywanie stanu

# Check generation status
status_response = requests.get(
    f"{BASE_URL}/video/status/{job_id}",
    headers={"Authorization": f"Bearer {API_KEY}"}
)

status_data = status_response.json()
if status_data['status'] == 'completed':
    video_url = status_data['video_url']
    print(f"Video ready: {video_url}")
elif status_data['status'] == 'failed':
    print(f"Error: {status_data['error_message']}")

📱 Przykład JavaScript/Node.js

const axios = require('axios');

class UlazAIClient {
  constructor(apiKey) {
    this.apiKey = apiKey;
    this.baseURL = 'https://ulazai.com/api/v1';
  }

  async generateVideo(config) {
    try {
      const response = await axios.post(`${this.baseURL}/video/generate`, config, {
        headers: {
          'Authorization': `Bearer ${this.apiKey}`,
          'Content-Type': 'application/json'
        }
      });

      return response.data;
    } catch (error) {
      throw new Error(`Generation failed: ${error.response.data.message}`);
    }
  }

  async getVideoStatus(jobId) {
    const response = await axios.get(`${this.baseURL}/video/status/${jobId}`, {
      headers: { 'Authorization': `Bearer ${this.apiKey}` }
    });

    return response.data;
  }
}

// Usage example
const client = new UlazAIClient('your_api_key');

const videoConfig = {
  podpowiedź: "Time lapse of city skyline transition from day to night",
  styl: "cinematic",
  camera: { type: "wide_shot", movement: "static" },
  oświetlenie: "day_to_night",
  czas trwania: "20s",
  jakość: "4k"
};

client.generateVideo(videoConfig)
  .then(result => console.log('Generation started:', result.job_id))
  .catch(error => console.error('Error:', error.message));

Najlepsze praktyki dotyczące podpowiedzi JSON

✅Wytyczne dotyczące struktury

• Zawsze sprawdzaj składnię JSON przed wysłaniem
• Stosuj spójne konwencje nazewnictwa parametrów
• Grupuj logicznie powiązane parametry (kamera, oświetlenie)
• Uwzględnij komentarze w rozwoju (pasek do produkcji)
• Najpierw przetestuj z minimalnymi parametrami

⚡ Wskazówki dotyczące wydajności

• Zapisz w pamięci podręcznej pomyślne konfiguracje do ponownego wykorzystania
• Używaj webhooków zamiast odpytywać o status
• Jeśli to możliwe, grupuj podobne żądania
• Optymalizuj podpowiedź długość dla szybszego przetwarzania
• Monitoruj wykorzystanie kredytu i ustawiaj alerty

🛡️ Obsługa błędów

• Zaimplementuj logikę ponawiania z wykładniczym wycofywaniem
• Sprawdź parametry przed wywołaniami API
• Obsługuj ograniczanie szybkości z wdziękiem
• Rejestruj błędy z kontekstem do debugowania
• Zapewnij opcje awaryjne dla nieudanych generacji

🚨 Typowe błędy i rozwiązania JSON

❌ Nieprawidłowa składnia JSON


                            { "prompt": "Test", "quality": "4k", }  // Trailing comma


                            { "prompt": "Test", "quality": "4k" }   // Correct

❌ Nieprawidłowe wartości parametrów


                            { "quality": "super_high" }  // Invalid value


                            { "quality": "4k" }          // Valid value

❌ Brak wymaganych pól


                            { "style": "cinematic" }     // Missing podpowiedź


                            { "prompt": "Test video", "style": "cinematic" }

❌ Sprzeczne parametry


                            { "mood": "serene", "style": "action" }  // Conflicting


                            { "mood": "energetic", "style": "action" }  // Consistent

Gotowy do użycia Podpowiedzi JSON?

Zacznij integrować generowanie strukturalnego wideo ze swoimi aplikacjami. Uzyskaj dostęp do API i rozpocznij tworzenie z precyzyjną kontrolą.

📚 Dokumentacja API 🎁 Uzyskaj klucz API za darmo

Bezpłatne kredyty API • Profesjonalne wsparcie • Dostępne opcje dla przedsiębiorstw