Jag ser 3 JSON-meddelanden

Grunderna i JSON-meddelanden

Varför använda JSON-meddelanden?

1

Exakt kontroll

Ange exakta parametrar för konsekventa, förutsägbara resultat över generationer.

2

API redo

Perfekt för programmatisk videogenerering och automatiserade arbetsflöden.

3

Reproducerbar

Spara och återanvänd framgångsrika batchbearbetningskonfigurationer.

4

Versionskontroll

Spåra och samarbeta om förändringar snabbt konfigurationer effektivt.

Grundläggande JSON-struktur

{
  "prompt": "Din detaljerade videobeskrivning",
  "style": "filmisk",
  "kamera": {
    "type": "wide_shot",
    "movement": "slow_pan"
  },
  "lighting": "golden_hour",
  "kvalitet": "4k",
  "duration": "10s",
  "aspect_ratio": "16:9"
}

Nödvändig: snabbt (sträng)

Frivillig: Alla andra parametrar har standardvärden

Formatera: Giltig JSON-syntax krävs

Komplett parameterreferens

🎯 Kern Parametrar

snabbt

Huvudbeskrivning av videoinnehållet

sträng (obligatoriskt)

stil

Generellt visuellt stil och estetisk

"filmisk" | "realistisk" | "konstnärlig" | "dokumentär"

kvalitet

Utdataupplösning och detaljnivå

"4k" | "hd" | "standard" | "hög"

varaktighet

Videolängdspecifikation

"5s" | "10s" | "15s" | "kort" | "medium"

📹Kamerans kontroller

camera.type

Inramning och perspektiv av bilden

"wide_shot" | "närbild" | "medium_shot" | "extremt_vid"

kamerarörelser

Kamerarörelser och dynamik

"statisk" | "pan_left" | "pan_right" | "dolly_in" | "kran"

kameravinkel

Vertikal positionering i förhållande till motivet

"ögonhöjd" | "låg_vinkel" | "hög_hörn" | "fågelperspektiv"

camera.lins

Objektivegenskaper och brännvidd

"vidvinkel" | "standard" | "telefoto" | "makro"

🎨 Scenkontroll

lättnad

Ljusförhållanden och atmosfär

"golden_hour" | "blå_timme" | "studio" | "naturligtvis" | "dramatisk"

härrörande

Känslomässig ton och atmosfär

"lugn" | "energisk" | "mystisk" | "upplyftande" | "dramatisk"

färgpalett

Färgsättning och sortering

"varm" | "cool" | "livlig" | "dämpad" | "svartvit"

aspekt_förhållande

Videodimensioner och format

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

JSON-prompt Exempel

🎬 Filmisk scen

{
  "prompt": "Flygbild av röda sportbilar som tävlar genom bergskurvor vid solnedgången",
  "style": "filmisk",
  "kamera": {
    "type": "antenn",
    "movement": "spårning",
    "angle": "high_angle"
  },
  "lighting": "golden_hour",
  "mood": "dramatisk",
  "kvalitet": "4k",
  "duration": "15s",
  "aspect_ratio": "21:9",
  "color_palette": "varm"
}

Användningsscenario: Actionscener, bilreklam

Huvudfunktioner: Brett filmformat, antennspårning

👤 Professionellt porträtt

{
  "prompt": "Professionell huvudbild av självsäker affärskvinna, varmt leende, ögonkontakt",
  "style": "realistisk",
  "kamera": {
    "type": "närbild",
    "movement": "statisk",
    "angle": "ögonnivå",
    "lins": "85mm"
  },
  "lighting": "studio",
  "mood": "professionell",
  "kvalitet": "4k",
  "duration": "8s",
  "aspect_ratio": "16:9",
  "color_palette": "neutral"
}

Användningsscenario: Företagsvideor, LinkedIn-profiler

Huvudfunktioner: Studiobelysning, porträttlins

📱 Produktutställning

{
  "prompt": "Snygg smartphone som roterar på vit yta, premiummaterial synligt",
  "style": "kommersiell",
  "kamera": {
    "type": "medium_shot",
    "rörelse": "omloppsbana",
    "angle": "slightly_low"
  },
  "lighting": "studio",
  "mood": "ren",
  "kvalitet": "4k",
  "duration": "10s",
  "aspect_ratio": "16:9",
  "color_palette": "minimal",
  "background": "ren_vit"
}

Användningsscenario: Produktmarknadsföring, e-handel

Huvudfunktioner: Orbital kamera, ren bakgrund

🎨Abstrakt rörelse

{
  "prompt": "Flytande abstrakta former omvandlas till livfulla neonfärger",
  "style": "konstnärlig",
  "kamera": {
    "type": "makro",
    "movement": "flytande",
    "angle": "dynamisk"
  },
  "lighting": "neon",
  "mood": "energisk",
  "kvalitet": "4k",
  "duration": "12s",
  "aspect_ratio": "16:9",
  "color_palette": "livlig",
  "effekter": ["glöd", "partikelsystem"],
  "speed": "slow_motion"
}

Användningsscenario: Musikvideor, konstnärligt innehåll

Huvudfunktioner: Specialeffekter, slow motion

🎭 Avancerad multi-scene JSON

{
  "projekt": {
    "title": "Kampanj för varumärkesberättelse",
    "total_duration": "45s",
    "aspect_ratio": "16:9",
    "kvalitet": "4k"
  },
  "scener": [
    {
      "id": "scene_1",
      "prompt": "Brett bild av modern kontorsbyggnad vid soluppgången",
      "style": "filmisk",
      "kamera": {
        "type": "extreme_wide",
        "movement": "slow_push_in",
        "angle": "slightly_low"
      },
      "verlichting": "ouden_uur",
      "duur": "8s",
      "stemming": "inspirerande"
    },
    {
      "id": "scene_2", 
      "prompt": "Medellång bild av olika team som samarbetar kring konferensbordet",
      "style": "realistisk",
      "kamera": {
        "type": "medium_shot",
        "movement": "subtil_pan",
        "angle": "eye_level"
      },
      "verlichting": "naturligt_kontor",
      "duur": "12s",
      "stemming": "professionell"
    },
    {
      "id": "scene_3",
      "prompt": "Närbild av händer som skriver på laptop, skärm som speglar innovation",
      "style": "kommersiell",
      "kamera": {
        "type": "makro",
        "movement": "statisk",
        "angle": "overhead"
      },
      "verlichting": "screen_glow", 
      "duur": "10s",
      "stemming": "gefokus"
    }
  ],
  "övergång": {
    "type": "fade",
    "duration": "1s"
  },
  "audio": {
    "style": "företagslyftande",
    "volym": "bakgrund"
  }
}

För ett tips: JSON med flera scener möjliggör komplext berättande med exakt kontroll över varje segment.

API-integration Guide

🌐 Exempel på HTTP-förfrågan

curl -X POST https://ulazai.com/api/v1/video/generate \
  -H "Auktorisering: Bärare YOUR_API_KEY" \
  -H "Innehållstyp: application/json" \
  -d '{
    "prompt": "Cinematisk flygbild av bergslandskap",
    "style": "filmisk", 
    "kamera": {
      "type": "antenn",
      "movement": "forward_dolly"
    },
    "kvalitet": "4k",
    "duration": "10s",
    "aspect_ratio": "16:9"
  }'

Svarsformat

{
  "framgång": sant,
  "job_id": "veo3_abc123def456",
  "status": "bearbetar",
  "estimated_time": "45s",
  "webhook_url": "https://din-app.com/webhook",
  "kostnad": {
    "krediter": 25,
    "resterande_saldo": 975
  }
}

🐍 Python-integration

importförfrågningar
importera json

# Din API-konfiguration
API_KEY = "din_api_nyckel_här"
BASE_URL = "https://ulazai.com/api/v1"

#JSON snabbt konfiguration
video_config = {
    "prompt": "Professionell produktdemovideo",
    "style": "kommersiell",
    "kamera": {
        "type": "medium_shot",
        "rörelse": "omloppsbana"
    },
    "lighting": "studio",
    "kvalitet": "4k",
    "duration": "15s"
}

# Skicka genereringsförfrågan
svar = requests.post(
    f"{BASE_URL}/video/generera",
    rubriker={
        "Authorization": f"Bärare {API_KEY}",
        "Content-Type": "applikation/json"
    },
    json=video_config
)

resultat = answer.json()
print(f"Jobb-ID: {result['job_id']}")
print(f"Status: {result['status']}")

Statuslager

# Kontrollera genereringsstatusen
status_response = requests.get(
    f"{BASE_URL}/video/status/{job_id}",
    headers={"Authorization": f"Bärare {API_KEY}"}
)

status_data = status_response.json()
if status_data['status'] == 'slutförd':
    video_url = status_data['video_url']
    print(f"Video redo: {video_url}")
elif status_data['status'] == 'misslyckades':
    print(f"Fel: {status_data['error_message']}")

📱 Exempel på JavaScript/Node.js

const axios = kräveren('axios');

klass UlazAIClient {
  konstruktor(apiKey) {
    this.apiKey = apiKey;
    this.baseURL = 'https://ulazai.com/api/v1';
  }

  asynkron genereraVideo(config) {
    prova {
      const response = await axios.post(`${this.baseURL}/video/generate`, config, {
        rubriker: {
          'Authorization': `Bärare ${this.apiKey}`,
          'Contenttype': 'applicatie/json'
        }
      });
      
      respons.data retourneren;
    } fånga (fout) {
      throw NEW Error(`Generation misslyckades: ${error.response.data.message}`);
    }
  }

  async getVideoStatus(jobId) {
    const response = await axios.get(`${this.baseURL}/video/status/${jobId}`, {
      headers: { 'Authorization': `Bearer ${this.apiKey}` }
    });
    
    respons.data retourneren;
  }
}

// Användsbild
const klient = ny UlazAIClient('uw_api_key');

const videoConfig = {
  snabbt: "Time-lapse av stadens skyline som övergår från dag till natt",
  stil: "filmisk",
  kamera: { typ: "wide_shot", rörelse: "statisk" },
  lättnad: "dag_till_natt",
  varaktighet: "20s",
  kvalitet: "4k"
};

client.generateVideo(videoConfig)
  .then(result => console.log('Generation startade:', result.job_id))
  .catch(error => console.error('Fel:', fel.meddelande));

Bästa metoder för JSON-meddelanden

✅ Strukturriktlinjer

• Validera alltid JSON-syntaxen innan du skickar in
• Använd konsekventa namnkonventioner för parametrar
• Gruppera relaterade parametrar logiskt (kamera, belysning)
• Spela in kommentarer under utveckling (serie för produktion)
• Testa med minimala parametrar först

⚡ Prestandatips

• Cachelagrade lyckade konfigurationer för återanvändning
• Använd webhooks istället för att söka efter status
• Samla in liknande förfrågningar om möjligt
• Optimera snabbt längd för snabbare bearbetning
• Övervaka kreditanvändning och ställ in varningar

🛡️ Felhantering

• Implementera logik för exponentiell backoff-försök
• Validera parametrar före API-anrop
• Hantera hastighetsbegränsningar ordentligt
• Logga fel med felsökningskontext
• Ge reservalternativ för misslyckade generationer

🚨 Vanliga JSON-fel och korrigeringar

❌ Ogiltig JSON-syntax


                            { "prompt": "Test", "quality": "4k", } // Efterföljande kommatecken


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

❌ Ogiltiga parametervärden


                            { "quality": "super_high" } // Ogiltigt värde


                            { "quality": "4k" } // Giltigt värde

❌ Obligatoriska fält saknas


                            { "style": "cinematic" } // Saknas snabbt


                            { "prompt": "Testvideo", "style": "filmisk" }

❌ Motstridiga parametrar


                            { "humör": "serene", "style": "action" } // Konflikt


                            { "mood": "energisk", "style": "action" } // Konsekvent

Färdig att använda JSON-meddelanden?

Börja integrera strukturerad videogenerering i dina applikationer. Få API-åtkomst och börja skapa med exakt kontroll.

📚 API dokumentation 🎁 Få en API-nyckel gratis

Gratis API-krediter • Professionell support • Företagsalternativ tillgängliga

UlazAI - AI Image & Video Tools