UlazAI - KI-Bild- & Video-Tools

Veo 3 JSON-Eingabeaufforderungen

Meistern Sie strukturierte prompts für eine präzise Steuerung der KI-Videoerzeugung. Perfekt für API-Integration, Stapelverarbeitung und professionelle Arbeitsabläufe.

🔧 Lernen JSON-Format 📚 API-Dokumentation
JSON-Grundlagen Parameter Beispiele API-Integration Best Practices

Grundlagen der JSON-Eingabeaufforderung

Warum verwenden? JSON-Eingabeaufforderungen?

1

Präzise Kontrolle

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

2

API-bereit

Perfekt für die programmatische Videogenerierung und automatisierte Workflows.

3

Reproduzierbar

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

4

Versionskontrolle

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

Grundlegende JSON-Struktur

{
  "prompt": "Your detailed video description",
  "style": "cinematic",
  "camera": {
    "type": "wide_shot",
    "movement": "slow_pan"
  },
  „lighting“: „golden_hour“,
  „Qualität“: „4k“,
  „Dauer“: „10s“,
  „aspect_ratio“: „16:9“
}

Erforderlich: prompt (Zeichenfolge)

Optional: Alle anderen Parameter haben Standardwerte

Format: Gültige JSON-Syntax erforderlich

Vollständige Parameterreferenz

🎯 Kern Parameter

prompt

Hauptbeschreibung des Videoinhalts

Zeichenfolge (erforderlich)

Stil

Insgesamt visuell Stil und ästhetisch

„filmisch“ | „realistisch“ | „künstlerisch“ | "Dokumentarfilm"

Qualität

Ausgabeauflösung und Detailstufe

„4k“ | „hd“ | „Standard“ | "hoch"

Dauer

Angabe der Videolänge

„5s“ | „10er“ | „15s“ | „kurz“ | "Medium"

📹 Kamerasteuerung

Kameratyp

Bildausschnitt und Perspektive

„wide_shot“ | "close_up" | „medium_shot“ | „extreme_wide“

Kamerabewegung

Kamerabewegung und Dynamik

„statisch“ | "pan_left" | "pan_right" | „dolly_in“ | "Kran"

Kamerawinkel

Vertikale Positionierung relativ zum Motiv

"eye_level" | "low_angle" | „high_angle“ | „birds_eye“

Kameraobjektiv

Objektiveigenschaften und Brennweite

"wide_angle" | „Standard“ | "Teleobjektiv" | "Makro"

🎨 Szenensteuerung

Beleuchtung

Lichtverhältnisse und Stimmung

„goldene_stunde“ | „blue_hour“ | „Studio“ | „natürlich“ | "dramatisch"

Stimmung

Emotionaler Ton und Atmosphäre

„ruhig“ | „energetisch“ | „geheimnisvoll“ | „erhebend“ | "dramatisch"

Farbpalette

Farbschema und Sortierung

„warm“ | „cool“ | „lebendig“ | „gedämpft“ | "einfarbig"

Aspektverhältnis

Videoabmessungen und -format

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

JSON-Eingabeaufforderung Beispiele

🎬 Kinomusik

{
  "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“,
  „Stimmung“: „dramatisch“,
  „Qualität“: „4k“,
  „Dauer“: „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"
  },
  „Beleuchtung“: „Studio“,
  „mood“: „professionell“,
  „Qualität“: „4k“,
  „Dauer“: „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"
  },
  „Beleuchtung“: „Studio“,
  „mood“: „sauber“,
  „Qualität“: „4k“,
  „Dauer“: „10s“,
  "aspect_ratio": "16:9",
  „color_palette“: „minimal“,
  „Hintergrund“: „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"
  },
  „Beleuchtung“: „Neon“,
  „Stimmung“: „energisch“,
  „Qualität“: „4k“,
  „Dauer“: „12s“,
  "aspect_ratio": "16:9",
  „color_palette“: „lebendig“,
  „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"
  },
  „Szenen“: [
    {
      "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“,
      „Dauer“: „8s“,
      „mood“: „inspirierend“
    },
    {
      "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“,
      „Dauer“: „12s“,
      „Stimmung“: „professionell“
    },
    {
      "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“, 
      „Dauer“: „10s“,
      „mood“: „konzentriert“
    }
  ],
  „Übergänge“: {
    "type": "fade",
    "duration": "1s"
  },
  „Audio“: {
    "style": "corporate_uplifting",
    "volume": "background"
  }
}

Als Tipp: Multiszenen-JSON ermöglicht komplexe Erzählungen mit präziser Kontrolle über jedes Segment.

API-Integration Führung

🌐 Beispiel für eine HTTP-Anfrage

curl -X POST https://ulazai.com/api/v1/video/generate \
  -H „Autorisierung: Inhaber YOUR_API_KEY“ \
  -H „Inhaltstyp: application/json“ \
  -d '{
    "prompt": "Cinematic aerial shot of mountain landscape",
    "style": "cinematic", 
    "camera": {
      "type": "aerial",
      "movement": "forward_dolly"
    },
    „Qualität“: „4k“,
    „Dauer“: „10s“,
    „aspect_ratio“: „16:9“
  }'

Antwortformat

{
  "success": true,
  "job_id": "veo3_abc123def456",
  "status": "processing",
  "estimated_time": "45s",
  "webhook_url": "https://your-app.com/webhook",
  "cost": {
    "credits": 25,
    "remaining_balance": 975
  }
}

🐍 Python-Integration

Importanfragen
json importieren

# Ihre API-Konfiguration
API_KEY = "your_api_key_here"
BASE_URL = "https://ulazai.com/api/v1"

# JSON prompt Konfiguration
video_config = {
    "prompt": "Professional product demo video",
    "style": "commercial",
    "camera": {
        "type": "medium_shot",
        "movement": "orbit"
    },
    „Beleuchtung“: „Studio“,
    „Qualität“: „4k“,
    „Dauer“: „15s“
}

# Generierungsanfrage senden
Antwort = Anfragen.post(
    f"{BASE_URL}/video/generate",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        „Content-Type“: „application/json“
    },
    json=video_config
)

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

Statusabfrage

# Generierungsstatus prüfen
status_response = request.get(
    f"{BASE_URL}/video/status/{job_id}",
    headers={"Authorization": f"Bearer {API_KEY}"}
)

status_data = status_response.json()
if status_data['status'] == 'abgeschlossen':
    video_url = status_data['video_url']
    print(f"Video bereit: {video_url}")
elif status_data['status'] == 'fehlgeschlagen':
    print(f"Fehler: {status_data['error_message']}")

📱 JavaScript/Node.js-Beispiel

const axios = require('axios');

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

  async genericVideo(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 (Fehler) {
      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;
  }
}

// Anwendungsbeispiel
const client = new UlazAIClient('your_api_key');

const videoConfig = {
  prompt: „Zeitraffer des Übergangs der Skyline der Stadt vom Tag zur Nacht“,
  Stil: „filmisch“,
  Kamera: { type: "wide_shot", movement: "static" },
  Beleuchtung: "day_to_night",
  Dauer: „20er“,
  Qualität: „4k“
};

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

Best Practices für JSON-Eingabeaufforderungen

✅ 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 prompt 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", } // Nachgestelltes Komma
{ "prompt": "Test", "quality": "4k" } // Richtig

❌ Ungültige Parameterwerte

{ "quality": "super_high" } // Ungültiger Wert
{ "quality": "4k" } // Gültiger Wert

❌ Fehlende Pflichtfelder

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

❌ Widersprüchliche Parameter

{ "mood": "serene", "style": "action" } // Widersprüchlich
{ "mood": "energetic", "style": "action" } // Konsistent

Gebrauchsfertig JSON-Eingabeaufforderungen?

Beginnen Sie mit der Integration der strukturierten Videogenerierung in Ihre Anwendungen. Erhalten Sie API-Zugriff und beginnen Sie mit der Erstellung mit präziser Kontrolle.

📚 API-Dokumentation 🎁 Holen Sie sich den API-Schlüssel kostenlos

Kostenlose API-credits • Professioneller Support • Enterprise-Optionen verfügbar