Generación de vídeo apimart-zoe

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "apimart-zoe",
    "prompt": "Un gatito naranja en el alféizar mira a la cámara, con luz solar lateral y un lento acercamiento de cámara",
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 8,
    "audio": true,
    "nsfw_check": true,
    "return_last_frame": true
  }'

import requests

response = requests.post(
    "https://api.apimart.ai/v1/videos/generations",
    headers={"Authorization": "Bearer <token>"},
    json={
        "model": "apimart-zoe",
        "prompt": "Un gatito naranja en el alféizar mira a la cámara, con luz solar lateral y un lento acercamiento de cámara",
        "resolution": "1080p",
        "aspect_ratio": "16:9",
        "duration": 8,
        "audio": True,
        "nsfw_check": True,
        "return_last_frame": True
    }
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "model": "apimart-zoe",
    "prompt": "Un gatito naranja en el alféizar mira a la cámara, con luz solar lateral y un lento acercamiento de cámara",
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 8,
    "audio": true,
    "nsfw_check": true,
    "return_last_frame": true
  })
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

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

​

Elegir un modo

​

Cabeceras

​

Parámetros de solicitud

​

Direcciones y límites de los medios

​

Validación de los vídeos de referencia

​

Reglas de combinación de medios

• No envíes image_urls y image_with_roles juntos: devuelve HTTP 400 (invalid_request_error) al enviar, sin cargo. Los alias image, images e image_url cuentan como image_urls y no evitan esta restricción.
• Los fotogramas inicial/final no pueden aparecer en la misma solicitud que imágenes, vídeos o audios de referencia.
• Como máximo un fotograma inicial y uno final. El final requiere el inicial.
• Hasta 30 imágenes, 10 vídeos y 10 audios de referencia, con un máximo combinado de 50 medios.
• Incumplir estas combinaciones o cantidades devuelve HTTP 400 de forma síncrona, sin cargo.
• omni_reference_task_type: "edit" requiere al menos un vídeo fuente (3.8 ≤ t < 30.2 segundos). duration / seconds: omitir o -1; aspect_ratio / size: omitir o adaptive. No combinar con draft: true. Auto/reference mantienen el límite de 2–15 segundos y su tolerancia.

​

Ejemplos de solicitud

​

Fotogramas inicial y final

{
  "model": "apimart-zoe",
  "prompt": "Transición natural del primer al último fotograma, manteniendo una iluminación coherente",
  "image_with_roles": [
    {
      "url": "https://example.com/start.jpg",
      "role": "first_frame"
    },
    {
      "url": "https://example.com/end.jpg",
      "role": "last_frame"
    }
  ],
  "duration": 6
}

​

Referencias de imagen, vídeo y audio

{
  "model": "apimart-zoe",
  "prompt": "El personaje de la imagen de referencia se mueve con naturalidad en la escena del vídeo, con música al ritmo de las imágenes",
  "image_urls": [
    "https://example.com/character.jpg"
  ],
  "video_urls": [
    "https://example.com/scene.mp4"
  ],
  "audio_urls": [
    "https://example.com/bgm.mp3"
  ],
  "duration": -1
}

​

Edición de vídeo

{
  "model": "apimart-zoe",
  "prompt": "Transforma la escena en una película clásica en blanco y negro, conservando el movimiento de cámara y la composición",
  "video_urls": [
    "https://example.com/source_20s.mp4"
  ],
  "omni_reference_task_type": "edit"
}

​

Último fotograma, salida MOV y optimización del prompt

{
  "model": "apimart-zoe",
  "prompt": "Un gatito naranja en el alféizar mira a la cámara, con luz solar lateral y un lento acercamiento de cámara",
  "duration": 5,
  "return_last_frame": true,
  "output_format": "mov",
  "enhance_prompt": true
}

​

Borrador → vídeo final

1. Envía el borrador con draft: true. Si omites resolution, se usa 480p; si lo incluyes, solo se admite 480p.

{
  "model": "apimart-zoe",
  "prompt": "Un gatito naranja en el alféizar mira a la cámara, con luz solar lateral y un lento acercamiento de cámara",
  "draft": true
}

2. Espera a que el borrador se complete y envía su task_id para generar el vídeo final. Basta con model y draft_task_id. Si indicas resolution, debe ser 1080p.

{
  "model": "apimart-zoe",
  "draft_task_id": "task_01KZOEEXAMPLE"
}

​

Consulta de tareas y resultados

curl --request GET \
  --url https://api.apimart.ai/v1/tasks/task_01KZOEEXAMPLE \
  --header 'Authorization: Bearer <token>'

{
  "code": 200,
  "data": {
    "id": "task_01KZOEEXAMPLE",
    "status": "completed",
    "result": {
      "videos": [
        {
          "url": [
            "https://example.com/generated-video.mp4"
          ],
          "expires_at": 1794475442
        }
      ],
      "last_frame_url": "https://example.com/generated-last-frame.png"
    },
    "progress": 100,
    "completed": 1794389042
  }
}

​

Reglas de facturación

• Duración total de referencias R: medir cada vídeo al enviar, sumar las duraciones y redondear la suma hacia abajo a segundos enteros. No se ajusta después.
• Sin vídeo de referencia: segundos facturables = D. Con referencia: D + max(R, ceil(D × 2/3)). ceil redondea hacia arriba al entero. Se usa la tarifa con vídeo de referencia.
• Ejemplo: solicitar 8 segundos mantiene D = 8, aunque el vídeo dure 8.2 segundos. Una duración automática de 8.5 da D = 9. Referencias de 2.8 y 3.8 segundos se suman a 6.6 y luego se redondean hacia abajo: R = 6.
• Borrador (480p) y vídeo final (1080p) se facturan por separado. Las referencias del borrador cuentan con su duración original también para el vídeo final, sin volver a subirlas.
• Los envíos fallidos no se cobran. Las tareas fallidas se reembolsan automáticamente.

​

Errores comunes