Veo 3 Invites JSON

Maître structuré invites pour un contrôle précis de la génération vidéo AI. Parfait pour l'intégration du Référence API, le traitement par lots et les Flux AI de travail professionnels.

🔧 Apprendre Format JSON 📚Documentation API

Bases de JSON Paramètres Exemples Intégration d'API Meilleures pratiques

Principes fondamentaux de l'invite JSON

Pourquoi utiliser les JSON prompt ?

Contrôle précis

Spécifiez des paramètres exacts pour des résultats cohérents et prévisibles sur plusieurs générations.

Prêt pour l'API

Parfait pour la génération vidéo programmatique et les flux de travail automatisés.

Reproductible

Enregistrez et réutilisez les configurations réussies pour le traitement par lots.

Contrôle des versions

Suivez les modifications et collaborez sur invite configurations efficacement.

Structure JSON de 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"
}

Obligatoire : invite (chaîne)

Facultatif : Tous les autres paramètres ont des valeurs par défaut

Format : Syntaxe JSON valide requise

Référence complète des paramètres

🎯 Noyau Paramètres

invite

Description principale du contenu vidéo

string (required)

style

Visuel global style et esthétique

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

qualité

Résolution de sortie et niveau de détail

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

durée

Spécification de la longueur de la vidéo

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

📹 Contrôle de la caméra

camera.type

Cadrage et perspective du plan

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

camera.movement

Mouvement et dynamique de la caméra

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

camera.angle

Positionnement vertical par rapport au sujet

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

camera.lens

Caractéristiques de l'objectif et distance focale

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

🎨 Contrôle de scène

éclairage

Conditions d'éclairage et ambiance

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

humeur

Ton et atmosphère émotionnelle

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

color_palette

Schéma de couleurs et classement

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

aspect_ratio

Dimensions et format de la vidéo

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

JSON Prompt Exemples

🎬 Scène cinématographique

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

Cas d'utilisation : Séquences d'action, publicités automobiles

Principales caractéristiques : Format cinématique large, suivi aérien

👤Portrait professionnel

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

Cas d'utilisation : Vidéos d'entreprise, profils LinkedIn

Principales caractéristiques : Éclairage de studio, objectif portrait

📱 Vitrine de produits

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

Cas d'utilisation : Marketing produit, commerce électronique

Principales caractéristiques : Caméra orbitale, arrière-plan propre

🎨 Mouvement abstrait

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

Cas d'utilisation : Vidéoclips, contenu artistique

Principales caractéristiques : Effets spéciaux, ralenti

🎭 JSON multi-scènes avancé

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

Conseil de pro : JSON multi-scènes permet des récits complexes avec un contrôle précis sur chaque segment.

Intégration d'API Guider

🌐 Exemple de requête 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éponse

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

🐍 Intégration Python

import requests
import json

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

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

Sondage d'état

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

📱 Exemple 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 = {
  invite: "Time lapse of city skyline transition from day to night",
  style: "cinematic",
  camera: { type: "wide_shot", movement: "static" },
  éclairage: "day_to_night",
  durée: "20s",
  qualité: "4k"
};

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

Meilleures pratiques d'invite JSON

✅ Lignes directrices sur la structure

• Validez toujours la syntaxe JSON avant d'envoyer
• Utiliser des conventions de dénomination de paramètres cohérentes
• Regrouper logiquement les paramètres liés (caméra, éclairage)
• Inclure des commentaires dans le développement (bande pour la production)
• Testez d'abord avec des paramètres minimaux

⚡ Conseils de performances

• Mettre en cache les configurations réussies pour les réutiliser
• Utilisez des webhooks au lieu d'interroger le statut
• Regroupez les demandes similaires lorsque cela est possible
• Optimiser invite longueur pour un traitement plus rapide
• Surveillez l'utilisation du crédit et définissez des alertes

🛡️ Gestion des erreurs

• Implémenter une logique de nouvelle tentative avec une interruption exponentielle
• Valider les paramètres avant les appels d'API
• Gérer la limitation de débit avec élégance
• Consigner les échecs avec le contexte pour le débogage
• Fournir des options de secours pour les générations ayant échoué

🚨 Erreurs et solutions JSON courantes

❌ Syntaxe JSON invalide


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


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

❌ Valeurs de paramètres invalides


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


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

❌ Champs obligatoires manquants


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


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

❌ Paramètres contradictoires


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


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

Prêt à l'emploi Invites JSON?

Commencez à intégrer la génération de vidéos structurées dans vos applications. Obtenez l'accès au API et commencez à créer avec un contrôle précis.

📚Documentation API 🎁 Obtenez la clé API gratuitement

Crédits API gratuits • Assistance professionnelle • Options d'entreprise disponibles