Referência

Preços da API

A API Pedra é faturada em créditos. A maioria dos endpoints de imagem custa 1–2 créditos; editar via prompt custa 2 créditos; cada frame de vídeo não estático custa 5 créditos.

A API Pedra funciona num sistema simples de créditos. Cada conta tem um saldo de créditos — cada chamada subtrai créditos, e recarregas em app.pedra.ai ou através de um contrato personalizado para volume elevado.

Custo por chamada

Endpoint
Unidade
Custo
/api/enhance
por imagem
1 crédito
/api/enhance_and_correct_perspective
por imagem
1 crédito
/api/furnish
por imagem
1 crédito (2 com um estilo de imagem de referência)
/api/empty_room
por imagem
1 crédito
/api/renovation
por imagem
1 crédito
/api/sky_blue
por imagem
1 crédito
/api/edit_via_prompt
por imagem
2 créditos
/api/remove_object
por imagem
1 crédito
/api/blur
por imagem
1 crédito
/api/create_video
por frame não estático
5 créditos
/api/create_virtual_tour
por tour — ligação sequential
1 crédito por divisão, mínimo 3
/api/create_virtual_tour
por tour — ligação smart
Igual a sequential
/api/add_virtual_tour_scenes
por chamada — apenas divisões novas
1 crédito por cada divisão nova, mínimo 3

Os frames de vídeo com effect: "static" são gratuitos — apenas frames em movimento (zoom-in, zoom-out, transition) contam para o teu consumo de créditos.

Tours virtuais: os nomes de divisões com IA, linking: "none", update_virtual_tour, get_virtual_tour, list_virtual_tours, delete_virtual_tour e create_upload_link são grátis, e uma construção de tour que falha nunca é cobrada.

Exemplos práticos

  • 10 fotos melhoradas → 10 créditos
  • 5 divisões mobiladas + 5 divisões renovadas → 10 créditos (1 × 5 + 1 × 5)
  • 5 divisões mobiladas com o estilo de uma imagem de referência → 10 créditos (2 × 5)
  • 10 edições com prompt → 20 créditos
  • Vídeo de 6 frames, todos zoom-in → 30 créditos
  • Vídeo de 6 frames, 4 zoom-in + 2 static → 20 créditos
  • Tour virtual de 8 divisões, ligação sequential → 8 créditos
  • Tour virtual de 8 divisões, ligação smart → 8 créditos

Saldo mensal

A tua alocação mensal de créditos depende do plano em que estás, e renova-se na data de faturação. Ver pedra.ai/pricing para os planos atuais e respetivos créditos. Podes mudar de plano em qualquer altura em app.pedra.ai → Definições → Subscrição e créditos.

Quando os teus créditos mensais esgotarem, as chamadas devolvem HTTP 403 com o cálculo de créditos restantes no corpo error (402 insufficient_credits nos endpoints de tours virtuais, com creditsRequired e creditsAvailable) — recarrega ou faz upgrade em app.pedra.ai para continuar antes da próxima renovação.

Recarga e enterprise

Recarrega em app.pedra.ai, ou envia email para felix@pedra.ai para:

  • Descontos por volume (10.000+ chamadas/mês)
  • Faturação anual
  • Transferência bancária ou faturação personalizada
  • Capacidade dedicada / SLA

O que conta como chamada faturável

  • HTTP 200 com sucesso = créditos subtraídos.
  • Falhas de autenticação (404 "User not found") e erros de validação (400) não consomem créditos.
  • 403 Créditos insuficientes (402 nos endpoints de tours virtuais) — por definição, sem dedução.
  • Para vídeo, o custo em créditos é calculado antecipadamente a partir do teu array images e verificado antes do processamento começar.

Seguinte

Ver Erros e limites para o modelo completo de falhas, ou Autenticação para começar.