Generación de Video Veo
Genera videos con IA a través de la API de Google Veo de AceDataCloud.
Configuración: Consulta autenticación para configurar el token.
Inicio Rápido
curl -X POST https://api.acedata.cloud/veo/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"action": "text2video", "prompt": "una ballena emergiendo en cámara lenta durante la hora dorada", "model": "veo3", "callback_url": "https://api.acedata.cloud/health"}'
Asíncrono: Consulta sondeo de tareas asíncronas. Sondea mediante
POST /veo/taskscon{"id": "..."}. Esto devuelve un ID de tarea de inmediato. Sondea para obtener el resultado:
curl -X POST https://api.acedata.cloud/veo/tasks \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"id": "<task_id del comando anterior>"}'
Modelos
| Modelo | Audio | Mejor Para |
|---|---|---|
veo2 | No | Generación rentable |
veo2-fast | No | Generación rápida y rentable (predeterminado) |
veo3 | Sí (nativo) | Generación audiovisual completa |
veo3-fast | Sí (nativo) | Generación audiovisual más rápida |
veo31 | Sí (nativo) | Veo 3.1, máxima calidad |
veo31-fast | Sí (nativo) | Variante rápida de Veo 3.1 |
veo31-fast-ingredients | Sí (nativo) | Veo 3.1 rápida, modo ingredientes |
Flujos de Trabajo
1. Texto a Video
POST /veo/videos
{
"action": "text2video",
"prompt": "toma aérea cinematográfica de la Aurora Boreal sobre Islandia",
"model": "veo3",
"resolution": "1080p"
}
2. Imagen a Video
Anima imágenes fijas a video.
POST /veo/videos
{
"action": "image2video",
"prompt": "la escena cobra vida suavemente con viento y movimiento sutil",
"image_urls": ["https://example.com/landscape.jpg"],
"model": "veo2",
"aspect_ratio": "16:9"
}
3. Ingredientes a Video (Combinación Multi-Imagen)
Combina de 1 a 3 imágenes de referencia en un video (solo veo31-fast-ingredients).
POST /veo/videos
{
"action": "ingredients2video",
"image_urls": [
"https://example.com/img1.jpg",
"https://example.com/img2.jpg"
],
"model": "veo31-fast-ingredients"
}
4. Mejora a 1080p
Convierte un video generado previamente a resolución 1080p completa.
POST /veo/videos
{
"action": "get1080p",
"video_id": "tu-id-de-video",
"model": "veo3"
}
Parámetros
| Parámetro | Valores | Descripción |
|---|---|---|
action | "text2video", "image2video", "ingredients2video", "get1080p" | Modo de generación |
model | consultar tabla de Modelos | Modelo a usar (predeterminado: veo2-fast) |
resolution | "4k", "1080p", "gif" | Resolución de salida (predeterminado: 720p) |
aspect_ratio | "16:9", "9:16", "1:1", "4:3", "3:4" | Relación de aspecto — solo válido para image2video |
image_urls | arreglo de strings | URLs de imágenes de referencia — para image2video (hasta 2) o ingredients2video (hasta 3) |
video_id | string | Video a mejorar — solo para get1080p |
translation | true / false | Traducir automáticamente el prompt al inglés (predeterminado: false) |
Endpoints Posteriores a la Generación
Después de generar un video, usa estos endpoints para procesarlo más:
Mejora de Muestra (POST /veo/upsample)
Mejora un video generado a 1080p, 4K, o conviértelo a GIF.
POST /veo/upsample
{
"video_id": "tu-id-de-video",
"action": "4k"
}
| Parámetro | Valores | Descripción |
|---|---|---|
video_id | string | ID de tarea de /veo/videos, /veo/extend, /veo/reshoot, o /veo/objects |
action | "1080p", "4k", "gif" | Objetivo de mejora |
Extender (POST /veo/extend)
Continúa un video existente — la IA genera automáticamente el siguiente segmento.
POST /veo/extend
{
"video_id": "tu-id-de-video",
"model": "veo31-fast",
"prompt": "la cámara se aleja lentamente"
}
| Parámetro | Valores | Descripción |
|---|---|---|
video_id | string | ID de tarea de /veo/videos o una extensión anterior /veo/extend |
model | "veo31-fast", "veo31" | Solo se admite la serie Veo 3.1 |
prompt | string | Opcional: guía el segmento extendido |
Re-grabar (POST /veo/reshoot)
Re-renderiza un video manteniendo el mismo contenido pero aplicando un nuevo movimiento de cámara.
POST /veo/reshoot
{
"video_id": "tu-id-de-video",
"motion_type": "LEFT_TO_RIGHT"
}
| Parámetro | Valores | Descripción |
|---|---|---|
video_id | string | ID de tarea de /veo/videos (no se puede usar la salida de /veo/extend) |
motion_type | consultar tabla abajo | Movimiento de cámara a aplicar |
Valores de motion_type:
STATIONARY, STATIONARY_UP, STATIONARY_DOWN, STATIONARY_LEFT, STATIONARY_RIGHT, STATIONARY_DOLLY_IN_ZOOM_OUT, STATIONARY_DOLLY_OUT_ZOOM_IN, UP, DOWN, LEFT_TO_RIGHT, RIGHT_TO_LEFT, FORWARD, BACKWARD, DOLLY_IN_ZOOM_OUT, DOLLY_OUT_ZOOM_IN
Objetos (POST /veo/objects)
Inserta o elimina objetos en un video usando inpainting basado en máscaras.
POST /veo/objects
{
"video_id": "tu-id-de-video",
"action": "insert",
"prompt": "agrega un pájaro volando"
}
POST /veo/objects
{
"video_id": "tu-id-de-video",
"action": "remove",
"image_mask": "https://example.com/mask.jpg"
}
| Parámetro | Valores | Descripción |
|---|---|---|
video_id | string | ID de tarea (no se puede usar la salida de /veo/extend) |
action | "insert", "remove" | Tipo de operación |
prompt | string | Requerido para insert; opcional para remove |
image_mask | string | URL o JPEG en base64 — píxeles blancos = región objetivo. Requerido para remove; opcional para insert |
Advertencias
- Los modelos Veo 3 y 3.1 generan audio nativo —
veo2/veo2-fastNO admiten audio - La acción
get1080pusavideo_id(de una generación anterior), no una URL aspect_ratioes solo válido para la acciónimage2videoimage_urlsacepta un arreglo — hasta 2 imágenes paraimage2video, hasta 3 paraingredients2videoveo31-fast-ingredientsrequiere entrada de imagen — no puede hacer generación solo con textotranslation: truetraduce automáticamente prompts en chino u otros idiomas no ingleses antes de enviarlos a Veo- El sondeo de tareas usa
id(notask_id) en el cuerpo de la solicitud/veo/tasks - Los estados de tarea usan
"succeeded"(no "completed") — verifica este valor al sondear - La salida de
/veo/extendno puede usarse como entrada para/veo/reshooto/veo/objects
MCP:
pip install mcp-veo| Alojado:https://veo.mcp.acedata.cloud/mcp| Consulta todos los servidores MCP