Veo 3 JSON-Eingabeaufforderungen

Master strukturiert Aufforderungs für eine präzise Steuerung der KI-Videoerzeugung. Perfekt für die API-Dokumentation-Integration, Stapelverarbeitung und professionelle Arbeitsabläufe.

🔧 Lernen JSON-Format 📖 API-Doku

JSON-Grundlagen Parameter Beispiele API-Integration Empfehlungen

Grundlagen der JSON-Eingabeaufforderung

Warum JSON-Prompts verwenden?

Präzise Kontrolle

Geben Sie genaue Parameter für konsistente, vorhersehbare Ergebnisse über mehrere Generationen hinweg an.

API Bereit

Perfekt für die programmatische Videogenerierung und automatisierte Workflows.

Reproduzierbar

Speichern Sie erfolgreiche Konfigurationen und verwenden Sie sie für die Stapelverarbeitung wieder.

Versionskontrolle

Verfolgen Sie Änderungen und arbeiten Sie gemeinsam daran Aufforderung Konfigurationen effektiv.

Grundlegende JSON-Struktur

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

Erforderlich: Aufforderung (Zeichenfolge)

Optional: Alle anderen Parameter haben Standardwerte

Format: Gültige JSON-Syntax erforderlich

Vollständige Parameterreferenz

🎯 Kern Parameter

Aufforderung

Hauptbeschreibung des Videoinhalts

string (required)

Stil

Insgesamt visuell Stil und ästhetisch

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

Qualität

Ausgabeauflösung und Detailstufe

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

Dauer

Angabe der Videolänge

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

📹 Kamerasteuerung

camera.type

Bildausschnitt und Perspektive

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

camera.movement

Kamerabewegung und Dynamik

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

camera.angle

Vertikale Positionierung relativ zum Motiv

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

camera.lens

Objektiveigenschaften und Brennweite

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

🎨 Szenensteuerung

Beleuchtung

Lichtverhältnisse und Stimmung

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

Stimmung

Emotionaler Ton und Atmosphäre

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

color_palette

Farbschema und Sortierung

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

aspect_ratio

Videoabmessungen und -format

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

JSON Prompt Beispiele

🎬 Kinoszene

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

Anwendungsfall: Actionsequenzen, Autowerbung

Hauptmerkmale: Breites Kinoformat, Luftverfolgung

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

Anwendungsfall: Unternehmensvideos, LinkedIn-Profile

Hauptmerkmale: Studiobeleuchtung, Porträtobjektiv

📱 Produktpräsentation

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

Anwendungsfall: Produktmarketing, E-Commerce

Hauptmerkmale: Orbitalkamera, sauberer Hintergrund

🎨 Abstrakte Bewegung

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

Anwendungsfall: Musikvideos, künstlerische Inhalte

Hauptmerkmale: Spezialeffekte, Zeitlupe

🎭 Erweitertes 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-Tipp: Multiszenen-JSON ermöglicht komplexe Erzählungen mit präziser Kontrolle über jedes Segment.

API-Integration Leitfaden

🌐 Beispiel für eine HTTP-Anfrage

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

Antwortformat

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

import requests
import json

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

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

Statusabfrage

# 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-Beispiel

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 = {
  Aufforderung: "Time lapse of city skyline transition from day to night",
  Stil: "cinematic",
  camera: { type: "wide_shot", movement: "static" },
  Beleuchtung: "day_to_night",
  Dauer: "20s",
  Qualität: "4k"
};

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

JSON Prompt Empfehlungen

✅ Strukturrichtlinien

• Überprüfen Sie vor dem Senden immer die JSON-Syntax
• Verwenden Sie einheitliche Namenskonventionen für Parameter
• Zusammengehörige Parameter logisch gruppieren (Kamera, Beleuchtung)
• Kommentare in die Entwicklung einbeziehen (Strip für die Produktion)
• Testen Sie zunächst mit minimalen Parametern

⚡ Leistungstipps

• Erfolgreiche Konfigurationen zur Wiederverwendung zwischenspeichern
• Verwenden Sie Webhooks, anstatt den Status abzufragen
• Wenn möglich, stapeln Sie ähnliche Anfragen
• Optimieren Aufforderung Länge für schnellere Verarbeitung
• Überwachen Sie die Kreditverwendung und stellen Sie Benachrichtigungen ein

🛡️ Fehlerbehandlung

• Implementieren Sie eine Wiederholungslogik mit exponentiellem Backoff
• Validieren Sie Parameter vor API-Aufrufen
• Behandeln Sie die Geschwindigkeitsbegrenzung ordnungsgemäß
• Protokollieren Sie Fehler mit Kontext zum Debuggen
• Stellen Sie Fallback-Optionen für fehlgeschlagene Generationen bereit

🚨 Häufige JSON-Fehler und Lösungen

❌ Ungültige JSON-Syntax


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


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

❌ Ungültige Parameterwerte


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


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

❌ Fehlende Pflichtfelder


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


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

❌ Widersprüchliche Parameter


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


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

Gebrauchsfertig JSON-Eingabeaufforderungen?

Beginnen Sie mit der Integration der strukturierten Videogenerierung in Ihre Anwendungen. Erhalten Sie API-Zugriff und beginnen Sie mit der präzisen Steuerung.

📖 API-Doku 🎁 Holen Sie sich den Schlüssel API kostenlos

Kostenlose API Credit-Pakete • Professioneller Support • Enterprise-Optionen verfügbar