Veo 3 JSON-forespørsler

Mester strukturert ledeteksts for presis kontroll over AI-videogenerering. Perfekt for API-referanse-integrasjon, batchbehandling og profesjonelle arbeidsflyter.

🔧 Lær JSON-format 📚 API-dokumentasjon

Grunnleggende om JSON Parametere Eksempler API-integrasjon Beste praksis

Grunnleggende om JSON-forespørsel

Hvorfor bruke JSON prompts?

Nøyaktig kontroll

Spesifiser nøyaktige parametere for konsistente, forutsigbare resultater over flere generasjoner.

API-klar

Perfekt for programmatisk videogenerering og automatiserte arbeidsflyter.

Reproduserbar

Lagre og gjenbruk vellykkede konfigurasjoner for batchbehandling.

Versjonskontroll

Spor endringer og samarbeid om ledetekst konfigurasjoner effektivt.

Grunnleggende JSON-struktur

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

Påkrevd: ledetekst (streng)

Valgfritt: Alle andre parametere har standardinnstillinger

Format: Gyldig JSON-syntaks kreves

Fullfør parameterreferanse

🎯 Kjerne Parametere

ledetekst

Hovedbeskrivelse av videoinnholdet

string (required)

stil

Generelt visuelt stil og estetisk

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

kvalitet

Utgangsoppløsning og detaljnivå

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

varighet

Spesifikasjon av videolengde

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

📹 Kamerakontroll

camera.type

Skudinnramming og perspektiv

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

camera.movement

Kamerabevegelse og dynamikk

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

camera.angle

Vertikal posisjonering i forhold til motivet

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

camera.lens

Objektivets egenskaper og brennvidde

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

🎨 Scenekontroll

belysning

Lysforhold og stemning

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

humør

Emosjonell tone og atmosfære

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

color_palette

Fargevalg og gradering

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

aspect_ratio

Videodimensjoner og format

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

JSON Prompt Eksempler

🎬 Kinematisk scene

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

Brukstilfelle: Actionsekvenser, bilreklamer

Nøkkelfunksjoner: Bredt filmformat, luftsporing

👤 Profesjonelt portrett

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

Brukstilfelle: Bedriftsvideoer, LinkedIn-profiler

Nøkkelfunksjoner: Studiobelysning, portrettobjektiv

📱 Produktutstilling

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

Brukstilfelle: Produktmarkedsføring, e-handel

Nøkkelfunksjoner: Orbital kamera, ren bakgrunn

🎨 Abstrakt bevegelse

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

Brukstilfelle: Musikkvideoer, kunstnerisk innhold

Nøkkelfunksjoner: Spesialeffekter, sakte film

🎭 Avansert Multi-Scene 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"
  }
}

Proff-tips: JSON med flere scener tillater komplekse fortellinger med presis kontroll over hvert segment.

API-integrasjon Veiledning

🌐 Eksempel på HTTP-forespørsel

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

Svarformat

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

import requests
import json

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

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

Statusavstemning

# 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 Eksempel

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 = {
  ledetekst: "Time lapse of city skyline transition from day to night",
  stil: "cinematic",
  camera: { type: "wide_shot", movement: "static" },
  belysning: "day_to_night",
  varighet: "20s",
  kvalitet: "4k"
};

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

JSON-forespørsler om gode fremgangsmåter

✅ Strukturretningslinjer

• Valider alltid JSON-syntaks før sending
• Bruk konsistente parameternavnekonvensjoner
• Grupper relaterte parametere logisk (kamera, belysning)
• Inkluder kommentarer i utviklingen (strimmel for produksjon)
• Test med minimale parametere først

⚡ Ytelsestips

• Buffer vellykkede konfigurasjoner for gjenbruk
• Bruk webhooks i stedet for polling for status
• Batch lignende forespørsler når det er mulig
• Optimaliser ledetekst lengde for raskere behandling
• Overvåk kredittbruk og angi varsler

🛡️ Feilhåndtering

• Implementer forsøkslogikk på nytt med eksponentiell backoff
• Valider parametere før API-kall
• Håndter hastighetsbegrensning på en elegant måte
• Loggfeil med kontekst for feilsøking
• Gi reservealternativer for mislykkede generasjoner

🚨 Vanlige JSON-feil og løsninger

❌ Ugyldig JSON-syntaks


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


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

❌ Ugyldige parameterverdier


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


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

❌ Manglende obligatoriske felt


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


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

❌ Motstridende parametere


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


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

Klar til bruk JSON-forespørsler?

Begynn å integrere generering av strukturert video i applikasjonene dine. Få API-tilgang og begynn å lage med presis kontroll.

📚 API-dokumentasjon 🎁 Få API-nøkkel gratis

Gratis API-kreditter • Profesjonell støtte • Enterprise-alternativer tilgjengelig