Veo 3 Προτροπές JSON

Master δομημένο ταχύςs για ακριβή έλεγχο στη δημιουργία βίντεο AI. Ιδανικό για ενσωμάτωση Αναφορά API, επεξεργασία παρτίδων και επαγγελματικές ροές εργασίας.

🔧 Μάθε Μορφή JSON 📚 Τεκμηρίωση API

Βασικά στοιχεία JSON Παράμετροι Παραδείγματα Ενσωμάτωση API Βέλτιστες Πρακτικές

JSON Prompt Fundamentals

Γιατί να χρησιμοποιήσετε τα JSON prompt;

Ακριβής Έλεγχος

Καθορίστε ακριβείς παραμέτρους για συνεπή, προβλέψιμα αποτελέσματα σε πολλές γενιές.

Έτοιμο API

Ιδανικό για δημιουργία βίντεο μέσω προγραμματισμού και αυτοματοποιημένες ροές εργασίας.

Αναπαραγώγιμος

Αποθηκεύστε και επαναχρησιμοποιήστε επιτυχημένες διαμορφώσεις για ομαδική επεξεργασία.

Έλεγχος έκδοσης

Παρακολουθήστε τις αλλαγές και συνεργαστείτε ταχύς διαμορφώσεις αποτελεσματικά.

Βασική δομή JSON

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

Απαιτείται: ταχύς (χορδή)

Προαιρετικά: Όλες οι άλλες παράμετροι έχουν προεπιλογές

Μορφή: Απαιτείται έγκυρη σύνταξη JSON

Πλήρης αναφορά παραμέτρων

🎯 Πυρήνας Παράμετροι

ταχύς

Κύρια περιγραφή του περιεχομένου του βίντεο

string (required)

στυλ

Συνολική οπτική στυλ και αισθητική

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

ποιότητα

Ανάλυση εξόδου και επίπεδο λεπτομέρειας

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

διάρκεια

Προδιαγραφή μήκους βίντεο

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

📹 Έλεγχος κάμερας

camera.type

Καδράρισμα και προοπτική λήψης

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

camera.movement

Κίνηση και δυναμική κάμερας

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

camera.angle

Κάθετη τοποθέτηση σε σχέση με το θέμα

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

camera.lens

Χαρακτηριστικά φακού και εστιακή απόσταση

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

🎨 Έλεγχος σκηνής

φωτισμός

Συνθήκες φωτισμού και διάθεση

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

διάθεση

Συναισθηματικός τόνος και ατμόσφαιρα

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

color_palette

Χρωματικός συνδυασμός και ταξινόμηση

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

aspect_ratio

Διαστάσεις και μορφή βίντεο

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

JSON Prompt Παραδείγματα

🎬 Κινηματογραφική Σκηνή

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

Περίπτωση χρήσης: Σεκάνς δράσης, διαφημίσεις αυτοκινήτων

Βασικά χαρακτηριστικά: Ευρεία κινηματογραφική μορφή, εναέρια παρακολούθηση

👤 Επαγγελματικό πορτρέτο

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

Περίπτωση χρήσης: Εταιρικά βίντεο, προφίλ LinkedIn

Βασικά χαρακτηριστικά: Φωτισμός στούντιο, πορτραίτο φακό

📱 Έκθεση προϊόντων

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

Περίπτωση χρήσης: Μάρκετινγκ προϊόντων, ηλεκτρονικό εμπόριο

Βασικά χαρακτηριστικά: Τροχιακή κάμερα, καθαρό φόντο

🎨 Αφηρημένη κίνηση

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

Περίπτωση χρήσης: Μουσικά βίντεο, καλλιτεχνικό περιεχόμενο

Βασικά χαρακτηριστικά: Ειδικά εφέ, αργή κίνηση

🎭 Προηγμένο 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"
  }
}

Επαγγελματική συμβουλή: Το JSON πολλαπλών σκηνών επιτρέπει σύνθετες αφηγήσεις με ακριβή έλεγχο σε κάθε τμήμα.

Ενσωμάτωση API Οδηγός

🌐 Παράδειγμα αιτήματος 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"
  }'

Μορφή απόκρισης

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

import requests
import json

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

# JSON ταχύς 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']}")

Δημοσκόπηση κατάστασης

# 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

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 = {
  ταχύς: "Time lapse of city skyline transition from day to night",
  στυλ: "cinematic",
  camera: { type: "wide_shot", movement: "static" },
  φωτισμός: "day_to_night",
  διάρκεια: "20s",
  ποιότητα: "4k"
};

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

Βέλτιστες πρακτικές JSON Prompt

✅ Οδηγίες δομής

• Να επικυρώνετε πάντα τη σύνταξη JSON πριν την αποστολή
• Χρησιμοποιήστε συνεπείς συμβάσεις ονομασίας παραμέτρων
• Ομαδοποιήστε λογικά τις σχετικές παραμέτρους (κάμερα, φωτισμός)
• Συμπεριλάβετε σχόλια στην ανάπτυξη (λωρίδα για παραγωγή)
• Δοκιμή πρώτα με ελάχιστες παραμέτρους

⚡ Συμβουλές απόδοσης

• Αποθηκεύστε επιτυχείς διαμορφώσεις προσωρινής μνήμης για επαναχρησιμοποίηση
• Χρησιμοποιήστε webhook αντί για δημοσκόπηση για την κατάσταση
• Συγκεντρώστε παρόμοια αιτήματα όταν είναι δυνατόν
• Βελτιστοποίηση ταχύς μήκος για ταχύτερη επεξεργασία
• Παρακολουθήστε τη χρήση της πίστωσης και ορίστε ειδοποιήσεις

🛡️ Χειρισμός σφαλμάτων

• Εφαρμόστε τη λογική επανάληψης με εκθετική υποχώρηση
• Επικύρωση παραμέτρων πριν από κλήσεις API
• Χειριστείτε τον περιορισμό ρυθμών με χάρη
• Αποτυχίες καταγραφής με περιβάλλον για εντοπισμό σφαλμάτων
• Παρέχετε εναλλακτικές επιλογές για αποτυχημένες γενιές

🚨 Συνήθη σφάλματα και λύσεις JSON

❌ Μη έγκυρη σύνταξη JSON


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


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

❌ Μη έγκυρες τιμές παραμέτρων


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


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

❌ Λείπουν υποχρεωτικά πεδία


                            { "style": "cinematic" }     // Missing ταχύς


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

❌ Αντικρουόμενες παράμετροι


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


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

Έτοιμο για χρήση Προτροπές JSON?

Ξεκινήστε να ενσωματώνετε τη δημιουργία δομημένου βίντεο στις εφαρμογές σας. Αποκτήστε πρόσβαση στο API και ξεκινήστε τη δημιουργία με ακριβή έλεγχο.

📚 Τεκμηρίωση API 🎁 Αποκτήστε δωρεάν κλειδί API

Δωρεάν πιστώσεις API • Επαγγελματική υποστήριξη • Διαθέσιμες επιλογές επιχειρήσεων