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": "wan2.7-videoedit",
    "video_urls": ["https://cdn.example.com/original.mp4"],
    "prompt": "Replace the background with a snowy mountain scene",
    "resolution": "1080P"
  }'

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

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": "wan2.7-videoedit",
    "video_urls": ["https://cdn.example.com/original.mp4"],
    "prompt": "Replace the background with a snowy mountain scene",
    "resolution": "1080P"
  }'

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

​
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 video, fijado como wan2.7-videoedit
​
video_urls
array<string>
requerido
Array de URLs del video fuente para editar
Solo se usa el 1er video
Restricciones del video:
  • Formato: mp4, mov
  • Duración: 2–10s
  • Resolución: ancho y alto en el rango [240, 4096] píxeles
  • Proporción de aspecto: 1:8 – 8:1
  • Tamaño del archivo: hasta 100MB
​
prompt
string
Instrucción de edición que describe los cambios deseados, hasta 5000 caracteres
Si se omite, el modelo realiza una transferencia de estilo por defecto
Ejemplo: "Change the character's outfit to a red gown", "Replace the background with a snowy mountain scene"
​
negative_prompt
string
Prompt negativo que describe contenido no deseado, hasta 500 caracteres
​
image_urls
array<string>
Array de URLs de imágenes de referencia, hasta 4 imágenesUsado para especificar el estilo o apariencia deseados (por ejemplo, estilo de referencia para transferencia de estilo)
​
resolution
string
predeterminado:"1080P"
Resolución del video de salidaOpciones:
  • 720P - Estándar
  • 1080P - Alta definición (por defecto)
​
duration
integer
predeterminado:"0"
Duración del video de salida (segundos)
  • 0 (por defecto): mantiene la duración completa del video original
  • Entero entre 2-10: toma la duración especificada desde el inicio
Cuando duration=0, la facturación se basa en la duración real del video de salidaLa duración especificada no puede superar la duración del video original en video_urls
​
size
string
Proporción de aspecto de salidaFormatos soportados:
  • 16:9 - Paisaje panorámico
  • 9:16 - Retrato
  • 1:1 - Cuadrado
  • 4:3 - Paisaje
  • 3:4 - Retrato
Si se omite, la proporción de aspecto coincide con la del video de entrada
​
prompt_extend
boolean
predeterminado:"true"
Si se debe activar la reescritura inteligente del promptMejora significativamente los resultados para prompts cortos, pero aumenta el tiempo de procesamientoPor defecto: true
​
watermark
boolean
predeterminado:"false"
Si se debe añadir la marca de agua “AI Generated” al video generado
  • true: añadir marca de agua
  • false: sin marca de agua (por defecto)
​
seed
integer
Entero de seed usado para controlar la aleatoriedad del contenido generadoRango de valores: entero ≥0
  • Para solicitudes idénticas, el modelo genera resultados diferentes al recibir valores de seed diferentes (por ejemplo, al omitir el seed)
  • Para solicitudes idénticas, el modelo genera resultados similares al recibir el mismo valor de seed, pero no se garantiza consistencia exacta
​
metadata
object
Objeto de parámetros adicionales

​
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: Edición básica de video (más simple)

{
  "model": "wan2.7-videoedit",
  "video_urls": ["https://cdn.example.com/original.mp4"],
  "prompt": "Replace the background with a snowy mountain scene"
}

​
Caso 2: Transferencia de estilo (con imagen de referencia)

{
  "model": "wan2.7-videoedit",
  "prompt": "Transfer the video style to the anime style of the reference image",
  "video_urls": ["https://cdn.example.com/original.mp4"],
  "image_urls": [
    "https://cdn.example.com/anime_style.jpg"
  ],
  "resolution": "1080P",
  "watermark": false
}

​
Caso 3: Mantener el audio original del video

Adecuado para videos con sonido de fondo o diálogos importantes: 
{
  "model": "wan2.7-videoedit",
  "video_urls": ["https://cdn.example.com/speech.mp4"],
  "prompt": "Replace the background with a mountain path",
  "metadata": { "audio_setting": "origin" }
}

​
Caso 4: Parámetros completos

{
  "model": "wan2.7-videoedit",
  "prompt": "Change the character's outfit to a red gown",
  "negative_prompt": "blurry, distorted",
  "video_urls": ["https://cdn.example.com/original.mp4"],
  "image_urls": ["https://cdn.example.com/reference.jpg"],
  "resolution": "1080P",
  "duration": 0,
  "size": "16:9",
  "prompt_extend": true,
  "watermark": false,
  "seed": 888,
  "metadata": {
    "audio_setting": "origin"
  }
}

​
Gestión de audio

audio_settingDescripciónEscenarios adecuados
auto (por defecto)La IA regenera audio que coincide con el contenido del video editadoCambios visuales importantes donde se desea que el audio se actualice en consecuencia
originFuerza mantener la pista de audio original del videoVideos con música de fondo o diálogos importantes
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.