Endpoints
| Método | Endpoint | Descripción |
|---|
| POST | /api/v1/generateTask/wan-2-5 | Crear tarea de generación |
| GET | /api/v1/statusTask/wan-2-5 | Consultar estado de la tarea |
Autenticación
Authorization: Bearer YOUR_API_KEY
Parámetros
request_type
string
predeterminado:"async"
async (polling) o callback (webhook)
URL de callback (condicional)
provider
string
predeterminado:"auto"
auto, value u official
mode
string
predeterminado:"text-to-video"
requerido
text-to-video o image-to-video
Descripción de texto, 1-800 caracteres
resolution
string
predeterminado:"720p"
requerido
Resolución del vídeo: 720p o 1080p
duration
integer
predeterminado:"5"
requerido
Duración en segundos: 5 o 10
Imagen de referencia, solo 1 (requerido para image-to-video) (condicional)
aspect_ratio
string
predeterminado:"16:9"
9:16, 16:9 o 1:1 (solo text-to-video)
Prompt negativo, máx. 500 caracteres
Semilla para reproducibilidad
enable_prompt_expansion
boolean
predeterminado:"true"
Si habilitar expansión de prompt
text-to-video — Generar vídeo desde textoimage-to-video — Generar vídeo desde imagen
Ejemplo
Text-to-Video
curl -X POST "https://api.apixo.ai/api/v1/generateTask/wan-2-5" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"request_type": "async",
"provider": "value",
"input": {
"mode": "text-to-video",
"prompt": "a serene mountain landscape with moving clouds and gentle breeze",
"resolution": "1080p",
"duration": 10,
"aspect_ratio": "16:9",
"negative_prompt": "low quality, blurry",
"enable_prompt_expansion": true
}
}'
curl -X POST "https://api.apixo.ai/api/v1/generateTask/wan-2-5" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"request_type": "callback",
"callback_url": "https://your-server.com/callback",
"provider": "official",
"input": {
"mode": "image-to-video",
"prompt": "make this picture into a smooth cinematic shot with camera slowly zooming in",
"resolution": "720p",
"duration": 5,
"image_urls": ["https://example.com/ref.jpg"],
"enable_prompt_expansion": false,
"seed": 42
}
}'
Respuesta
Devuelve taskId en éxito. Consulta estado vía GET.
Códigos de error
| Código | Descripción |
|---|
| 400 | Parámetros inválidos o error de solicitud |
| 401 | Clave de API inválida o ausente |
| 429 | Límite de tasa superado |
| Código de fallo | Descripción |
|---|
CONTENT_VIOLATION | El contenido viola directrices de seguridad |
INVALID_IMAGE_URL | No se puede acceder a la URL de imagen proporcionada |
Consejos
- Tiempo: 720p ~50-70s, 1080p ~70-90s. Espera 50s y consulta cada 5s.
- Modo callback: Recomendado.
- Alta resolución: 720p para vistas previas, 1080p para publicación profesional.
- Expansión de prompt:
enable_prompt_expansion: true (por defecto) optimiza el prompt; false usa el prompt original.
- Prompt negativo: Evita blur, baja calidad, temblores. Ejemplo: “low quality, blurry, shaky, distorted”.
- Seed: Mismo seed + prompt + parámetros = resultados idénticos.
La generación de vídeo tarda más — usa modo callback. URLs caducan tras 15 días.
Relacionado