Help Center

API Documentation

k-deco API

The k-deco API is available on the Profesional and Agencia plans.

Authentication

Use your API token in the Authorization header:

Authorization: Bearer kd_your_token_here

Generate tokens in Settings > API Tokens.

Endpoints

#### POST /api/v1/generate

Create a new generation.

**Request** (multipart/form-data):

  • `image`: Room photo (JPG/PNG/WebP, max 10MB)
  • `roomType`: Room type ID (e.g., "living_room")
  • `style`: Style ID (e.g., "modern")
  • `mode`: "redesign" | "staging" | "creative"
  • **Response**:

    {

    "id": "gen_abc123",

    "status": "processing",

    "estimatedTime": 15

    }

    #### GET /api/v1/generations/:id

    Get generation status and result.

    **Response**:

    {

    "id": "gen_abc123",

    "status": "completed",

    "originalUrl": "https://...",

    "resultUrl": "https://...",

    "style": "modern",

    "roomType": "living_room"

    }

    Rate Limits

  • Profesional: 100 requests/hour
  • Agencia: 500 requests/hour
  • Error Codes

  • 401: Invalid or expired token
  • 429: Rate limit exceeded
  • 413: Image too large
  • 422: Invalid parameters