Generación de imágenes
Transforma una fotografía que ya has subido: ambienta una estancia vacía, quita el desorden o corrige cómo se tomó la foto. Cada petición se pone en cola y se produce en segundo plano.
/v1/api/generations/kindsimages:writeListar lo que se puede generar
Las transformaciones disponibles y lo que hace cada una.
Se sirve desde la misma lista contra la que valida la API, así que no puede quedarse por detrás. Además nombra lo que deliberadamente no está disponible y por qué, que es más útil que una ausencia que hay que deducir.
Respuesta
{
"data": {
"kinds": [
{
"kind": "virtual_staging",
"description": "Furnish an empty room in a chosen style, leaving the architecture untouched."
},
{
"kind": "decluttering",
"description": "Remove personal clutter from a room without changing the furniture or the fabric of the building."
},
{
"kind": "enhancement",
"description": "Correct exposure, white balance, and straightness, without altering what the photograph shows."
}
],
"not_available": [
{
"kind": "floorplan_render",
"reason": "Named in the schema and not implemented. Rendering a floor plan needs a provider we have not integrated, and a plausible but wrong plan of somebody's home is worse than none."
}
]
}
}https://api.skautik.com/v1/api/generations/kinds
GET /v1/api/generations/kinds HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…/v1/api/generationsimages:writeSolicitar una generación
Pon en cola una transformación de una de tus imágenes de inmueble.
Devuelve de inmediato una generación en cola. Consulta el endpoint de obtención, o suscríbete a un webhook, en lugar de mantener la petición abierta. La imagen de origen ya debe pertenecer a uno de tus inmuebles: no hay forma de enviar una URL cualquiera, y es deliberado.
Campos del cuerpo
| Nombre | Tipo | Descripción |
|---|---|---|
kindobligatorio | enum | La transformación a aplicar. floorplan_render aparece nombrado en el esquema y no está implementado; pedirlo se rechaza en lugar de responderse con un plano inventado. virtual_staging | decluttering | enhancement ejemplo: virtual_staging |
source_image_idobligatorio | string | La imagen a transformar. Debe pertenecer a uno de tus propios inmuebles; cualquier otra cosa responde 404, igual que una imagen que no existe. ejemplo: img_ce1c9e04db6140eda7c6934af60daebb |
room_type | string | Para virtual_staging: qué estancia es. Mejora el resultado notablemente. Por defecto, una estancia genérica. ejemplo: living room |
style | string | Para virtual_staging: el estilo del mobiliario. Por defecto, contemporáneo. ejemplo: scandinavian |
prompt | string | Hasta 500 caracteres de indicaciones adicionales. Se añaden a la instrucción del tipo elegido y nunca la sustituyen, así que no sirve para que el modelo haga algo que no venga a cuento. ejemplo: A bright Scandinavian living room with oak floors and a linen sofa |
Cuerpo de la petición
{
"kind": "virtual_staging",
"source_image_id": "img_ce1c9e04db6140eda7c6934af60daebb",
"room_type": "living room",
"style": "scandinavian"
}Respuesta
{
"data": {
"id": "gen_41bd169388ff4bee8706b822e4def3c5",
"kind": "virtual_staging",
"status": "queued",
"property_id": "prop_f06bd367019344dd91b559046f8e0d4c",
"source_image_id": "img_ce1c9e04db6140eda7c6934af60daebb",
"style": "scandinavian",
"room_type": "living room",
"created_at": "2026-08-13T14:39:51Z"
}
}Respuestas destacadas
- 404
- La imagen de origen no existe, o no está en uno de tus inmuebles. Las dos cosas son indistinguibles a propósito.
https://api.skautik.com/v1/api/generations
POST /v1/api/generations HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…
Content-Type: application/json
{
"kind": "virtual_staging",
"source_image_id": "img_ce1c9e04db6140eda7c6934af60daebb",
"room_type": "living room",
"style": "scandinavian"
}/v1/api/generations/{generation_id}images:writeObtener una generación
Estado, y la imagen una vez esté lista.
Pasa por en cola, en ejecución y después completada o fallida. Una generación fallida lleva el motivo, incluido cuando el modelo se ha negado en lugar de dar error: son problemas distintos y solo uno merece un reintento.
Parámetros de ruta
| Nombre | Tipo | Descripción |
|---|---|---|
generation_idobligatorio | string | Identificador de la generación. ejemplo: gen_5c1e9a2b3d |
Respuesta
{
"data": {
"id": "gen_41bd169388ff4bee8706b822e4def3c5",
"kind": "virtual_staging",
"status": "completed",
"property_id": "prop_f06bd367019344dd91b559046f8e0d4c",
"source_image_id": "img_ce1c9e04db6140eda7c6934af60daebb",
"style": "scandinavian",
"room_type": "living room",
"image_url": "https://images.skautik.com/generations/…/41bd1693.jpg",
"created_at": "2026-08-13T14:39:51Z",
"finished_at": "2026-08-13T14:40:07Z"
}
}https://api.skautik.com/v1/api/generations/{generation_id}
GET /v1/api/generations/gen_5c1e9a2b3d HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…/v1/api/generationsimages:writeListar generaciones
Peticiones recientes de tu organización, de la más nueva a la más antigua.
https://api.skautik.com/v1/api/generations
GET /v1/api/generations HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…