Veo 3 Solicitações JSON

Mestre estruturado incitars para controle preciso sobre a geração de vídeo AI. Perfeito para integração Referência da API, processamento em lote e fluxos de trabalho profissionais.

🔧 Aprenda Formato JSON 📚 Documentação API

Noções básicas de JSON Parâmetros Exemplos Integração de API Melhores Práticas

Fundamentos do prompt JSON

Por que usar JSON prompts?

Controle Preciso

Especifique parâmetros exatos para obter resultados consistentes e previsíveis em diversas gerações.

Pronto para API

Perfeito para geração programática de vídeo e fluxos de trabalho automatizados.

Reproduzível

Salve e reutilize configurações bem-sucedidas para processamento em lote.

Controle de versão

Acompanhe as alterações e colabore incitar configurações de forma eficaz.

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

Obrigatório: incitar (corda)

Opcional: Todos os outros parâmetros têm padrões

Formato: É necessária uma sintaxe JSON válida

Referência completa de parâmetros

🎯 Núcleo Parâmetros

incitar

Descrição principal do conteúdo do vídeo

string (required)

estilo

Visual geral estilo e estético

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

qualidade

Resolução de saída e nível de detalhe

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

duração

Especificação de duração do vídeo

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

📹 Controle da câmera

camera.type

Enquadramento e perspectiva da cena

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

camera.movement

Movimento e dinâmica da câmera

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

camera.angle

Posicionamento vertical em relação ao assunto

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

camera.lens

Características da lente e distância focal

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

🎨 Controle de cena

iluminação

Condições de iluminação e clima

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

humor

Tom emocional e atmosfera

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

color_palette

Esquema de cores e classificação

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

aspect_ratio

Dimensões e formato do vídeo

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

JSON Prompt Exemplos

🎬 Cena 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: Sequências de ação, comerciais de carros

Principais recursos: Amplo formato cinematográfico, rastreamento aéreo

👤 Retrato Profissional

{
  "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, perfis do LinkedIn

Principais recursos: Iluminação de estúdio, lente de retrato

📱 Vitrine de Produtos

{
  "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 produto, comércio eletrônico

Principais recursos: Câmera orbital, fundo limpo

🎨 Movimento abstrato

{
  "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 musicais, conteúdo artístico

Principais recursos: Efeitos especiais, câmera lenta

🎭 JSON multicena avançado

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

Dica profissional: JSON multicena permite narrativas complexas com controle preciso sobre cada segmento.

Integração de API Guia

🌐 Exemplo de solicitação 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 resposta

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

🐍 Integração Python

import requests
import json

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

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

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

📱 Exemplo 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 = {
  incitar: "Time lapse of city skyline transition from day to night",
  estilo: "cinematic",
  camera: { type: "wide_shot", movement: "static" },
  iluminação: "day_to_night",
  duração: "20s",
  qualidade: "4k"
};

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

Práticas recomendadas de prompt JSON

✅ Diretrizes de Estrutura

• Sempre valide a sintaxe JSON antes de enviar
• Use convenções de nomenclatura de parâmetros consistentes
• Agrupar parâmetros relacionados logicamente (câmera, iluminação)
• Incluir comentários no desenvolvimento (faixa para produção)
• Teste primeiro com parâmetros mínimos

⚡ Dicas de desempenho

• Armazenar em cache configurações bem-sucedidas para reutilização
• Use webhooks em vez de pesquisar status
• Agrupe solicitações semelhantes em lote quando possível
• Otimizar incitar comprimento para processamento mais rápido
• Monitore o uso de crédito e defina alertas

🛡️ Tratamento de erros

• Implementar lógica de repetição com espera exponencial
• Valide parâmetros antes de chamadas de API
• Lidar com a limitação de taxa normalmente
• Registrar falhas com contexto para depuração
• Forneça opções de fallback para gerações com falha

🚨 Erros e soluções JSON comuns

❌ Sintaxe JSON inválida


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


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

❌ Valores de parâmetros inválidos


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


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

❌ Campos obrigatórios ausentes


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


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

❌ Parâmetros conflitantes


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


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

Pronto para usar Solicitações JSON?

Comece a integrar a geração de vídeo estruturado em seus aplicativos. Obtenha acesso à API e comece a criar com controle preciso.

📚 Documentação API 🎁 Obtenha a chave API gratuitamente

Créditos de API gratuitos • Suporte profissional • Opções empresariais disponíveis