Una petición. Un anuncio listo.
Envías una foto y un fondo — recibes la foto procesada. Tus propios campos, como el ID del anuncio, vuelven con ella.
No necesitas entender nada de esto. ¿Tienes programadores propios? Con esta página pueden conectarlo todo. ¿No los tienes? Lo conectamos nosotros: danos acceso a tu web o CRM, nos encargamos del resto y te enseñamos el resultado con tus propias fotos.
curl -X POST https://auto.happyin.app/v1/frames \
-H "Authorization: Bearer $AUTO_API_KEY" \
-F "image=@IMG_4412.jpg" \
-F "background=white-showroom" \
-F 'metadata={"listing":"A-4412"}'from happyin_auto import Client
client = Client() # key from AUTO_API_KEY
frame = client.process_frame(
"IMG_4412.jpg",
background="white-showroom",
download_to="IMG_4412_showroom.png",
)
print(frame["status"]) # done, or failed + reasonimport { writeFile } from "node:fs/promises";
import { Client } from "@happyin/auto";
const client = new Client(); // key from AUTO_API_KEY
const frame = await client.processFrame("IMG_4412.jpg", {
background: "white-showroom",
});
if (frame.status === "done") {
const png = await client.download(frame.image_url!);
await writeFile("IMG_4412_showroom.png", png);
}{
"ok": true,
"frame": {
"id": "frm_6f1d0c9a2b8e4f7a9c3d5e1b0a2f4c6d",
"status": "done",
"image_url": "https://…/IMG_4412.png?X-Amz-Expires=600&…",
"charged": true,
"metadata": { "listing": "A-4412" }
}
}Cinco métodos
/v1/framesUna foto → foto procesada. Normalmente en la misma petición./v1/batchesHasta 10.000 fotos en una sola tarea, volumen bajo petición. Un webhook avisa al terminar./v1/frames/{id}El estado de una foto y el enlace al archivo listo./v1/backgroundsLa biblioteca de fondos. Tu propio fondo va como archivo en la petición de procesado./v1/webhooksSuscripción a eventos: lote listo, foto lista.Próximamente: tus propias escenas en la biblioteca de fondos.
Tres formas de empezar: con programadores o sin ellos
Tres formas de empezar. Elige la que mejor te encaje: en cualquiera de ellas las primeras 30 fotos son gratis.
¿Trabajas con un agente de IA? ChatGPT, Claude Code, Cursor y otros clientes MCP se conectan a la misma API mediante MCP. Cómo conectar un agente de IA
Lo conectamos nosotros
Nos dejas una solicitud, te llamamos, nos das acceso a tu web o CRM y configuramos la exportación nosotros. Tú solo revisas el resultado y nos dices qué fondo prefieres.
Lo configuramos nosotrosSolo el panel
No hay nada que conectar: sube una carpeta de fotos, elige un fondo y descarga las fotos listas. Funciona en el navegador — cualquiera de tu equipo puede usarlo.
Sin integraciónAPI y clave
Una petición POST, tres parámetros y, normalmente, la respuesta en la misma conexión. SDK para Python y Node. La clave del sandbox (gratis, con marca de agua) llega por correo tras tu solicitud y la confirmación de tu dirección.
Desde esta páginaNo solo una imagen. También datos.
Junto con la foto devolvemos su estado y, si no se pudo procesar, el motivo; esa foto no se cobra. Tus propios campos de metadata, como el ID del anuncio o el VIN, vuelven en la respuesta y en el webhook.
Cómo funciona el procesado →{
"ok": true,
"frame": {
"id": "frm_6f1d0c9a2b8e4f7a9c3d5e1b0a2f4c6d",
"idx": 0,
"name": "IMG_4412.jpg",
"status": "done",
"outcome": "accepted",
"reason": null,
"step": null,
"kind": "exterior",
"options": null,
"mode": "full_blend",
"shot_kind": null,
"effective_view": null,
"view_level": null,
"refits_left": null,
"brand": null,
"attempts": 1,
"charged": true,
"result": true,
"redo_in_progress": false,
"sent": true,
"finished_at": "2026-10-14T09:12:41.000Z",
"vehicle": {
"status": "unconfirmed",
"make": { "code": "skoda", "text": "Škoda", "source": "estimate", "confidence": 0.93 },
"model": null,
"body": { "code": "liftback", "source": "estimate", "confidence": 0.97 },
"dimensions_mm": { "length": 4690, "width": 1830, "height": 1470, "source": "estimate", "typical_error_pct": 4 },
"ref": null,
"vin": null,
"estimate": { "model_version": "carid-2026-10", "make": [["skoda", 0.93]], "body": [["liftback", 0.97]], "mismatch": [] },
"confirmed_at": null
},
"batch_id": "bat_0b7e2d4c9a1f4e6b8d3c5a7f9e1b2d40",
"image_url": "https://…/IMG_4412.png?X-Amz-Expires=600&…",
"image_expires_at": "2026-10-14T09:22:41.000Z",
"metadata": { "listing": "A-4412" }
}
}