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
})
});