Saltar al contenido principal

​
Endpoints

MétodoEndpointDescripción
POST/api/v1/generateTask/seedance-1-5-proCrear tarea de generación
GET/api/v1/statusTask/seedance-1-5-proConsultar estado de la tarea

​
Autenticación

Authorization: Bearer YOUR_API_KEY

​
Parámetros

​
request_type
string
predeterminado:"async"
async (polling) o callback (webhook)
​
callback_url
string
URL de callback (condicional)
​
provider
string
predeterminado:"auto"
auto, value u official
​
input
object
requerido
Opciones de modo:
  • text-to-video — Generar vídeo desde texto
  • image-to-video — Generar vídeo desde imagen (soporta 1-2 imágenes para control de fotograma final)

​
Ejemplo

Text-to-Video 
curl -X POST "https://api.apixo.ai/api/v1/generateTask/seedance-1-5-pro" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "async",
    "provider": "value",
    "input": {
      "mode": "text-to-video",
      "prompt": "a calm seaside sunrise with gentle camera dolly movement",
      "resolution": "720p",
      "duration": 8,
      "sound": true,
      "aspect_ratio": "16:9",
      "fixed_lens": false
    }
  }'
Image-to-Video (con control de fotograma final) 
curl -X POST "https://api.apixo.ai/api/v1/generateTask/seedance-1-5-pro" \
  -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": "animate this landscape with moving clouds and wind",
      "resolution": "480p",
      "duration": 4,
      "sound": false,
      "image_urls": [
        "https://example.com/head.jpg",
        "https://example.com/tail.jpg"
      ],
      "aspect_ratio": "1:1"
    }
  }'

​
Respuesta

Devuelve taskId en éxito.

​
Códigos de error

CódigoDescripción
400Parámetros inválidos o error de solicitud
401Clave de API inválida o ausente
429Límite de tasa superado
Código de falloDescripción
CONTENT_VIOLATIONEl contenido viola directrices de seguridad
INVALID_IMAGE_URLNo se puede acceder a la URL de imagen proporcionada

​
Consejos

  • Tiempo: 4s ~40-60s, 8s ~60-90s, 12s ~90-120s.
  • Generación de audio: sound: true genera sonidos ambiente y música; sound: false vídeo silencioso.
  • Control de fotograma final: image-to-video con 2 imágenes — 1.ª inicio, 2.ª final.
  • Fixed lens: true cámara fija; false permite movimiento (dolly, pan, etc.).
  • Resolución: 480p para vistas previas, 720p para publicación.
La generación de vídeo tarda más — usa modo callback. URLs caducan tras 15 días.

​
Relacionado