Documentação

Início Rápido

Comece com a API de Restauração de Fotos em apenas alguns minutos. Este guia irá orientá-lo através dos passos essenciais para integrar a restauração de fotos alimentada por IA em sua aplicação.

Pré-requisitos

Antes de começar, certifique-se de ter:

  • Conta: Registre-se em restoreoldphotos.online
  • Chave API: Crie uma chave API nas configurações
  • Créditos: Compre créditos de restauração de fotos
  • URL da Imagem: Uma URL de imagem publicamente acessível para testes

Passo 1: Obtenha Sua Chave API

  1. Visite restoreoldphotos.online
  2. Faça login com sua conta Google
  3. Navegue para Configurações > Chaves API
  4. Clique no botão "Criar Nova Chave API"
  5. Digite um nome para a chave (ex: "Minha App")
  6. Após criar a chave, copie o valor completo da chave (mantenha-a segura!)

Formato da Chave API

  • Começa com sk-
  • Contém caracteres gerados aleatoriamente
  • Exemplo: sk-abc123def456ghi789...

Passo 2: Faça Sua Primeira Chamada API

Usando cURL

curl -X POST https://restoreoldphotos.online/api/api-call/photo-restore \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "imageUrl": "https://example.com/old-photo.jpg"
  }'

Usando JavaScript

async function restorePhoto(imageUrl, apiKey) {
  try {
    const response = await fetch('https://restoreoldphotos.online/api/api-call/photo-restore', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${apiKey}`
      },
      body: JSON.stringify({
        imageUrl: imageUrl
      })
    });
 
    if (!response.ok) {
      throw new Error(`API Error: ${response.status}`);
    }
 
    const result = await response.json();
    return result.output; // URL ou string base64
  } catch (error) {
    console.error('Error:', error);
    throw error;
  }
}
 
// Uso
const restoredImage = await restorePhoto(
  'https://example.com/old-photo.jpg',
  'your-api-key-here'
);
console.log('Restored image:', restoredImage);

Passo 3: Trate a Resposta

A API retorna uma resposta JSON com a imagem restaurada:

{
  "output": "https://replicate.delivery/pbxt/xxx.png"
}

Ou em formato base64:

{
  "output": "data:image/png;base64,iVBORw0KGgoAAAANS..."
}

O campo output contém:

  • URL da Imagem: Link direto para a imagem restaurada
  • String Base64: Dados da imagem codificados em base64

Passo 4: Exiba o Resultado

Em HTML

<img src="https://replicate.delivery/pbxt/xxx.png" alt="Foto Restaurada" />

Em JavaScript

// Para URL ou base64
const img = document.createElement('img');
img.src = restoredImage; // campo output da resposta da API
document.body.appendChild(img);

Passo 5: Tratamento de Erros

Sempre implemente tratamento de erro adequado:

try {
  const restoredImage = await restorePhoto(imageUrl, apiKey);
  // Trate o sucesso
} catch (error) {
  if (error.message.includes('401')) {
    console.error('Chave API inválida');
  } else if (error.message.includes('402')) {
    console.error('Créditos insuficientes');
  } else if (error.message.includes('429')) {
    console.error('Limite de taxa excedido');
  } else {
    console.error('Erro da API:', error.message);
  }
}

Gerenciamento de Chaves API

Gerenciando Chaves nas Configurações

  • Visualize a lista de todas as chaves API
  • Visualize estatísticas de uso das chaves
  • Desative ou exclua chaves não utilizadas
  • Visualize a última vez que as chaves foram usadas

Melhores Práticas de Segurança

  • Nunca codifique chaves API no código do lado do cliente
  • Armazene chaves usando variáveis de ambiente
  • Rotacione chaves API regularmente
  • Use chaves diferentes para ambientes diferentes

Exemplo de Variáveis de Ambiente

# arquivo .env
PHOTO_RESTORE_API_KEY=sk-your-api-key-here
// Use no código
const apiKey = process.env.PHOTO_RESTORE_API_KEY;