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 e renovar custam 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
2 créditos (Medium)
1 crédito (High)
/api/empty_room
por imagem
1 crédito
/api/renovation
por imagem
2 créditos (Medium)
1 crédito (High)
/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

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.

Exemplos práticos

  • 10 fotos melhoradas → 10 créditos
  • 5 divisões mobiladas (Medium) + 5 divisões renovadas (Medium) → 20 créditos (2 × 5 + 2 × 5)
  • 5 divisões mobiladas com creativity High → 5 créditos
  • 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

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 — 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 — 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.