apimart-zoe API

apimart-zoe es un modelo multimodal de generación de video de APIMart que se llama con el ID de modelo apimart-zoe. La apimart-zoe API admite texto a video, video con primer y último fotograma, video a partir de referencias de imagen, video y audio, edición de un video existente, audio opcional generado junto con el video y un flujo de dos pasos de borrador 480p a final 1080p. Los clips duran 4–30 segundos en 480p, 720p, 1080p, 2k o 4k.

Envía POST /v1/videos/generations con model apimart-zoe y tu prompt, usando Authorization: Bearer <API key>. La respuesta devuelve un task_id. La generación suele tardar 1–3 minutos: consulta GET /v1/tasks/{task_id} cada 5–10 segundos hasta que data.status sea completed y lee la URL del video en data.result.videos[0].url[0]. El ejemplo de esta página tiene código cURL y Python, y la referencia completa de la apimart-zoe API está en la documentación de APIMart.

model (apimart-zoe) es obligatorio. prompt es obligatorio en texto a video, opcional si solo envías material y admite hasta 204.800 caracteres. Los parámetros opcionales son resolution (480p, 720p, 1080p, 2k o 4k), aspect_ratio o size (21:9, 16:9, 4:3, 1:1, 3:4, 9:16 o adaptive), duration o seconds (4–30 o -1), audio o generate_audio, seed, image_with_roles, image_urls (alias image, images, image_url), first_frame_image, last_frame_image, video_urls, audio_urls, draft, draft_task_id, omni_reference_task_type (auto, reference o edit), return_last_frame, output_format o response_format (mp4 o mov) y enhance_prompt, además del campo de APIMart nsfw_check. negative_prompt, camera_fixed (también camerafixed), extend_from_task_id, mask_url, video_list, element_list, multi_shot y tools no se admiten: si el campo aparece en la solicitud, aunque esté vacío, sea false o null, devuelve 400. n solo puede omitirse o valer 1. La tabla de parámetros de esta página indica los valores por defecto y los límites.

Define duration (o seconds) con un número entero de 4 a 30; el valor por defecto es 5 y -1 deja que el modelo decida. resolution es 480p, 720p (por defecto), 1080p, 2k o 4k, sin distinguir mayúsculas. aspect_ratio, que también se acepta como size, es 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 o adaptive (por defecto), donde el modelo o tu material definen el encuadre. En una edición de video, omite duration y aspect_ratio (o envía -1 y adaptive): la duración y el encuadre siguen al video de origen. Los borradores siempre son 480p y los finales 1080p.

Sí. Envía image_with_roles con first_frame y last_frame, o usa first_frame_image y last_frame_image. Cada fotograma admite una imagen y el último requiere el primero. Una solicitud con primer y último fotograma no puede incluir también imágenes, videos ni audio de referencia; si lo hace, devuelve 400 y no se cobra. Usa el prompt para describir cómo pasa el plano de un fotograma al otro.

Hasta 30 imágenes, 10 videos y 10 clips de audio de referencia, 50 archivos en total; el audio de referencia debe ir con una imagen o un video de referencia. Las imágenes pueden ser jpeg, png, webp, bmp, tiff, gif, heic o heif, de 300–6000 píxeles por lado, relación de aspecto 0,4–2,5 y menos de 30 MB. Los videos son mp4 o mov (H.264/H.265, con audio AAC o MP3), de 2–15 segundos cada uno (se aceptan 1,8–15,2 s) y hasta 200 MB, con ancho y alto de 300–6000 píxeles, ancho × alto entre 409.600 y 8.295.044 (de unos 640×640 a 3840×2160), relación de aspecto 0,4–2,5 y 24–60 fps tras redondear (23,976 y 59,94 se aceptan); el video de origen de una edición puede durar 4–30 segundos (mínimo 3,8 s y menos de 30,2 s), y sin tipo de tarea los videos de más de 15 segundos requieren edit. El audio es wav o mp3, de 2–15 segundos (1,8–15,2 s) y hasta 15 MB por clip, 30 segundos en total (hasta 30,2 s). La duración, las dimensiones, la relación de aspecto y los fps de los videos de referencia, y la duración del audio de referencia, se comprueban al enviar la tarea: si no se cumplen, se devuelve 400 invalid_request_error y no se cobra. Las dimensiones de las imágenes, el tamaño de archivo y la codificación se comprueban durante la generación: si no se cumplen, la tarea falla y el importe se devuelve automáticamente, así que revisa tus archivos antes de llamar. Todo el material debe ser URL públicas http(s) o ID asset://; no se aceptan URI data:, así que sube antes los archivos a una dirección pública. Al enviar la tarea, APIMart registra cada archivo automáticamente y no vuelve a registrar el mismo archivo si se reutiliza en 7 días. Si solo envías material, puedes omitir prompt.

Envía una solicitud con draft: true para obtener una vista previa económica en 480p; los borradores solo pueden ser 480p y no se combinan con una edición de video. Cuando el borrador termine bien, envía una segunda solicitud con model y draft_task_id igual al task_id del borrador. El final se renderiza en 1080p y reutiliza el prompt, el material, la duración, la relación de aspecto, la semilla y el ajuste de audio del borrador. Aparte de model, draft_task_id, resolution y campos comunes como nsfw_check o webhook, no se admite ningún campo: prompt, material, duration, aspect_ratio, seed, audio, omni_reference_task_type, return_last_frame, output_format o enhance_prompt devuelven 400, aunque estén vacíos. Crea el final en las 24 horas siguientes al borrador: un draft_task_id inexistente, que no sea un borrador, sin terminar o con más de 24 horas devuelve 400. El borrador y el final se cobran cada uno como una generación; el final se cobra en 1080p con la duración del borrador, o con su duración real si el borrador usó -1.

Los errores de envío devuelven un objeto error con message, type, param y code, y no se cobran. 400 invalid_request_error cubre valores no válidos, cantidad y combinación de material (como primer y último fotograma junto con referencias, o image_urls junto con image_with_roles), duración, dimensiones, relación de aspecto o fps de los videos de referencia y duración del audio de referencia fuera de rango, las reglas del tipo de tarea y de la edición de video, valores de output_format, las reglas de borrador y final, y parámetros no admitidos como negative_prompt o camera_fixed. 400 input_video_probe_failed indica que un video de referencia no es accesible o no se pudo leer su duración. 402 payment_required indica saldo insuficiente; con duration -1 o en una edición de video se reservan 30 segundos. 400 nsfw_content_detected indica que nsfw_check detectó contenido; el message indica las categorías detectadas. 503 draft_channel_unavailable o draft_task_unavailable indica que los borradores no están disponibles temporalmente: vuelve a intentarlo más tarde o crea un borrador nuevo.

Un clip suele tardar 1–3 minutos, así que consulta cada 5–10 segundos. data.status es pending, processing, completed o failed, y data.progress va de 0 a 100. La URL del video en data.result.videos[0].url está guardada en APIMart y caduca 72 horas después de completarse, así que descárgalo a tiempo. Con return_last_frame: true, data.result.last_frame_url también devuelve el último fotograma como imagen png. Si una tarea falla, incluso cuando el registro del material no se aprueba o falla la comprobación de dimensiones de imagen, tamaño de archivo o codificación durante la generación, data.error.message indica el motivo, data.error.code es task_failed y data.cost es 0 porque el importe reservado se devuelve automáticamente.

La apimart-zoe API cobra por segundo de salida, con tarifas para 480p, 720p, 1080p, 2k y 4k y una tarifa aparte para solicitudes con video de referencia. Si defines duration (4–30) o la dejas en el valor por defecto de 5, se cobran los segundos solicitados y no se ajustan después a la duración del clip. Con duration -1 o en una edición de video (omni_reference_task_type: edit) se precobran 30 segundos y, al terminar, se ajusta a la duración real del clip redondeada al segundo más cercano; la edición de video usa la tarifa de solicitudes con video de referencia. Con video de referencia, segundos facturados = duración del video + max(duración total de los videos de referencia, ⌈duración del video × 2/3⌉); la duración de referencia se mide al enviar la tarea, video por video, se suma, se redondea hacia abajo al segundo y no se ajusta después. Un final creado desde un borrador se cobra en 1080p con la duración del borrador (la duración real del borrador si usó -1) y, si el borrador usó video de referencia, también suma su duración. Tu cargo refleja el descuento de tu membresía o grupo de cuenta; consulta la tabla de precios en tiempo real de esta página.

En APIMart, ambos modelos usan POST /v1/videos/generations y GET /v1/tasks/{task_id}, crean clips de 4–30 segundos en relaciones de aspecto de 21:9 a 9:16, admiten hasta 30 imágenes, 10 videos y 10 clips de audio de referencia por solicitud, permiten seed, generación de audio, return_last_frame, output_format y edición de video (omni_reference_task_type: edit), y ofrecen el flujo de borrador 480p a final 1080p. Las diferencias: apimart-zoe (ID de modelo apimart-zoe) además genera 2k y 4k, no permite combinar primer y último fotograma con referencias, exige una imagen o un video de referencia cuando envías audio de referencia y deja que el modelo decida el audio si omites audio; en Seedance 2.5 (seedance-2.5) generate_audio está activado por defecto y además admite la extensión de video (extend), que en apimart-zoe aún no está disponible. Con video de referencia, los dos modelos también calculan los segundos facturados de forma distinta. Las tablas de comparación de esta página muestran cada diferencia y los precios actuales por segundo.

Depende de la resolución y de si envías un video de referencia. La comparación de precios de esta página muestra las tarifas actuales por segundo de ambos modelos con y sin video de referencia, la diferencia en porcentaje y ejemplos de costo para duraciones habituales. Con video de referencia, apimart-zoe suma a los segundos de salida max(segundos totales de referencia redondeados hacia abajo, ⌈segundos de salida × 2/3⌉), mientras que Seedance 2.5 suma los segundos del video de referencia, así que compara el ejemplo que coincida con tu clip. apimart-zoe también tiene niveles 2k y 4k que Seedance 2.5 no ofrece. Las tarifas se leen de la API de precios de APIMart y dependen de tu nivel de membresía.

No. Es una API de pago por uso que se cobra por segundo de salida, y un borrador y su final se cobran cada uno como una generación. Los errores de envío no se cobran, si tu saldo no alcanza la solicitud devuelve 402, y las tareas fallidas se reembolsan automáticamente con data.cost en 0. Tu precio depende de tu nivel de membresía o grupo de cuenta; la tabla de precios en tiempo real de esta página muestra la tarifa actual de cada resolución.

Regístrate en APIMart, abre la página API Keys de tu panel y crea una key; después envíala como Authorization: Bearer <key>. La misma key sirve para la apimart-zoe API y los demás modelos de APIMart, con pago por uso y sin suscripción.