Saltar al contenido principal
Este documento presentará una guía sobre la integración de la API de generación de Veo Videos, que permite generar videos oficiales de Veo mediante la entrada de parámetros personalizados.

​
Proceso de solicitud

Para utilizar la API, primero debe ir a la página correspondiente de Veo Videos Generation API para solicitar el servicio correspondiente. Una vez en la página, haga clic en el botón “Acquire”, como se muestra en la imagen: Si aún no ha iniciado sesión o registrado, será redirigido automáticamente a la página de inicio de sesión, invitándolo a registrarse e iniciar sesión. Después de registrarse e iniciar sesión, será redirigido automáticamente a la página actual. En la primera solicitud, se otorgará un crédito gratuito que le permitirá utilizar la API de forma gratuita.

​
Uso básico

Primero, debe comprender la forma básica de uso, que consiste en ingresar la palabra clave prompt, la acción de generación action, el arreglo de imágenes de referencia de inicio y fin image_urls y el modelo model, para obtener el resultado procesado. Primero, necesita pasar un campo action, cuyo valor es text2video, que incluye principalmente tres acciones: generación de video a partir de texto (text2video), generación de video a partir de imágenes (image2video), y obtención de video en 1080p (get1080p). Luego, también necesitamos ingresar el modelo model, que actualmente incluye principalmente los modelos veo2, veo2-fast, veo3, veo31, veo31-fast, veo31-fast-ingredients y veo3-fast, con el siguiente contenido específico:

Aquí podemos ver que hemos configurado los encabezados de la solicitud, que incluyen:
  • accept: el formato de respuesta que desea recibir, aquí se establece como application/json, es decir, en formato JSON.
  • authorization: la clave para llamar a la API, que puede seleccionarse directamente después de la solicitud.
Además, se configuró el cuerpo de la solicitud, que incluye:
  • model: el modelo para generar el video, que incluye principalmente veo2, veo2-fast, veo3, veo31, veo31-fast, veo31-fast-ingredients y veo3-fast.
  • action: la acción de la tarea de generación de video, que incluye principalmente tres acciones: generación de video a partir de texto (text2video), generación de video a partir de imágenes (image2video), y obtención de video en 1080p (get1080p).
  • image_urls: cuando se elige la acción de generación de video a partir de imágenes image2video, es necesario cargar los enlaces de las imágenes de referencia de inicio y fin, con un máximo de tres imágenes de referencia.
  • resolution: seleccionar la resolución del video generado, donde el modelo veo31 admite resolución 4k, otros modelos no la admiten, todos los modelos admiten 1080p y resolución gif, si no se proporciona este valor, se utilizará por defecto la resolución 720p, que se divide principalmente en: 1080p, gif, 4k.
  • prompt: la palabra clave.
  • callback_url: la URL para recibir el resultado de la llamada.

​
📌 Resumen de la descripción del modelo

Nombre del modeloModos soportadosReglas de entrada de imágenes
veo2-fastGeneración de video a partir de texto (sin imagen)
Generación de video a partir de imagen (con imagen)		Solo admite 1 imagen → Modo de primer fotograma
veo3-fastGeneración de video a partir de texto (sin imagen)
Generación de video a partir de imagen (con imagen)		1 imagen → Modo de primer fotograma
3 imágenes → Modo de primer y último fotograma
veo31-fastGeneración de video a partir de texto (sin imagen)
Generación de video a partir de imagen (con imagen)		1 imagen → Modo de primer fotograma
3 imágenes → Modo de primer y último fotograma
veo31-fast-ingredients❌ Generación de video a partir de texto (no soportado)
✅ Fusión de múltiples imágenes obligatoria (debe enviar imagen)		1-3 imágenes → Modo de fusión de múltiples imágenes (máximo 3 imágenes)
veo2Generación de video a partir de texto (sin imagen)
Generación de video a partir de imagen (con imagen)		1 imagen → Modo de primer fotograma
3 imágenes → Modo de primer y último fotograma
veo3Generación de video a partir de texto (sin imagen)
Generación de video a partir de imagen (con imagen)		1 imagen → Modo de primer fotograma
3 imágenes → Modo de primer y último fotograma
veo31Generación de video a partir de texto (sin imagen)
Generación de video a partir de imagen (con imagen)		1 imagen → Modo de primer fotograma
3 imágenes → Modo de primer y último fotograma

​
🔑 Descripción de reglas clave

  1. Lógica general:
    • Sin entrada de imagen → Activa automáticamente el modo de generación de video a partir de texto.
    • Con entrada de imagen → Activa el modo de generación de video a partir de imagen (la acción específica depende de la cantidad de imágenes).
  2. Tipos de modo de generación de video a partir de imagen:
    • Modo de primer fotograma (1 imagen): el primer fotograma se fija en la imagen de entrada.
    • Modo de primer y último fotograma (2 imágenes): el primer y último fotograma se fijan en las imágenes de entrada.
    • Modo de fusión de múltiples imágenes (1-3 imágenes): solo soportado por veo31-fast-ingredients, fusiona el contenido de múltiples imágenes para generar un video.
  3. Clasificación de modos:
    • Modo Rápido: veo2-fast, veo3-fast, veo31-fast, veo31-fast-ingredients.
    • Modo de Calidad: veo2, veo3, veo31 (generación de mayor calidad).

​
⚠️ Consideraciones

  • Modelo que obliga a enviar imagen: veo31-fast-ingredients debe recibir imágenes (1-3 imágenes), de lo contrario, no podrá ejecutarse.
  • Límite de cantidad de imágenes:
    • Excepto veo31-fast-ingredients, otros modelos admiten un máximo de 3 imágenes de entrada.
Después de seleccionar, puede notar que también se generó el código correspondiente a la derecha, como se muestra en la imagen:

Haga clic en el botón “Try” para realizar pruebas, como se muestra en la imagen anterior, aquí obtuvimos el siguiente resultado: 
{
  "success": true,
  "task_id": "dd01fc69-e1f7-4b68-aa8c-463f6b748d11",
  "trace_id": "9906dac0-1516-41dc-9fe3-067ca1ba8269",
  "data": [
    {
      "id": "253eedc47f1c4eb2a370ed2312168f4b",
      "video_url": "https://platform.cdn.acedata.cloud/veo/dd01fc69-e1f7-4b68-aa8c-463f6b748d11.mp4",
      "created_at": "2025-07-25 16:07:43",
      "complete_at": "2025-07-25 16:10:28",
      "state": "succeeded"
    }
  ]
}
El resultado devuelto tiene varios campos, que se describen a continuación:
  • success，el estado de la tarea de generación de video en este momento.
  • task_id，el ID de la tarea de generación de video en este momento.
  • data，el resultado de la tarea de generación de video en este momento.
    • id，el ID del video de la tarea de generación de video en este momento.
    • video_url，el enlace del video de la tarea de generación de video en este momento.
    • created_at，la hora de creación de la tarea de generación de video en este momento.
    • complete_at，la hora de finalización de la tarea de generación de video en este momento.
    • state，el estado de la tarea de generación de video en este momento.
Se puede ver que hemos obtenido información de video satisfactoria, solo necesitamos obtener el video generado a partir de la dirección del enlace de video en el resultado data. Además, si se desea generar el código correspondiente, se puede copiar directamente, por ejemplo, el código de CURL es el siguiente: 
curl -X POST 'https://api.acedata.cloud/veo/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "text2video",
  "model": "veo2",
  "prompt": "Taza de café de cerámica blanca sobre una encimera de mármol brillante con luz de ventana de la mañana. La cámara rota lentamente 360 grados alrededor de la taza, deteniéndose brevemente en el asa."
}'

​
Función de generación de video a partir de imágenes

Si se desea generar un video a partir de imágenes de fotogramas inicial y final, se puede establecer el parámetro action como image2video y proporcionar un array de enlaces de imágenes de fotogramas inicial y final image_urls. A continuación, debemos completar el siguiente paso con las palabras clave que necesitamos expandir para personalizar la generación del video, especificando el siguiente contenido:
  • model：el modelo de generación de video, que incluye veo2, veo2-fast, veo3 y veo3-fast.
  • image_urls：cuando se elige la acción de generación de video image2video, se deben cargar los enlaces de las imágenes de referencia de fotogramas inicial y final.
  • prompt：palabras clave.
Un ejemplo de llenado es el siguiente:

Una vez completado, se generó automáticamente el siguiente código:

El código correspondiente en Python: 
import requests

url = "https://api.acedata.cloud/veo/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "action": "image2video",
    "model": "veo2",
    "prompt": "Déjalo bailar",
    "image_urls": ["https://cdn.acedata.cloud/7p1jhy.png"]
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)
Al hacer clic en ejecutar, se puede observar que se obtiene un resultado, como el siguiente: 
{
  "success": true,
  "task_id": "98e309f3-35bc-438d-8cb3-4015fc864b87",
  "trace_id": "8bc68066-36de-41ef-ae5e-b7d61ff6aee8",
  "data": [
    {
      "id": "59f12222b1fa4fbe9331ff2400ad1583",
      "video_url": "https://platform.cdn.acedata.cloud/veo/98e309f3-35bc-438d-8cb3-4015fc864b87.mp4",
      "created_at": "2025-07-25 16:13:07",
      "complete_at": "2025-07-25 16:16:12",
      "state": "succeeded"
    }
  ]
}
Se puede ver que el contenido del resultado es consistente con el anterior, lo que también logra la función de generación de video a partir de imágenes.

​
Función de obtención de video en 1080p

Si se desea obtener un video Veo ya generado en 1080p, se puede establecer el parámetro action como get1080p y proporcionar el ID del video que se necesita obtener en 1080p. El ID del video se obtiene según el uso básico, como se muestra en la siguiente imagen:

En este momento, se puede ver que el ID del video es: 
"id": "59f12222b1fa4fbe9331ff2400ad1583"
Nota: aquí el video_id en el video es el ID del video generado. Si no sabe cómo generar un video, puede consultar el uso básico anterior para generar un video.
A continuación, debemos completar el siguiente paso con las palabras clave que necesitamos expandir para personalizar la generación del video, especificando el siguiente contenido:
  • model：el modelo de generación de video, que incluye veo2, veo2-fast, veo3 y veo3-fast.
  • video_id：el ID del video de referencia, utilizado para obtener el video en 1080p.
Un ejemplo de llenado es el siguiente:

Una vez completado, se generó automáticamente el siguiente código:

Al hacer clic en ejecutar, se puede observar que se obtiene un resultado, como el siguiente: 
{
  "success": true,
  "task_id": "47a51cfe-2e24-4aba-93b3-546c2dc52984",
  "trace_id": "a8922eec-6f50-4f77-8104-00ded071d59d",
  "data": [
    {
      "id": "59f12222b1fa4fbe9331ff2400ad1583",
      "video_url": "https://platform.cdn.acedata.cloud/veo/47a51cfe-2e24-4aba-93b3-546c2dc52984.mp4",
      "created_at": "2025-07-25 16:13:07",
      "complete_at": "2025-07-25 16:16:12",
      "state": "succeeded"
    }
  ]
}
Se puede ver que el contenido del resultado es consistente con el anterior, lo que también logra la función de obtención de video en 1080p.

​
Generación de video con tamaño específico

Si se desea especificar la generación de un video Veo de tamaño personalizado, se puede establecer el parámetro aspect_ratio como el tamaño deseado. A continuación, debemos completar el siguiente paso con las palabras clave que necesitamos expandir para personalizar la generación del video, especificando el siguiente contenido:
  • model：el modelo de generación de video, que incluye veo2, veo2-fast, veo3 y veo3-fast.
  • aspect_ratio：el tamaño del video, actualmente soporta: 16:9, 16:9, 3:4, 4:3, 1:1, el valor predeterminado es 16:9.
  • translation：si se debe activar la traducción automática de las palabras clave, el valor predeterminado es false. Un ejemplo de llenado es el siguiente:

Una vez completado, se generó automáticamente el siguiente código:

Al hacer clic en ejecutar, se puede observar que se obtiene un resultado, como el siguiente: 
{
  "success": true,
  "task_id": "d2b93290-ab0e-4d20-ae45-60c062a32687",
  "trace_id": "9834e64d-c8fe-43ae-8114-ee2b5f93d886",
  "data": [
    {
      "id": "fc667e7d3b8f44beaa61a3c339af0e50",
      "video_url": "https://platform.cdn.acedata.cloud/veo/d2b93290-ab0e-4d20-ae45-60c062a32687.mp4",
      "created_at": "2025-08-24 20:09:06",
      "complete_at": "2025-08-24 20:10:45",
      "state": "succeeded"
    }
  ]
}
Se puede ver que el contenido del resultado es consistente con el anterior, lo que también logra la función de generar videos de tamaño específico.

​
Callback asíncrono

Dado que el tiempo de generación de la API de Veo Videos Generation es relativamente largo, aproximadamente de 1 a 2 minutos, si la API no responde durante mucho tiempo, la solicitud HTTP mantendrá la conexión, lo que provocará un consumo adicional de recursos del sistema, por lo que esta API también ofrece soporte para callbacks asíncronos. El flujo general es: cuando el cliente inicia la solicitud, especifica un campo adicional callback_url, después de que el cliente inicia la solicitud de la API, la API devolverá inmediatamente un resultado que incluye un campo de información task_id, que representa el ID de la tarea actual. Cuando la tarea se completa, el resultado del video generado se enviará al callback_url especificado por el cliente en formato JSON POST, que también incluye el campo task_id, de modo que el resultado de la tarea se pueda asociar mediante el ID. A continuación, entendamos cómo operar específicamente a través de un ejemplo. Primero, el callback de Webhook es un servicio que puede recibir solicitudes HTTP, los desarrolladores deben reemplazarlo con la URL de su propio servidor HTTP. Aquí, para facilitar la demostración, se utiliza un sitio web de muestra de Webhook público https://webhook.site/, al abrir este sitio se obtiene una URL de Webhook, como se muestra en la imagen: Copie esta URL y podrá usarla como Webhook, el ejemplo aquí es https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dc. A continuación, podemos establecer el campo callback_url como la URL de Webhook mencionada anteriormente, al mismo tiempo que llenamos los parámetros correspondientes, el contenido específico se muestra en la imagen:

Al hacer clic en ejecutar, se puede observar que se obtiene inmediatamente un resultado, como se muestra a continuación: 
{
  "task_id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed"
}
Después de un momento, podemos observar el resultado del video generado en https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dc, como se muestra en la imagen: El contenido es el siguiente: 
{
  "success": true,
  "task_id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed",
  "trace_id": "d1d53c04-58c5-4c40-bb63-f00188540e56",
  "data": [
    {
      "id": "2f43ceed37944b4d836e1a1899dad0a1",
      "video_url": "https://platform.cdn.acedata.cloud/veo/1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed.mp4",
      "created_at": "2025-07-25 17:19:20",
      "complete_at": "2025-07-25 17:21:45",
      "state": "succeeded"
    }
  ]
}
Se puede ver que en el resultado hay un campo task_id, los otros campos son similares a los anteriores, a través de este campo se puede lograr la asociación de tareas.

​
Manejo de errores

Al llamar a la API, si se encuentra con un error, la API devolverá el código de error y la información correspondiente. Por ejemplo:
  • 400 token_mismatched: Solicitud incorrecta, posiblemente debido a parámetros faltantes o inválidos.
  • 400 api_not_implemented: Solicitud incorrecta, posiblemente debido a parámetros faltantes o inválidos.
  • 401 invalid_token: No autorizado, token de autorización inválido o faltante.
  • 429 too_many_requests: Demasiadas solicitudes, ha superado el límite de tasa.
  • 500 api_error: Error interno del servidor, algo salió mal en el servidor.

​
Ejemplo de respuesta de error

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
Conclusión

A través de este documento, ha aprendido cómo usar la API de Veo Videos Generation para generar videos mediante la entrada de palabras clave y una imagen de referencia del primer fotograma. Esperamos que este documento le ayude a integrar y utilizar mejor esta API. Si tiene alguna pregunta, no dude en ponerse en contacto con nuestro equipo de soporte técnico.