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": "viduq3",
    "prompt": "Santa Claus and the bear hug by the lakeside",
    "image_urls": [
      "https://example.com/santa.png",
      "https://example.com/bear.png"
    ],
    "duration": 8,
    "resolution": "720p",
    "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": "viduq3",
    "prompt": "Santa Claus and the bear hug by the lakeside",
    "image_urls": [
      "https://example.com/santa.png",
      "https://example.com/bear.png"
    ],
    "duration": 8,
    "resolution": "720p",
    "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 compatibles:
  • viduq3-mix - Calidad premium, transiciones inteligentes más potentes, admite videos cortos de 1 segundo
  • viduq3 - Opción predeterminada, cambio de cámara más inteligente
Cómo elegir: Use viduq3 para uso diario; use viduq3-mix para calidad premium o efectos de movimiento de 1-2 segundos.
​
prompt
string
requerido
Prompt de texto, máximo 5000 caracteresDescriba acciones y movimientos de cámara, no la apariencia (la apariencia está determinada por las imágenes de referencia).Ejemplo: "Santa Claus and the bear hug by the lakeside"
​
image_urls
array<url>
requerido
Array de URLs de imágenes de referencia, 1-7 imágenesAdmite URLs de imágenes de acceso público (http:// o https://)Ejemplo: ["https://example.com/santa.png", "https://example.com/bear.png"]
  • Cantidad: 1-7 imágenes
  • Formatos compatibles: PNG, JPEG, JPG, WebP
  • Tamaño mínimo: 128×128
  • Relación de aspecto: entre 1:4 y 4:1
  • Tamaño máximo de archivo: ≤ 50MB por imagen
  • Deben ser URLs de acceso público
​
duration
integer
predeterminado:"5"
Duración del video (segundos)
  • viduq3-mix: 1 a 16
  • viduq3: 3 a 16
Predeterminado: 5
viduq3 admite un mínimo de 3 segundos, viduq3-mix admite un mínimo de 1 segundo. Pase una duración válida según el modelo seleccionado.
​
resolution
string
predeterminado:"720p"
Resolución del video
  • viduq3-mix: 720p (predeterminado) / 1080p
  • viduq3: 540p / 720p (predeterminado) / 1080p
viduq3-mix no admite 540p, use 720p o 1080p.
​
aspect_ratio
string
predeterminado:"16:9"
Relación de aspecto del videoOpciones:
  • 16:9 - Horizontal (predeterminado)
  • 9:16 - Vertical
  • 4:3 - Tradicional
  • 3:4 - Vertical tradicional
  • 1:1 - Cuadrado
​
seed
integer
Semilla aleatoria para controlar la aleatoriedad de la generaciónSi no se proporciona, se usará una semilla aleatoria.
Usar la misma semilla con parámetros idénticos producirá resultados similares, pero no se garantiza que sean exactamente iguales.

​
Comparación de modelos

Característicaviduq3viduq3-mix
Recomendado paraUso diario, cambio de cámara multiánguloCalidad premium, efectos de movimiento de 1-2 segundos
Rango de duración3-16 segundos1-16 segundos
Resolución540p / 720p / 1080p720p / 1080p
Imágenes de referencia1-7 imágenes1-7 imágenes

​
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: Reference-to-Video básico con viduq3

{
  "model": "viduq3",
  "prompt": "Santa Claus and the bear hug by the lakeside",
  "image_urls": [
    "https://example.com/santa.png",
    "https://example.com/bear.png"
  ]
}

​
Caso 2: Reference-to-Video de alta calidad con viduq3-mix

{
  "model": "viduq3-mix",
  "prompt": "A cyberpunk neon street with the cat from reference image walking by",
  "image_urls": [
    "https://example.com/cat-1.png",
    "https://example.com/cat-2.png",
    "https://example.com/cat-3.png"
  ],
  "duration": 8,
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "seed": 42
}
Consultar los 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.