Veo 3 JSON-kehotteet

Mestarirakenteinen kehotes AI-videon luomisen tarkkaan hallintaan. Täydellinen API-viittaus-integraatioon, eräkäsittelyyn ja ammattimaisiin työnkulkuihin.

🔧 Opi JSON-muoto 📚 API-dokumentaatio

JSON-perusteet Parametrit Esimerkkejä API-integrointi Parhaat käytännöt

JSON-kehotteen perusteet

Miksi käyttää JSON prompts?

Tarkka ohjaus

Määritä tarkat parametrit johdonmukaisten, ennustettavien tulosten saamiseksi useiden sukupolvien ajalta.

API valmis

Täydellinen ohjelmalliseen videon luomiseen ja automatisoituihin työnkulkuihin.

Toistettavissa

Tallenna ja käytä uudelleen onnistuneita määrityksiä eräkäsittelyyn.

Versionhallinta

Seuraa muutoksia ja tee yhteistyötä kehote kokoonpanot tehokkaasti.

JSON-perusrakenne

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

Pakollinen: kehote (merkkijono)

Valinnainen: Kaikilla muilla parametreilla on oletusarvot

Muoto: Kelvollinen JSON-syntaksi vaaditaan

Täydellinen parametriviittaus

🎯 Ydin Parametrit

kehote

Pääkuvaus videosisällöstä

string (required)

tyyliin

Visuaalinen kokonaisuus tyyliin ja esteettinen

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

laatu

Lähtöresoluutio ja yksityiskohtataso

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

kesto

Videon pituuden erittely

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

📹 Kameran ohjaus

camera.type

Kuvan kehystys ja perspektiivi

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

camera.movement

Kameran liike ja dynamiikka

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

camera.angle

Pystysuuntainen sijainti suhteessa kohteeseen

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

camera.lens

Objektiivin ominaisuudet ja polttoväli

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

🎨 Scene Control

valaistus

Valaistusolosuhteet ja tunnelma

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

mielialaa

Tunnesävy ja tunnelma

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

color_palette

Värimaailma ja luokittelu

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

aspect_ratio

Videon mitat ja muoto

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

JSON Prompt Esimerkkejä

🎬 Elokuvallinen kohtaus

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

Käyttötapaus: Toimintajaksoja, automainoksia

Tärkeimmät ominaisuudet: Laaja elokuvaformaatti, ilmaseuranta

👤 Ammattimainen muotokuva

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

Käyttötapaus: Yritysvideot, LinkedIn-profiilit

Tärkeimmät ominaisuudet: Studiovalaistus, muotokuvalinssi

📱 Tuoteesittely

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

Käyttötapaus: Tuotemarkkinointi, sähköinen kaupankäynti

Tärkeimmät ominaisuudet: Orbital-kamera, puhdas tausta

🎨 Abstrakti liike

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

Käyttötapaus: Musiikkivideoita, taiteellista sisältöä

Tärkeimmät ominaisuudet: Erikoistehosteet, hidastettu esitys

🎭 Kehittynyt 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"
  }
}

Provinkki: Monen kohtauksen JSON mahdollistaa monimutkaisen kertomuksen, joka hallitsee tarkasti jokaista segmenttiä.

API-integrointi Opas

🌐 Esimerkki HTTP-pyynnöstä

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

Vastausmuoto

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

import requests
import json

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

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

Tilakysely

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

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 = {
  kehote: "Time lapse of city skyline transition from day to night",
  tyyliin: "cinematic",
  camera: { type: "wide_shot", movement: "static" },
  valaistus: "day_to_night",
  kesto: "20s",
  laatu: "4k"
};

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

JSON-kehotteen parhaat käytännöt

✅ Rakenneohjeet

• Tarkista aina JSON-syntaksi ennen lähettämistä
• Käytä johdonmukaisia parametrien nimeämiskäytäntöjä
• Ryhmittele liittyvät parametrit loogisesti (kamera, valaistus)
• Sisällytä kommentit kehitysvaiheeseen (nauha tuotantoa varten)
• Testaa ensin minimiparametreilla

⚡ Suoritusvinkkejä

• Tallenna onnistuneet kokoonpanot välimuistiin uudelleenkäyttöä varten
• Käytä webhookeja tilakyselyn sijaan
• Erota samanlaiset pyynnöt, jos mahdollista
• Optimoi kehote pituus nopeuttaa käsittelyä
• Valvo luottojen käyttöä ja aseta hälytyksiä

🛡️ Virheiden käsittely

• Toteuta uudelleenyrityslogiikka eksponentiaalisella perääntymisellä
• Tarkista parametrit ennen API-kutsuja
• Käsittele nopeuden rajoittamista sulavasti
• Kirjaa virheet virheenkorjauksen kontekstilla
• Tarjoa varavaihtoehtoja epäonnistuneille sukupolville

🚨 Yleisiä JSON-virheitä ja ratkaisuja

❌ Virheellinen JSON-syntaksi


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


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

❌ Virheelliset parametriarvot


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


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

❌ Pakolliset kentät puuttuvat


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


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

❌ Ristiriitaiset parametrit


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


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

Käyttövalmis JSON-kehotteet?

Aloita strukturoidun videon luomisen integrointi sovelluksiisi. Hanki API-käyttöoikeus ja aloita luominen tarkalla ohjauksella.

📚 API-dokumentaatio 🎁 Hanki API-avain ilmaiseksi

Ilmaiset API-pisteet • Ammattimainen tuki • Saatavilla olevat yritysvaihtoehdot