Vai al contenuto

Documenti per sviluppatori UlazAI

Video precedente APIs

Endpoint video legacy e specializzati

Gli endpoint esistenti rimangono disponibili per la compatibilità. Copertura del nuovo modello e lo sviluppo di funzionalità attive sono incentrati su Video Studio API.

Impostazione predefinita consigliata per le nuove build: /api/v1/video-studio/generate/

Elenco degli endpoint legacy

Metodo Percorso Scopo
POST /api/v1/generate/video/ Legacy API-key endpoint (supports veo3_fast, veo3, kling_3_0, kling_3_0_motion_control).
OTTIENI /api/v1/generate/{generation_id}/ Legacy generation status endpoint for video and image jobs.
OTTIENI /api/v1/generate/history/ Legacy generation history endpoint.
POST /api/v1/sora/generate/text-to-video/ Sora 2 text-to-video API.
POST /api/v1/sora/generate/image-to-video/ Sora 2 image-to-video API.
POST /api/v1/sora/generate/storyboard/ Sora storyboard API.
OTTIENI /api/v1/sora/status/{task_id}/ Sora task status API.

Guida alla migrazione

Famiglia di percorsi attuale Ambito del modello attuale Sostituzione dello studio video
/api/v1/generate/video/ veo3_fast, veo3, kling_3_0, kling_3_0_motion_control POST /api/v1/video-studio/generate/ con model_slug per tutti i modelli video
/api/v1/sora/* Solo Sora POST /api/v1/video-studio/generate/ con model_slug=sora_2*
Documenti di atterraggio specifici del modello Dettagli del modello unico Utilizza matrice + documenti canonici API per il comportamento contrattuale condiviso

Endpoint degli strumenti Video Studio

Questi endpoint helper creano prompt strutturati e inviano lavori lo stesso flusso di generazione canonica.

Metodo Percorso Scopo
POST /api/v1/video-studio/tools/street-interview/generate/ Structured prompt helper for interview-style clips (API key or token auth).
POST /api/v1/video-studio/tools/ugc-ad-quick/generate/ Generate UGC ad videos from product and audience inputs (API key or token auth).
POST /api/v1/video-studio/tools/video-remix/generate/ Remix source image or source video into a new style direction (API key or token auth).

Snippet di riferimento

Flusso chiave API legacy

curl -X POST https://ulazai.com/api/v1/generate/video/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Luxury product teaser with moving camera",
    "video_model": "veo3_fast",
    "aspect_ratio": "16:9"
  }'

Flusso di controllo del movimento legacy

curl -X POST https://ulazai.com/api/v1/generate/video/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "No distortion, the character'\''s movements are consistent with the video.",
    "video_model": "kling_3_0_motion_control",
    "source_image_urls": ["https://example.com/character.png"],
    "video_urls": ["https://example.com/motion.mp4"],
    "character_orientation": "video",
    "quality_mode": "720p",
    "duration_seconds": 15
  }'

Sostituzione Canonical Video Studio (chiave API)

fetch("https://ulazai.com/api/v1/video-studio/generate/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY",
  },
  body: JSON.stringify({
    model_slug: "veo31_fast",
    prompt: "Luxury product teaser with moving camera",
    aspect_ratio: "16:9",
    duration_seconds: 8
  })
});