Veo 3 Prompt JSON

Maestro strutturato richiestaAiuta a un controllo preciso sulla generazione di UlazAI Studio. Perfetto per l'integrazione Riferimento API, l'elaborazione batch e i flussi di lavoro professionali.

🔧 Impara Formato JSON 📚 Documentazione API

Nozioni di base su JSON Parametri Esempi Integrazione API Migliori pratiche

Nozioni di base sui prompt JSON

Perché utilizzare JSON prompt?

Controllo preciso

Specifica parametri esatti per risultati coerenti e prevedibili su più generazioni.

API pronta

Perfetto per la generazione di video programmatici e flussi di lavoro automatizzati.

Riproducibile

Salva e riutilizza le configurazioni riuscite per l'elaborazione batch.

Controllo della versione

Tieni traccia delle modifiche e collabora richiesta configurazioni in modo efficace.

Struttura JSON di base

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

Obbligatorio: richiesta (stringa)

Facoltativo: Tutti gli altri parametri hanno valori predefiniti

Formato: È richiesta una sintassi JSON valida

Riferimento completo ai parametri

🎯 Nucleo Parametri

richiesta

Descrizione principale del contenuto video

string (required)

stile

Visiva generale stile ed estetico

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

qualità

Risoluzione di uscita e livello di dettaglio

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

durata

Specifica della durata del video

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

📹 Controllo della fotocamera

camera.type

Inquadratura e prospettiva dello scatto

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

camera.movement

Movimento e dinamica della telecamera

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

camera.angle

Posizionamento verticale rispetto al soggetto

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

camera.lens

Caratteristiche dell'obiettivo e lunghezza focale

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

🎨 Controllo della scena

illuminazione

Condizioni di illuminazione e umore

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

Umore

Tono e atmosfera emotiva

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

color_palette

Combinazione di colori e classificazione

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

aspect_ratio

Dimensioni e formato video

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

JSON Prompt Esempi

🎬 Scena cinematografica

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

Caso d'uso: Sequenze d'azione, spot pubblicitari di automobili

Caratteristiche principali: Ampio formato cinematografico, tracciamento aereo

👤 Ritratto professionale

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

Caso d'uso: Video aziendali, profili LinkedIn

Caratteristiche principali: Illuminazione da studio, obiettivo per ritratti

📱 Vetrina prodotti

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

Caso d'uso: Marketing del prodotto, commercio elettronico

Caratteristiche principali: Fotocamera orbitale, sfondo pulito

🎨 Movimento astratto

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

Caso d'uso: Video musicali, contenuti artistici

Caratteristiche principali: Effetti speciali, rallentatore

🎭 JSON multiscena avanzato

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

Suggerimento da professionista: JSON multi-scena consente narrazioni complesse con un controllo preciso su ogni segmento.

Integrazione API Guida

🌐 Esempio di richiesta 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"
  }'

Formato della risposta

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

🐍 Integrazione Python

import requests
import json

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

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

Sondaggio sullo stato

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

📱 Esempio 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 = {
  richiesta: "Time lapse of city skyline transition from day to night",
  stile: "cinematic",
  camera: { type: "wide_shot", movement: "static" },
  illuminazione: "day_to_night",
  durata: "20s",
  qualità: "4k"
};

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

Procedure consigliate per i prompt JSON

✅ Linee guida sulla struttura

• Convalida sempre la sintassi JSON prima dell'invio
• Utilizzare convenzioni coerenti per la denominazione dei parametri
• Raggruppare logicamente i parametri correlati (telecamera, illuminazione)
• Includere commenti in fase di sviluppo (striscia per la produzione)
• Prova prima con parametri minimi

⚡ Suggerimenti sulle prestazioni

• Memorizza nella cache le configurazioni riuscite per il riutilizzo
• Utilizza i webhook invece del polling per lo stato
• Raggruppa richieste simili quando possibile
• Ottimizza richiesta lunghezza per un'elaborazione più rapida
• Monitora l'utilizzo del credito e imposta avvisi

🛡️ Gestione degli errori

• Implementa la logica dei tentativi con backoff esponenziale
• Convalida i parametri prima delle chiamate API
• Gestisci la limitazione della velocità con garbo
• Registra gli errori con il contesto per il debug
• Fornire opzioni di fallback per le generazioni fallite

🚨 Errori e soluzioni JSON comuni

❌ Sintassi JSON non valida


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


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

❌ Valori dei parametri non validi


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


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

❌ Campi obbligatori mancanti


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


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

❌Parametri contrastanti


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


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

Pronto per l'uso Prompt JSON?

Inizia a integrare la generazione di video strutturati nelle tue applicazioni. Ottieni l'accesso API e inizia a creare con un controllo preciso.

📚 Documentazione API 🎁 Ottieni la chiave API gratuitamente

Crediti API gratuiti • Supporto professionale • Opzioni aziendali disponibili