UlazAI – AI kép- és videóeszközök
Veo 3 JSON Prompts
Mester strukturált gyorss az AI-videó generálásának pontos vezérléséhez. Tökéletes a API hivatkozás integrációhoz, kötegelt feldolgozáshoz és professzionális munkafolyamatokhoz.
JSON Prompt Fundamentals
Miért érdemes a JSON prompt-t használni?
Precíz vezérlés
Határozzon meg pontos paramétereket a több generációra kiterjedő következetes, kiszámítható eredmények érdekében.
API kész
Tökéletes programozott videógeneráláshoz és automatizált munkafolyamatokhoz.
Reprodukálható
Mentse el és használja fel újra a sikeres konfigurációkat kötegelt feldolgozáshoz.
Verzióvezérlés
Kövesse nyomon a változásokat és működjön együtt gyors konfigurációk hatékonyan.
Alapvető JSON-struktúra
{
"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"
}
Kötelező: gyors (karakterlánc)
Nem kötelező: Az összes többi paraméter alapértelmezett
Formátum: Érvényes JSON szintaxis szükséges
Teljes paraméterreferencia
🎯 Core Paraméterek
gyors
A videótartalom fő leírása
string (required)
stílusban
Általános látvány stílusban és esztétikus
"cinematic" | "realistic" | "artistic" | "documentary"
minőség
Kimeneti felbontás és részletesség
"4k" | "hd" | "standard" | "high"
időtartama
Videó hosszának specifikációja
"5s" | "10s" | "15s" | "short" | "medium"
📹 Kameravezérlés
camera.type
A felvétel keretezése és perspektívája
"wide_shot" | "close_up" | "medium_shot" | "extreme_wide"
camera.movement
A kamera mozgása és dinamikája
"static" | "pan_left" | "pan_right" | "dolly_in" | "crane"
camera.angle
Függőleges elhelyezés a témához képest
"eye_level" | "low_angle" | "high_angle" | "birds_eye"
camera.lens
Az objektív jellemzői és a gyújtótávolság
"wide_angle" | "standard" | "telephoto" | "macro"
🎨 Jelenetvezérlés
világítás
Fényviszonyok és hangulat
"golden_hour" | "blue_hour" | "studio" | "natural" | "dramatic"
hangulat
Érzelmi hang és hangulat
"serene" | "energetic" | "mysterious" | "uplifting" | "dramatic"
color_palette
Színséma és osztályozás
"warm" | "cool" | "vibrant" | "muted" | "monochrome"
aspect_ratio
Videó méretei és formátuma
"16:9" | "9:16" | "1:1" | "21:9" | "4:3"
JSON Prompt Példák
🎬 Filmes jelenet
{
"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"
}
Használati eset: Akciósorozatok, autóreklámok
Főbb jellemzők: Széles moziformátum, légi követés
👤 Profi portré
{
"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"
}
Használati eset: Céges videók, LinkedIn profilok
Főbb jellemzők: Stúdió világítás, portré objektív
📱 Termékbemutató
{
"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"
}
Használati eset: Termékmarketing, e-kereskedelem
Főbb jellemzők: Orbitális kamera, tiszta háttér
🎨 Absztrakt mozgás
{
"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"
}
Használati eset: Zenei videók, művészi tartalom
Főbb jellemzők: Speciális effektusok, lassított felvétel
🎭 Speciális többjelenetű 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"
}
}
Pro tipp: A több jelenetből álló JSON összetett narratívákat tesz lehetővé az egyes szegmensek pontos szabályozásával.
API integráció Útmutató
🌐 Példa HTTP kérésre
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"
}'
Válasz formátum
{
"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 integráció
import requests
import json
# Your API configuration
API_KEY = "your_api_key_here"
BASE_URL = "https://ulazai.com/api/v1"
# JSON gyors 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']}")
Állapotlekérdezés
# 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 példa
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 = {
gyors: "Time lapse of city skyline transition from day to night",
stílusban: "cinematic",
camera: { type: "wide_shot", movement: "static" },
világítás: "day_to_night",
időtartama: "20s",
minőség: "4k"
};
client.generateVideo(videoConfig)
.then(result => console.log('Generation started:', result.job_id))
.catch(error => console.error('Error:', error.message));
JSON Prompt Best Practices
✅ Szerkezeti irányelvek
- • Küldés előtt mindig ellenőrizze a JSON-szintaxist
- • Használjon következetes paraméter-elnevezési konvenciókat
- • A kapcsolódó paraméterek logikai csoportosítása (kamera, világítás)
- • Megjegyzések belefoglalása a fejlesztésbe (szalag a gyártáshoz)
- • Először tesztelje minimális paraméterekkel
⚡ Teljesítmény tippek
- • Gyorsítótárazza a sikeres konfigurációkat az újrafelhasználáshoz
- • Állapotlekérdezés helyett használjon webhookot
- • Ha lehetséges, csoportosítsa össze a hasonló kéréseket
- • Optimalizálás gyors hossza a gyorsabb feldolgozás érdekében
- • Kövesse nyomon a hitelhasználatot és állítson be figyelmeztetéseket
🛡️ Hibakezelés
- • Valósítsa meg az újrapróbálkozási logikát exponenciális visszalépéssel
- • Érvényesítse a paramétereket az API-hívások előtt
- • Kezelje a sebességkorlátozást kecsesen
- • Hibák naplózása kontextussal a hibakereséshez
- • Biztosítson tartalék lehetőségeket a sikertelen generációk számára
🚨 Gyakori JSON-hibák és megoldások
❌ Érvénytelen JSON-szintaxis
{ "prompt": "Test", "quality": "4k", } // Trailing comma
{ "prompt": "Test", "quality": "4k" } // Correct
❌ Érvénytelen paraméterértékek
{ "quality": "super_high" } // Invalid value
{ "quality": "4k" } // Valid value
❌ Hiányzó kötelező mezők
{ "style": "cinematic" } // Missing gyors
{ "prompt": "Test video", "style": "cinematic" }
❌ Ellentmondó paraméterek
{ "mood": "serene", "style": "action" } // Conflicting
{ "mood": "energetic", "style": "action" } // Consistent
Használatra kész JSON Prompts?
Kezdje el a strukturált videógenerálás integrálását alkalmazásaiba. Szerezzen API-hozzáférést, és kezdje el a létrehozást precíz vezérléssel.
Ingyenes API-kreditek • Professzionális támogatás • Vállalati opciók állnak rendelkezésre