Saltar al contenido principal

​
Endpoints

MétodoEndpointDescripción
POST/api/v1/generateTask/kling-2-1Crear tarea de generación
GET/api/v1/statusTask/kling-2-1Consultar 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:
  • standard-image-to-video — Nivel estándar image-to-video, requiere 1 imagen
  • pro-image-to-video — Nivel pro image-to-video, soporta 1-2 imágenes (fotograma final)
  • master-text-to-video — Nivel master text-to-video
  • master-image-to-video — Nivel master image-to-video, requiere 1 imagen

​
Ejemplo

Standard Image-to-Video 
curl -X POST "https://api.apixo.ai/api/v1/generateTask/kling-2-1" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "async",
    "provider": "value",
    "input": {
      "mode": "standard-image-to-video",
      "prompt": "animate this still life scene with subtle camera movement",
      "duration": 5,
      "image_urls": ["https://example.com/std_ref.jpg"],
      "negative_prompt": "blur, low quality",
      "cfg_scale": 0.6
    }
  }'
Pro Image-to-Video (con fotograma final) 
curl -X POST "https://api.apixo.ai/api/v1/generateTask/kling-2-1" \
  -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": "pro-image-to-video",
      "prompt": "city skyline timelapse from day to night",
      "duration": 10,
      "image_urls": [
        "https://example.com/pro_start.jpg",
        "https://example.com/pro_end.jpg"
      ],
      "cfg_scale": 0.4
    }
  }'
Master Text-to-Video 
curl -X POST "https://api.apixo.ai/api/v1/generateTask/kling-2-1" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "async",
    "input": {
      "mode": "master-text-to-video",
      "prompt": "a futuristic drone flying through neon-lit streets at night",
      "duration": 5,
      "aspect_ratio": "9:16",
      "negative_prompt": "grainy, noisy, static",
      "cfg_scale": 0.3
    }
  }'

​
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: 5s ~60-90s, 10s ~90-120s.
  • Selección de nivel: standard mejor valor; pro soporta start/end frame; master máxima calidad.
  • Fotograma final: Modo pro soporta 2 imágenes — primera inicio, segunda final.
  • CFG Scale: Valores más altos siguen el prompt más estrictamente; más bajos más creatividad. Recomendado 0.3-0.7.
La generación de vídeo tarda más — usa modo callback. URLs caducan tras 15 días.

​
Relacionado