Veo 3 Solicitări JSON

Master structurat prompts pentru control precis asupra generării UlazAI Studio. Perfect pentru integrarea Referință API, procesarea loturilor și fluxurile de lucru profesionale.

🔧 Învață Format JSON 📚 Documentația API

Bazele JSON Parametrii Exemple Integrare API Cele mai bune practici

Noțiuni fundamentale pentru promptul JSON

De ce să folosiți JSON prompt?

Control precis

Specificați parametrii exacti pentru rezultate consecvente și previzibile pe mai multe generații.

API Ready

Perfect pentru generarea video programatică și fluxurile de lucru automatizate.

Reproductibil

Salvați și reutilizați configurațiile de succes pentru procesarea în lot.

Controlul versiunilor

Urmăriți modificările și colaborați prompt configurații în mod eficient.

Structura JSON de bază

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

Necesar: prompt (șir)

Opțional: Toți ceilalți parametri au valori implicite

Format: Este necesară sintaxă JSON validă

Referință completă a parametrilor

🎯 Nucleu Parametrii

prompt

Descrierea principală a conținutului video

string (required)

stil

Vizual general stil si estetic

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

calitate

Rezoluție de ieșire și nivel de detaliu

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

durată

Specificația lungimii video

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

📹 Controlul camerei

camera.type

Încadrarea fotografiei și perspectivă

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

camera.movement

Mișcarea și dinamica camerei

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

camera.angle

Poziționare verticală față de subiect

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

camera.lens

Caracteristicile obiectivului și distanța focală

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

🎨 Controlul scenei

iluminat

Condițiile de iluminare și starea de spirit

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

starea de spirit

Ton emoțional și atmosferă

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

color_palette

Schema de culori și gradare

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

aspect_ratio

Dimensiunile și formatul video

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

JSON Prompt Exemple

🎬 Scenă cinematografică

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

Caz de utilizare: Secvențe de acțiune, reclame auto

Caracteristici cheie: Format cinematografic larg, urmărire aeriană

👤 Portret profesional

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

Caz de utilizare: Videoclipuri corporative, profiluri LinkedIn

Caracteristici cheie: Iluminare studio, obiectiv portret

📱 Vitrina de produse

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

Caz de utilizare: Marketing de produse, comerț electronic

Caracteristici cheie: Cameră orbitală, fundal curat

🎨 Mișcare abstractă

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

Caz de utilizare: Clipuri muzicale, conținut artistic

Caracteristici cheie: Efecte speciale, mișcare lentă

🎭 JSON avansat cu mai multe scene

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

Sfat pro: JSON multi-scenă permite narațiuni complexe cu control precis asupra fiecărui segment.

Integrare API Ghid

🌐 Exemplu de solicitare 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"
  }'

Format de răspuns

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

🐍 Integrare Python

import requests
import json

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

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

Sondaj de stare

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

📱 Exemplu 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 = {
  prompt: "Time lapse of city skyline transition from day to night",
  stil: "cinematic",
  camera: { type: "wide_shot", movement: "static" },
  iluminat: "day_to_night",
  durată: "20s",
  calitate: "4k"
};

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

Cele mai bune practici JSON Prompt

✅ Ghid de structură

• Validați întotdeauna sintaxa JSON înainte de a trimite
• Utilizați convenții coerente de denumire a parametrilor
• Grupați parametrii legați în mod logic (cameră, iluminare)
• Includeți comentarii în dezvoltare (bandă pentru producție)
• Testați mai întâi cu parametrii minimi

⚡ Sfaturi de performanță

• Memorați în cache configurațiile reușite pentru reutilizare
• Folosiți webhook-uri în loc să sondați starea
• Grupați solicitări similare atunci când este posibil
• Optimizați prompt lungime pentru o prelucrare mai rapidă
• Monitorizați utilizarea creditului și setați alerte

🛡️ Gestionarea erorilor

• Implementați logica de reîncercare cu backoff exponențial
• Validați parametrii înainte de apelurile API
• Gestionați cu grație limitarea ratei
• Înregistrați erorile cu context pentru depanare
• Oferiți opțiuni de rezervă pentru generațiile eșuate

🚨 Erori și soluții JSON comune

❌ Sintaxă JSON nevalidă


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


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

❌ Valori ale parametrilor nevalide


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


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

❌ Câmpuri obligatorii lipsesc


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


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

❌ Parametri conflictuali


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


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

Gata de utilizare Solicitări JSON?

Începeți să integrați generarea de videoclipuri structurate în aplicațiile dvs. Obțineți acces la API și începeți să creați cu un control precis.

📚 Documentația API 🎁 Obțineți cheia API gratuită

Credite API gratuite • Asistență profesională • Opțiuni pentru întreprinderi disponibile