Saltar al contenido
UlazAI

Documentos para desarrolladores UlazAI

Estudio de vídeo API

Precios Panel estudio de imagen
PUBLICAR /api/v1/video-studio/generate/

Punto final de generación de video canónico

Utilice Video Studio para todos los modelos de vídeo actuales. Este punto final admite flujos de trabajo de texto a vídeo, de imagen a vídeo y específicos del modelo, como remezcla de vídeo.

Para integraciones dinámicas, obtenga capacidades de modelo de /api/v1/models/video/ antes de enviar cargas útiles de generación.

Las rutas recientes de Video Studio incluyen seedance_2_mini, kling_v3_turbo_t2v, kling_v3_turbo_i2v, video_lip_sync, omnihuman_1_5, happyhorse_t2v, happyhorse_i2v, happyhorse_r2v, y happyhorse_videoedit.
Autenticación: enviar Authorization: Bearer YOUR_API_KEY en cada solicitud.

Encuesta con /api/v1/video-studio/status/{job_id}/ y cargar reciente trabajos de /api/v1/video-studio/history/.

Solicitar contrato

campo Tipo Requerido Notas
model_slug cuerda si Debe coincidir con un modelo de slug de Video Studio registrado
prompt cuerda Generalmente Requerido para la mayoría de los modelos. El modo Storyboard puede comenzar solo con imágenes.
aspect_ratio cuerda No Debe ser una de las relaciones de aspecto del modelo seleccionado.
duration_seconds entero No Debe coincidir con una duración permitida para el modelo. Motion Control utiliza la duración del clip de movimiento para fijar el precio.
quality_mode cuerda No Requerido cuando el modelo define modos de calidad
input_image_urls matriz [cadena] Específico del modelo Se utiliza para modelos de imagen a vídeo. Algunos modelos requieren al menos una URL.
input_video_urls matriz [cadena] Específico del modelo Utilizado por remezclas de video y rutas de video fuente como wan_2_6_v2v, kling_3_0_motion_control, video_lip_sync, y happyhorse_videoedit.
seedance_mode cuerda Solo danza 2 uso text_to_video, first_frame, first_last_frame, o multimodal.
first_frame_url, last_frame_url cuerda Solo danza 2 Utilícelo para los modos Seedance 2 de primer fotograma y primer+último fotograma. URL públicas y asset:// Se aceptan identificaciones.
reference_image_urls, reference_video_urls, reference_audio_urls matriz [cadena] Específico del modelo Seedance 2 utiliza matrices de referencia multimodales. Rutas impulsadas por audio como video_lip_sync y omnihuman_1_5 utilizar reference_audio_urls para el discurso o locución de destino. URL públicas y asset:// Se aceptan identificaciones cuando el modelo seleccionado las admita.
character_orientation cuerda Específico del modelo Sólo control de movimiento. uso video para seguir la orientación del clip de movimiento o image para mantener el encuadre del personaje subido, con duraciones de 3 a 15 segundos.
sound booleano No Sólo se utiliza en modelos con soporte de audio.
return_last_frame, web_search booleano Solo danza 2 Banderas opcionales de Seedance 2 para devolver el último fotograma y habilitar la búsqueda web en el lado del modelo.
prompt_directory_optin booleano No El descuento del directorio se aplica solo a familias de modelos seleccionadas.
Para imágenes en persona real en Seedance 2, utilice el UlazAI Guía de activos de Seedance 2 y pasar el devuelto asset:// Identificación. Los archivos sin formato directos pueden fallar.

Selector de modelo

Elija un modelo para inspeccionar capacidades y generar automáticamente fragmentos de solicitudes.

Seedance 2.5 model_slug=seedance_2_5

4-30 second generation in 480p/720p with text, first-frame, first+last-frame, or multimodal mode. Supports up to 30 image, 10 video, and 10 audio references plus MP4/MOV output.

Motor: Seedance 2.5

Relaciones de aspecto: 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive

Duraciones: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 segundos

Modos de calidad: 480p, 720p, 1080p

Entradas: texto , imagen , vídeo

Créditos: 480p 4 no video input: 112, 480p 5 no video input: 140, 480p 6 no video input: 168, 480p 7 no video input: 196, +77 more

Fragmentos de solicitud en vivo

Los fragmentos a continuación siguen el modelo preestablecido seleccionado.

rizo (tecla API)

JavaScript (buscar)

Python (solicitudes)

Fragmentos de encuestas de estado

Estado de la encuesta por job_id hasta completed o failed.

rizo

JavaScript (buscar)

Python (solicitudes)

Ejemplos de respuesta

Éxito

{
  "success": true,
  "job_ids": ["8990f846-f6f0-4ff1-a298-d0a72d49e7ad"],
  "credits_remaining_total": 438
}

Error de validación

{
  "success": false,
  "error": "Invalid duration for this model"
}

Créditos insuficientes

{
  "success": false,
  "error": "Insufficient credits",
  "credits_required": 220,
  "credits_available": 94
}

Punto final de vídeo con clave API (heredado)

Si necesita videollamadas basadas en la clave API, utilice /api/v1/generate/video/. Ese camino apoya una conjunto de modelos limitado y está documentado en mapeo de video heredado.

Mapeo de vídeo heredado abierto Flujos de trabajo de estado abierto Abrir matriz de modelo de vídeo