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-r2v",
    "prompt": "This person walks down the street surrounded by heavy traffic",
    "image_with_roles": [{"url": "https://cdn.example.com/character.jpg", "role": "reference_image"}],
    "resolution": "1080P",
    "duration": 8
  }'

{
  "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-r2v",
    "prompt": "This person walks down the street surrounded by heavy traffic",
    "image_with_roles": [{"url": "https://cdn.example.com/character.jpg", "role": "reference_image"}],
    "resolution": "1080P",
    "duration": 8
  }'

{
  "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-r2v
​
prompt
string
requerido
Descripción del contenido del video, hasta 5000 caracteresPara múltiples imágenes/videos, use “image 1”, “image 2”, “video 1”, etc. para referenciar los activos de referencia correspondientes (en el orden de entrada)Ejemplo: "The character in image 1 enters the scene in image 2 and looks around"
​
image_with_roles
array<object>
Array de imágenes con roles; debe proporcionarse al menos uno entre este y video_urlsCampos de cada objeto:
  • url (string): URL de la imagen
  • role (string): rol de la imagen
    • reference_image - imagen de referencia (por defecto)
    • first_frame - primer fotograma especificado (cuando se proporciona, size se ignora y la proporción de aspecto sigue la de la imagen del primer fotograma)
  • reference_voice (string, opcional): URL de la muestra de audio de voz para ese personaje de referencia, usado para controlar la voz del personaje en el video generado
Ejemplo:
[
  {
    "url": "https://cdn.example.com/character.jpg",
    "role": "reference_image",
    "reference_voice": "https://cdn.example.com/voice_sample.mp3"
  },
  { "url": "https://cdn.example.com/start.jpg", "role": "first_frame" }
]
​
video_urls
array<string>
Array de URLs de videos de referencia, hasta 5 videos (total imágenes + videos ≤ 5)Debe proporcionarse al menos uno entre este e image_with_roles
Restricciones del video:
  • Formato: mp4, mov
  • Duración: 1–30s
  • 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
​
negative_prompt
string
Prompt negativo que describe contenido no deseado, hasta 500 caracteres
​
resolution
string
predeterminado:"1080P"
Resolución del videoOpciones:
  • 720P - Estándar
  • 1080P - Alta definición (por defecto)
​
duration
integer
predeterminado:"5"
Duración del video (segundos)Rango soportado: 2 ~ 15 segundosPor defecto: 5
Cuando los activos de referencia incluyen un video: un entero entre [2, 10].Cuando los activos de referencia no incluyen un video: un entero entre [2, 15].
​
size
string
predeterminado:"16:9"
Proporción de aspectoFormatos soportados:
  • 16:9 - Paisaje panorámico (por defecto)
  • 9:16 - Retrato
  • 1:1 - Cuadrado
  • 4:3 - Paisaje
  • 3:4 - Retrato
Cuando se proporciona first_frame mediante image_with_roles, este parámetro se ignora y la proporción de aspecto sigue la de la imagen del primer fotograma
​
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

​
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: Imagen de referencia única (más simple)

{
  "model": "wan2.7-r2v",
  "prompt": "This person walks down the street surrounded by heavy traffic",
  "image_with_roles": [
    { "url": "https://cdn.example.com/character.jpg", "role": "reference_image" }
  ]
}

​
Caso 2: Múltiples imágenes de referencia

{
  "model": "wan2.7-r2v",
  "prompt": "The character in image 1 enters the scene in image 2 and mimics the pose in image 3",
  "image_with_roles": [
    { "url": "https://cdn.example.com/person.jpg", "role": "reference_image" },
    { "url": "https://cdn.example.com/background.jpg", "role": "reference_image" },
    { "url": "https://cdn.example.com/pose.jpg", "role": "reference_image" }
  ],
  "resolution": "1080P",
  "duration": 8,
  "size": "16:9"
}

​
Caso 3: Generación basada en video de referencia

{
  "model": "wan2.7-r2v",
  "prompt": "Generate a beach sunset scene in the style of the reference video",
  "video_urls": ["https://cdn.example.com/style_reference.mp4"],
  "resolution": "720P",
  "duration": 8
}

​
Caso 4: Primer fotograma especificado + imagen de referencia

{
  "model": "wan2.7-r2v",
  "prompt": "The reference character starts from this position and walks forward",
  "image_with_roles": [
    { "url": "https://cdn.example.com/character.jpg", "role": "reference_image" },
    { "url": "https://cdn.example.com/start.jpg", "role": "first_frame" }
  ],
  "resolution": "1080P",
  "duration": 8
}

​
Caso 5: Imagen de referencia + voz de referencia (preciso)

{
  "model": "wan2.7-r2v",
  "prompt": "This person walks down the street while speaking",
  "image_with_roles": [
    {
      "url": "https://cdn.example.com/character.jpg",
      "role": "reference_image",
      "reference_voice": "https://cdn.example.com/voice_sample.mp3"
    }
  ],
  "resolution": "1080P",
  "duration": 10
}

​
Reglas de referencia de imágenes

Con múltiples imágenes de referencia, use índices numéricos en el prompt para referirse a ellas:
  • 1ª imagen → “image 1” o “the first image”
  • 1er video → “video 1” o “the first video”
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.