API

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.

Control flexiblefondo, matrícula y tamaño del coche, en cada lote
10.000fotos por lote, volumen bajo petición
Sin redibujarla carrocería queda tal como en la foto
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 + reason
import { 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);
}
Normalmente la respuesta llega en la misma petición. Si el procesado tarda más, recibes un 202 y el resultado por consulta o webhook. Para lotes, usa /v1/batches.SDK para Python y Node: lotes, consultas y webhooks en un mismo cliente. Por ahora lo entregamos al conectarte; PyPI y npm, próximamente.
// lo que devuelve
{
  "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

POST/v1/framesUna foto → foto procesada. Normalmente en la misma petición.
POST/v1/batchesHasta 10.000 fotos en una sola tarea, volumen bajo petición. Un webhook avisa al terminar.
GET/v1/frames/{id}El estado de una foto y el enlace al archivo listo.
GET/v1/backgroundsLa biblioteca de fondos. Tu propio fondo va como archivo en la petición de procesado.
POST/v1/webhooksSuscripción a eventos: lote listo, foto lista.

Próximamente: tus propias escenas en la biblioteca de fondos.

Conexión

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

01 · sin programadores

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 nosotros
02 · sin programadores

Solo 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ón
03 · con programadores propios

API 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ágina
La respuesta

No 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" }
  }
}