Saltar al contenido principal
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "kling-v2-6",
    "prompt": "A golden cat running on a sunlit meadow, slow motion, cinematic quality",
    "mode": "std",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxxxx"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "kling-v2-6",
    "prompt": "A golden cat running on a sunlit meadow, slow motion, cinematic quality",
    "mode": "std",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxxxx"
    }
  ]
}

​
Autorización

​
Authorization
string
requerido
Todos los endpoints de la API requieren autenticación mediante Bearer TokenObtenga su API Key:Visite la página de gestión de API Keys para obtener su API KeyAñádala al encabezado de la solicitud:
Authorization: Bearer YOUR_API_KEY

​
Parámetros de la solicitud

​
model
string
requerido
Nombre del modelo de generación de videoModelos soportados:
  • kling-v2-6 - Kling v2.6 (recomendado)
​
prompt
string
requerido
Prompt de texto, máximo 2500 caracteresDescriba escenas, acciones y estilos en detalle para obtener mejores resultadosEjemplo: "A golden cat running on a sunlit meadow, slow motion, cinematic quality"
​
mode
string
predeterminado:"std"
Modo de generaciónOpciones:
  • std - Modo estándar (720P, solo video silencioso)
  • pro - Modo profesional (1080P, admite generación automática de audio)
Por defecto: std
Limitación del modo estándar: el modo std solo admite video silencioso. El parámetro audio requiere el modo pro.
​
duration
integer
predeterminado:"5"
Duración del video (segundos)Opciones: 5 o 10Por defecto: 5
​
aspect_ratio
string
predeterminado:"16:9"
Proporción de aspecto del videoOpciones:
  • 16:9 - Paisaje
  • 9:16 - Retrato
  • 1:1 - Cuadrado
Por defecto: 16:9
​
negative_prompt
string
Prompt negativo para excluir contenido no deseadoEjemplo: "blurry, low quality, distorted"
​
image_urls
array<url>
Array de URLs de imágenes para generación image-to-video
  • Enviar 1 imagen: usada como primer fotograma
  • Enviar 2 imágenes: asignadas automáticamente como primer fotograma + último fotograma (requiere mode: "pro")
Máximo 2 imágenes admitidasEjemplo: ["https://example.com/first.jpg"]
  • Máximo 2 imágenes admitidas
  • El último fotograma (2 imágenes) requiere únicamente el modo pro; el modo std solo admite primer fotograma (1 imagen)
  • El último fotograma y el audio son mutuamente excluyentes: en modo pro, el último fotograma (2 imágenes) y el audio (audio: true) no pueden usarse juntos
  • En modo image-to-video, aspect_ratio puede ser sobrescrito por la proporción real de la imagen
​
audio
boolean
predeterminado:"false"
Si se debe generar audio automáticamentePor defecto: false
  • Solo disponible en mode: "pro"
  • Mutuamente excluyente con el último fotograma: el audio no puede usarse junto con el último fotograma (2 imágenes)
​
watermark
boolean
Si se debe añadir una marca de agua

​
Matriz de soporte de funciones

TipoFunciónstd 5sstd 10spro 5spro 10s
Text-to-VideoGeneración✅ (solo silencioso)✅ (solo silencioso)✅✅
Text-to-VideoAudio automático--✅✅
Image-to-VideoGeneración✅ (solo silencioso)✅ (solo silencioso)✅✅
Image-to-VideoPrimer fotograma✅✅✅✅
Image-to-VideoÚltimo fotograma--✅✅
Image-to-VideoAudio automático--✅✅
Nota: En modo pro, el control de último fotograma y el de audio son mutuamente excluyentes y no pueden usarse juntos.

​
Texto a video (Text-to-Video) vs Imagen a video (Image-to-Video)

El sistema determina automáticamente el modo según si se proporciona image_urls: sin imágenes significa text-to-video, con imágenes significa image-to-video.
ParámetroText-to-VideoImage-to-Video
prompt✅ Obligatorio✅ Obligatorio
image_urls❌ No se usa✅ Obligatorio (1-2 imágenes, último fotograma requiere pro)
negative_prompt✅ Opcional✅ Opcional
mode✅ Opcional✅ Opcional
duration✅ Opcional✅ Opcional
aspect_ratio✅ Opcional⚠️ Puede ser sobrescrito por la proporción de la imagen
audio✅ Opcional (requiere pro)✅ Opcional (requiere pro)
watermark✅ Opcional✅ Opcional

​
Respuesta

​
code
integer
Código de estado de la respuesta, 200 en caso de éxito
​
data
array
Array de datos de la respuesta

​
Casos de uso

​
Caso 1: Texto a video (modo estándar)

{
  "model": "kling-v2-6",
  "prompt": "A golden cat running on a sunlit meadow, slow motion, cinematic quality",
  "mode": "std",
  "duration": 5,
  "aspect_ratio": "16:9"
}

​
Caso 2: Texto a video (modo Pro + prompt negativo)

{
  "model": "kling-v2-6",
  "prompt": "Tokyo Shibuya crossing at night, neon lights reflected on wet ground, people walking with umbrellas",
  "negative_prompt": "blurry, low quality, distorted",
  "mode": "pro",
  "duration": 10,
  "aspect_ratio": "16:9"
}

​
Caso 3: Imagen a video (primer fotograma)

{
  "model": "kling-v2-6",
  "prompt": "The person in the frame turns and smiles",
  "image_urls": ["https://example.com/portrait.jpg"],
  "mode": "std",
  "duration": 5,
  "aspect_ratio": "16:9"
}

​
Caso 4: Imagen a video (control de primer + último fotograma)

{
  "model": "kling-v2-6",
  "prompt": "City timelapse transitioning from day to night",
  "image_urls": ["https://example.com/day-city.jpg", "https://example.com/night-city.jpg"],
  "mode": "pro",
  "duration": 5
}

​
Caso 5: Modo Pro + audio automático

{
  "model": "kling-v2-6",
  "prompt": "Waves crashing against rocks, seagulls circling in the sky, lighthouse in the distance",
  "mode": "pro",
  "duration": 10,
  "audio": true,
  "aspect_ratio": "16:9"
}
Consultar resultados de la tareaLa generación de video es una tarea asíncrona que devuelve un task_id al enviarse. Use el endpoint Obtener estado de la tarea para consultar el progreso y los resultados de la generación.