SDKs

SDKs oficiais de Python e JavaScript/TypeScript para a API Pedra. Home staging virtual, renovação, melhoria de imagens e vídeos para anúncios em poucas linhas de código — cada método espera até o recurso estar pronto e devolve o URL final.

SDKs oficiais

Dois clientes oficiais envolvem a API REST da Pedra. Ambos são de código aberto, não têm dependências em tempo de execução e expõem todos os endpoints. Cada método espera até o recurso estar pronto e devolve o(s) URL(s) final(is) — sem IDs de tarefa para consultar.

Instalação

Node.js

npm install @pedra-ai/sdk

Python

pip install pedra

Autenticação

Passa a tua chave ao cliente ou define a variável de ambiente PEDRA_API_KEY. Obtém uma chave registando-te em app.pedra.ai e abrindo Definições → API. As chaves têm longa duração — nunca as incluas no código do cliente; chama a partir do teu backend. Vê Autenticação para detalhes.

from pedra import Pedra

# Reads PEDRA_API_KEY from the environment…
pedra = Pedra()

# …or pass the key explicitly
pedra = Pedra("YOUR_API_KEY")

Início rápido

Mobila uma divisão vazia. Todos os métodos de imagem devolvem a mesma forma — usa url para o primeiro recurso ou urls para todos.

from pedra import Pedra

pedra = Pedra()  # reads PEDRA_API_KEY

result = pedra.furnish(
    image_url="https://example.com/empty-living-room.jpg",
    room_type="Living room",
    style="Minimalist",
)

print(result.url)   # the staged image URL
print(result.urls)  # all generated URLs

O que podes chamar

Ambos os SDKs cobrem todos os endpoints da Pedra com os mesmos nomes de método em cada linguagem:

• furnish, empty, renovation, editViaPrompt, remove — vê Home staging virtual.
• enhance, enhanceAndCorrectPerspective, sky, blur — vê Melhoria de imagens.
• createVideo, updateVideo, generateVoiceScript, generateVoice, musicLibrary, além de credits e feedback — vê Vídeo e Créditos.
• listProperties, listPropertyImages, createProperty, addImagesToProperty — vê Propriedades.

Python usa snake_case (edit_via_prompt, create_video, update_video, generate_voice, music_library); os parâmetros e o comportamento são idênticos.

Tratamento de erros

Ambos os SDKs lançam PedraApiError para falhas da API (com status e body) e PedraError para erros de cliente/rede. Vê Erros e limites para a lista completa de modos de falha.

Servidor MCP

Preferes usar a Pedra a partir de um assistente de IA? O servidor MCP oficial da Pedra expõe as mesmas operações ao Claude, ChatGPT e Cursor, para fazeres staging e editares fotos de anúncios diretamente a partir de um chat.

Código & suporte

Ambos os SDKs têm licença MIT e são desenvolvidos de forma aberta. Dá uma estrela ou abre issues no GitHub, e envia email para felix@pedra.ai para ajuda com integração, quotas mais altas ou condições enterprise.

Perguntas frequentes