POST /v1/enhance
Envía la URL de una imagen y un modo: standard, enhance, people_foreground o people_background. Recibes un job_id al instante.
Un único endpoint REST asíncrono. Envía una imagen y recibe un webhook firmado con HMAC cuando el resultado mejorado esté listo. Pensado para granjas de render, estudios de archviz y flujos de trabajo BIM.
curl -X POST https://api.vaethat.com/v1/enhance \
-H "X-API-Key: vth_live_xxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"image_url": "https://your-cdn.com/render.jpg",
"scale": 2,
"mode": "enhance",
"webhook_url": "https://your-app.com/hooks/vaethat"
}'
# 202 Accepted
{
"job_id": "db82f184-1a4c-4f9e-9d3a-8b1f2c3d4e5f",
"status": "queued",
"credits_charged": 5,
"estimated_seconds": 21
}
Elige tu stack. El endpoint es el mismo.
curl -X POST https://api.vaethat.com/v1/enhance \
-H "X-API-Key: vth_live_xxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"image_url": "https://your-cdn.com/render.jpg",
"scale": 2,
"mode": "enhance",
"webhook_url": "https://your-app.com/hooks/vaethat"
}'
# 202 Accepted
{
"job_id": "db82f184-1a4c-4f9e-9d3a-8b1f2c3d4e5f",
"status": "queued",
"credits_charged": 5,
"estimated_seconds": 21
}import fetch from "node-fetch";
const res = await fetch("https://api.vaethat.com/v1/enhance", {
method: "POST",
headers: {
"X-API-Key": process.env.VAETHAT_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
image_url: "https://your-cdn.com/render.jpg",
scale: 2,
mode: "enhance",
webhook_url: "https://your-app.com/hooks/vaethat",
}),
});
const { job_id, credits_charged } = await res.json();
console.log("Queued job", job_id, ":", credits_charged, "credits");import os, requests
r = requests.post(
"https://api.vaethat.com/v1/enhance",
headers={"X-API-Key": os.environ["VAETHAT_API_KEY"]},
json={
"image_url": "https://your-cdn.com/render.jpg",
"scale": 2,
"mode": "enhance",
"webhook_url": "https://your-app.com/hooks/vaethat",
},
)
data = r.json()
print("Queued job", data["job_id"], ":", data["credits_charged"], "credits")Los endpoints que la competencia no anuncia, porque no los tiene.
Llama a /v1/estimate para saber exactamente cuánto costará un trabajo y qué tamaño tendrá el resultado, sin gastar un crédito ni usar una GPU.
Envía una cabecera Idempotency-Key para reintentar con seguridad. Los envíos duplicados devuelven el trabajo original en lugar de cobrar dos veces.
Cada callback lleva una firma HMAC-SHA-256. Calendario de reintentos documentado (de 30 s a 6 h) y GET /jobs/:id como alternativa.
Las claves vth_test_ vienen con todos los planes de API, nunca cobran créditos y devuelven la entrada como resultado: conecta tus integraciones antes de lanzar.
Envía la URL de una imagen y un modo: standard, enhance, people_foreground o people_background. Recibes un job_id al instante.
Ejecutamos la mejora en el modo que elegiste, al tamaño y al precio que indica /v1/estimate.
Enviamos por POST un payload firmado a tu webhook_url con la URL del resultado. Como alternativa, puedes consultar el estado del trabajo.
Planes mensuales transparentes. Sin unidades de cómputo, sin sorpresas.
99€
por mes
Ideal para desarrolladores independientes y prototipos
299€
por mes
Para equipos que lanzan a producción
799€
por mes
Para estudios con mucho volumen
A medida
por mes
Para grandes organizaciones con necesidades personalizadas
Cualquier producto o aplicación que use la API de vaethat debe mostrar una etiqueta visible "Powered by vaethat", en texto o como distintivo, en la interfaz donde aparezcan las imágenes mejoradas. Se recomienda un enlace a vaethat.com, pero no es obligatorio.
Las claves de prueba (vth_test_) están exentas durante el desarrollo.
Añade la mejora 2x / 4x como paso final de tu pipeline. Sin comprar GPUs.
Mejora por lotes las entregas de tus proyectos desde tus herramientas internas o desde un plugin de Houdini o 3ds Max.
Ofrece renders mejorados como una función de tu propio producto: factura directamente a tus clientes, con marca blanca opcional.
No. Los planes de API se facturan por separado. Los créditos de un plan developer, scale o studio solo se gastan a través de la API y nunca afectan a tus créditos de la aplicación.
Las claves de producción (vth_live_) necesitan un plan de API activo, developer o superior. Las claves de prueba (vth_test_) vienen con los mismos planes; no hay prueba gratuita.
Sí. Si un trabajo falla por nuestra parte (un error de GPU o un tiempo de espera agotado en un servicio del que dependemos), los créditos se reembolsan automáticamente. Solo pagas por las mejoras que salen bien.
No hay un límite de peticiones por minuto. Los trabajos se procesan en el orden en que llegan.
Entradas de hasta 50 MB; resultados de hasta 8000 px en el lado largo y 64 megapíxeles. Una entrada más grande se rechaza, y un resultado más grande se reduce hasta que quepa.
Sí. Los planes de API en producción exigen una etiqueta visible 'Powered by vaethat' (texto o distintivo) allí donde aparezcan imágenes mejoradas en tu interfaz. Se recomienda un enlace a vaethat.com, pero no es obligatorio. El uso en el entorno de pruebas está exento.
Todos los planes de API incluyen claves de prueba. Desarrolla con ellas y cambia a una clave de producción para lanzar.