Veo 3 JSON-prompts

Meester gestructureerd promos voor nauwkeurige controle over het genereren van AI-video's. Perfect voor API-documentatie-integratie, batchverwerking en professionele workflows.

🔧 Leer JSON-indeling 📚 API Documentatie

JSON-basisprincipes Parameters Voorbeelden API-integratie Beste praktijken

Basisprincipes van JSON-prompts

Waarom JSON prompts gebruiken?

Nauwkeurige controle

Specificeer exacte parameters voor consistente, voorspelbare resultaten over meerdere generaties.

KYC Klaar

Perfect voor programmatische videogeneratie en geautomatiseerde workflows.

Reproduceerbaar

Bewaar en hergebruik succesvolle configuraties voor batchverwerking.

Versiebeheer

Houd veranderingen bij en werk eraan samen promo configuraties effectief.

Basis JSON-structuur

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

Vereist: promo (tekenreeks)

Optioneel: Alle andere parameters hebben standaardwaarden

Formaat: Geldige JSON-syntaxis vereist

Volledige parameterreferentie

🎯 Kern Parameters

promo

Hoofdbeschrijving van de video-inhoud

string (required)

stijl

Over het algemeen visueel stijl en esthetisch

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

kwaliteit

Uitvoerresolutie en detailniveau

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

duur

Specificatie van de videolengte

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

📹 Camerabediening

camera.type

Kadrering en perspectief van de opname

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

camera.movement

Camerabeweging en dynamiek

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

camera.angle

Verticale positionering ten opzichte van het onderwerp

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

camera.lens

Lenskarakteristieken en brandpuntsafstand

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

🎨 Scènecontrole

verlichting

Lichtomstandigheden en sfeer

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

stemming

Emotionele toon en sfeer

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

color_palette

Kleurenschema en sortering

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

aspect_ratio

Videoafmetingen en -formaat

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

JSON Prompt Voorbeelden

🎬 Filmische scène

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

Gebruiksscenario: Actiescènes, autoreclames

Belangrijkste kenmerken: Breed filmisch formaat, tracking vanuit de lucht

👤 Professioneel 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"
}

Gebruiksscenario: Bedrijfsvideo's, LinkedIn-profielen

Belangrijkste kenmerken: Studioverlichting, portretlens

📱 Productshowcase

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

Gebruiksscenario: Productmarketing, e-commerce

Belangrijkste kenmerken: Orbitale camera, schone achtergrond

🎨 Samenvatting

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

Gebruiksscenario: Muziekvideo's, artistieke inhoud

Belangrijkste kenmerken: Speciale effecten, slow motion

🎭 Geavanceerde JSON met meerdere scènes

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

Pro-tip: JSON met meerdere scènes maakt complexe verhalen mogelijk met nauwkeurige controle over elk segment.

API-integratie Gids

🌐 Voorbeeld van HTTP-verzoek

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

Antwoordformaat

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

🐍 Python-integratie

import requests
import json

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

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

Statuspeiling

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

📱 JavaScript/Node.js-voorbeeld

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 = {
  promo: "Time lapse of city skyline transition from day to night",
  stijl: "cinematic",
  camera: { type: "wide_shot", movement: "static" },
  verlichting: "day_to_night",
  duur: "20s",
  kwaliteit: "4k"
};

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

Best practices voor JSON-prompt

✅ Structuurrichtlijnen

• Valideer altijd de JSON-syntaxis voordat u deze verzendt
• Gebruik consistente naamgevingsconventies voor parameters
• Groepeer gerelateerde parameters logisch (camera, verlichting)
• Opmerkingen opnemen tijdens de ontwikkeling (strip voor productie)
• Test eerst met minimale parameters

⚡ Prestatietips

• Succesvolle configuraties in de cache opslaan voor hergebruik
• Gebruik webhooks in plaats van te peilen naar de status
• Verzamel vergelijkbare verzoeken indien mogelijk
• Optimaliseer promo lengte voor snellere verwerking
• Houd het kredietgebruik in de gaten en stel waarschuwingen in

🛡️ Foutafhandeling

• Implementeer logica voor nieuwe pogingen met exponentiële uitstel
• Valideer parameters voordat API wordt aangeroepen
• Ga netjes om met snelheidsbeperking
• Registreer fouten met context voor foutopsporing
• Bied terugvalopties voor mislukte generaties

🚨 Veelvoorkomende JSON-fouten en oplossingen

❌ Ongeldige JSON-syntaxis


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


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

❌ Ongeldige parameterwaarden


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


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

❌ Ontbrekende verplichte velden


                            { "style": "cinematic" }     // Missing promo


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

❌ Conflicterende parameters


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


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

Klaar voor gebruik JSON-prompts?

Begin met het integreren van gestructureerde videogeneratie in uw applicaties. Krijg toegang tot API en begin met creëren met nauwkeurige controle.

📚 API Documentatie 🎁 Ontvang API sleutel gratis

Gratis API creditpakketten • Professionele ondersteuning • Enterprise-opties beschikbaar