Veo 3 Avisos JSON

Master estructurado inmediatos para un control preciso sobre la generación de Estudio UlazAI. Perfecto para integración Referencia API, procesamiento por lotes y flujos de trabajo profesionales.

🔧 Aprende Formato JSON 📚 Documentación API

Conceptos básicos de JSON Parámetros Ejemplos Integración API Mejores prácticas

Fundamentos del mensaje JSON

¿Por qué utilizar JSON prompt?

Control preciso

Especifique parámetros exactos para obtener resultados consistentes y predecibles en varias generaciones.

Listo para API

Perfecto para generación de videos programáticos y flujos de trabajo automatizados.

Reproducible

Guarde y reutilice configuraciones exitosas para el procesamiento por lotes.

Control de versiones

Realice un seguimiento de los cambios y colabore en inmediato configuraciones de manera efectiva.

Estructura JSON básica

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

Requerido: inmediato (cadena)

Opcional: Todos los demás parámetros tienen valores predeterminados.

Formato: Se requiere sintaxis JSON válida

Referencia completa de parámetros

🎯 Núcleo Parámetros

inmediato

Descripción principal del contenido del vídeo.

string (required)

estilo

Visual general estilo y estético

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

calidad

Resolución de salida y nivel de detalle.

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

duración

Especificación de duración del vídeo

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

📹 Control de cámara

camera.type

Encuadre y perspectiva

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

camera.movement

Movimiento y dinámica de la cámara.

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

camera.angle

Posicionamiento vertical en relación con el sujeto.

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

camera.lens

Características de la lente y distancia focal.

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

🎨 Control de escena

iluminación

Condiciones de iluminación y estado de ánimo.

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

ánimo

Tono y atmósfera emocional.

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

color_palette

Esquema de colores y clasificación

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

aspect_ratio

Dimensiones y formato del vídeo.

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

JSON Prompt Ejemplos

🎬 Escena cinematográfica

{
  "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 de uso: Secuencias de acción, anuncios de coches.

Características clave: Amplio formato cinematográfico, seguimiento aéreo.

👤 Retrato 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"
}

Caso de uso: Vídeos corporativos, perfiles de LinkedIn

Características clave: Iluminación de estudio, lente de retrato.

📱 Muestra de productos

{
  "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 de uso: Marketing de productos, comercio electrónico.

Características clave: Cámara orbital, fondo limpio.

🎨 Movimiento abstracto

{
  "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 de uso: Vídeos musicales, contenido artístico.

Características clave: Efectos especiales, cámara lenta.

🎭 JSON multiescena avanzado

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

Consejo profesional: JSON multiescena permite narrativas complejas con un control preciso sobre cada segmento.

Integración API Guía

🌐 Ejemplo de solicitud 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 de respuesta

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

🐍 Integración de Python

import requests
import json

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

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

Encuesta de estado

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

📱 Ejemplo de 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 = {
  inmediato: "Time lapse of city skyline transition from day to night",
  estilo: "cinematic",
  camera: { type: "wide_shot", movement: "static" },
  iluminación: "day_to_night",
  duración: "20s",
  calidad: "4k"
};

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

Mejores prácticas de avisos JSON

✅ Pautas de estructura

• Valide siempre la sintaxis JSON antes de enviar
• Utilice convenciones de nomenclatura de parámetros coherentes
• Agrupar parámetros relacionados de forma lógica (cámara, iluminación)
• Incluir comentarios en desarrollo (tira para producción)
• Pruebe primero con parámetros mínimos

⚡ Consejos de rendimiento

• Almacenar en caché las configuraciones exitosas para su reutilización
• Utilice webhooks en lugar de realizar encuestas sobre el estado
• Agrupe solicitudes similares cuando sea posible
• Optimizar inmediato longitud para un procesamiento más rápido
• Supervise el uso del crédito y establezca alertas

🛡️ Manejo de errores

• Implementar lógica de reintento con retroceso exponencial
• Validar parámetros antes de llamadas a API
• Manejar la limitación de velocidad con gracia
• Registrar fallas con contexto para depurar
• Proporcionar opciones alternativas para las generaciones fallidas.

🚨 Errores y soluciones JSON comunes

❌ Sintaxis JSON no válida


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


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

❌ Valores de parámetros no válidos


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


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

❌ Faltan campos obligatorios


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


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

❌ Parámetros en conflicto


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


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

Listo para usar Avisos JSON?

Comience a integrar la generación de video estructurado en sus aplicaciones. Obtenga acceso API y comience a crear con un control preciso.

📚 Documentación API 🎁 Obtenga clave API gratis

Créditos API gratuitos • Soporte profesional • Opciones empresariales disponibles