Centro de ajuda

Documentacao da API

API k-deco

A API do k-deco esta disponivel nos planos Profesional e Agencia.

Autenticacao

Use seu token API no header Authorization:

Authorization: Bearer kd_seu_token_aqui

Gere tokens em Configuracoes > Tokens API.

Endpoints

#### POST /api/v1/generate

Criar uma nova geracao.

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

  • `image`: Foto do ambiente (JPG/PNG/WebP, max 10 MB)
  • `roomType`: ID do tipo de ambiente (ex. "living_room")
  • `style`: ID do estilo (ex. "modern")
  • `mode`: "redesign" | "staging" | "creative"
  • **Resposta**:

    {

    "id": "gen_abc123",

    "status": "processing",

    "estimatedTime": 15

    }

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

    Obter status e resultado da geracao.

    **Resposta**:

    {

    "id": "gen_abc123",

    "status": "completed",

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

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

    "style": "modern",

    "roomType": "living_room"

    }

    Limites de Requisicao

  • Profesional: 100 requisicoes/hora
  • Agencia: 500 requisicoes/hora
  • Codigos de Erro

  • 401: Token invalido ou expirado
  • 429: Limite de requisicoes excedido
  • 413: Imagem muito grande
  • 422: Parametros invalidos