Veo 3 Výzvy JSON

Master strukturovaný výzvas pro přesnou kontrolu nad generováním videa AI. Ideální pro integraci Odkaz na API, dávkové zpracování a profesionální pracovní postupy.

🔧 Učte se Formát JSON 📚 Dokumentace API

Základy JSON Parametry Příklady Integrace API Nejlepší postupy

Základy výzvy JSON

Proč používat JSON prompts?

Přesné ovládání

Specifikujte přesné parametry pro konzistentní, předvídatelné výsledky napříč více generacemi.

API připraveno

Ideální pro programové generování videa a automatizované pracovní postupy.

Reprodukovatelné

Uložte a znovu použijte úspěšné konfigurace pro dávkové zpracování.

Kontrola verzí

Sledujte změny a spolupracujte na nich výzva konfigurace efektivně.

Základní 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"
}

Vyžadováno: výzva (řetězec)

Volitelné: Všechny ostatní parametry mají výchozí hodnoty

Formát: Je vyžadována platná syntaxe JSON

Kompletní odkaz na parametry

🎯 Jádro Parametry

výzva

Hlavní popis obsahu videa

string (required)

styl

Celkově vizuální styl a estetické

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

kvalitní

Výstupní rozlišení a úroveň detailů

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

trvání

Specifikace délky videa

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

📹 Ovládání fotoaparátu

camera.type

Rámování záběru a perspektiva

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

camera.movement

Pohyb a dynamika kamery

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

camera.angle

Vertikální umístění vzhledem k předmětu

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

camera.lens

Charakteristika objektivu a ohnisková vzdálenost

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

🎨 Ovládání scény

osvětlení

Světelné podmínky a nálada

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

nálada

Emocionální tón a atmosféra

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

color_palette

Barevné schéma a třídění

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

aspect_ratio

Rozměry a formát videa

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

JSON Prompt Příklady

🎬 Filmová scéna

{
  "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"
}

Případ použití: Akční sekvence, reklamy na auta

Klíčové vlastnosti: Široký filmový formát, letecké sledování

👤 Profesionální portrét

{
  "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"
}

Případ použití: Firemní videa, LinkedIn profily

Klíčové vlastnosti: Studiové osvětlení, portrétní objektiv

📱 Prezentace produktů

{
  "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"
}

Případ použití: Produktový marketing, e-commerce

Klíčové vlastnosti: Orbitální kamera, čisté pozadí

🎨 Abstraktní pohyb

{
  "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"
}

Případ použití: Hudební videa, umělecký obsah

Klíčové vlastnosti: Speciální efekty, pomalý pohyb

🎭 Advanced Multi-Scene 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"
  }
}

Profi tip: Multi-scene JSON umožňuje komplexní příběhy s přesnou kontrolou nad každým segmentem.

Integrace API Průvodce

🌐 Příklad požadavku 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"
  }'

Formát odpovědi

{
  "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"
}

🐍 Integrace Pythonu

import requests
import json

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

# JSON výzva 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']}")

Stav Polling

# 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']}")

📱 Příklad 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 = {
  výzva: "Time lapse of city skyline transition from day to night",
  styl: "cinematic",
  camera: { type: "wide_shot", movement: "static" },
  osvětlení: "day_to_night",
  trvání: "20s",
  kvalitní: "4k"
};

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

Doporučené postupy pro výzvu JSON

✅ Pokyny ke struktuře

• Před odesláním vždy ověřte syntaxi JSON
• Používejte konzistentní konvence pojmenovávání parametrů
• Logicky seskupte související parametry (kamera, osvětlení)
• Zahrnout komentáře do vývoje (pás pro výrobu)
• Nejprve otestujte s minimálními parametry

⚡ Tipy pro výkon

• Uložte do mezipaměti úspěšné konfigurace pro opětovné použití
• Místo dotazování na stav používejte webhooky
• Pokud je to možné, dávkovejte podobné požadavky
• Optimalizovat výzva délka pro rychlejší zpracování
• Sledujte využití kreditu a nastavte upozornění

🛡️ Zpracování chyb

• Implementujte logiku opakování s exponenciálním stažením
• Před voláním API ověřte parametry
• Omezování rychlosti zvládněte elegantně
• Protokolovat selhání s kontextem pro ladění
• Poskytněte záložní možnosti pro neúspěšné generace

🚨 Běžné chyby a řešení JSON

❌ Neplatná syntaxe JSON


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


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

❌ Neplatné hodnoty parametrů


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


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

❌ Chybějící povinná pole


                            { "style": "cinematic" }     // Missing výzva


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

❌ Konfliktní parametry


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


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

Připraveno k použití Výzvy JSON?

Začněte integrovat generování strukturovaného videa do svých aplikací. Získejte přístup k API a začněte tvořit s přesnou kontrolou.

📚 Dokumentace API 🎁 Získejte API klíč zdarma

Bezplatné kredity API • Profesionální podpora • Dostupné možnosti Enterprise