API de Restauração de Fotos

A API de Restauração de Fotos permite que você restaure fotos antigas e danificadas usando tecnologia de IA avançada. Este endpoint processa imagens e retorna uma versão restaurada. Experimente o poderoso recurso de restauração de fotos com IA do Restore Old Photos.

Endpoint

POST /api/api-call/photo-restore

Autenticação

Requer uma chave de API válida no cabeçalho Authorization:

Authorization: Bearer YOUR_API_KEY

Requisição

Cabeçalhos

Parâmetros do Corpo

Exemplo de Requisição

{
  "imageUrl": "https://example.com/old-photo.jpg"
}

Resposta

Resposta de Sucesso (200)

A API retorna a URL ou string base64 da imagem restaurada. A plataforma gerencia automaticamente todos os tipos de stream, e o campo output é sempre uma URL ou string base64.

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

ou:

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

Descrição:

• A saída é a URL da imagem (recomendado) ou string base64 (para imagens parciais/arquivos grandes)
• Nenhum objeto de stream é retornado, os usuários podem usá-lo diretamente para tags img ou download

Respostas de Erro

400 Bad Request

{
  "message": "Entrada inválida"
}

401 Unauthorized

{
  "message": "Chave de API inválida ou expirada"
}

402 Payment Required

{
  "message": "Créditos insuficientes"
}

500 Internal Server Error

{
  "message": "Erro de serviço"
}

429 Too Many Requests

{
  "message": "Limite de taxa excedido. Tente novamente mais tarde."
}

Limites de Taxa

• Limite: 100 requisições por hora por chave de API
• Janela: 60 minutos
• Resposta: 429 Too Many Requests quando excedido

Exemplos de Uso

JavaScript/Node.js

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) {
      const error = await response.text();
      throw new Error(`Erro da API: ${response.status} - ${error}`);
    }
 
    const result = await response.json();
    
    // A saída é sempre uma string (URL ou base64)
    if (result.output.startsWith('data:image')) {
      // Dados de imagem base64
      return result.output;
    } else if (result.output.startsWith('http')) {
      // URL da imagem
      return result.output;
    } else {
      throw new Error('Formato de saída inválido');
    }
  } catch (error) {
    console.error('Erro ao restaurar foto:', error);
    throw error;
  }
}
 
// Uso
const restoredImage = await restorePhoto(
  'https://example.com/old-photo.jpg',
  'your-api-key-here'
);
console.log('Imagem restaurada:', restoredImage);

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"
  }'

Requisitos de Imagem

• Formato: JPG, PNG, WebP
• Tamanho: Máximo 5MB
• Acessibilidade: A URL da imagem deve ser publicamente acessível
• Conteúdo: Deve ser um arquivo de imagem válido

Tempo de Processamento

• Típico: 10-30 segundos
• Imagens grandes: Pode levar até 60 segundos

Créditos

• Custo: 1 crédito por restauração
• Dedução: Os créditos são deduzidos após processamento bem-sucedido

Melhores Práticas

1. Qualidade da imagem: Use imagens de alta qualidade para melhores resultados
2. Tratamento de erros: Sempre implemente tratamento de erros adequado
3. Gerenciamento de créditos: Monitore regularmente seu saldo de créditos
4. Processamento de saída: A saída é sempre uma string, nenhum processamento de stream necessário

Solução de Problemas

Problemas Comuns

401 Unauthorized

• Verifique se sua chave de API está correta
• Certifique-se de que a chave de API está ativa e não expirou

402 Payment Required

• Adicione créditos à sua conta
• Verifique seu saldo de créditos atual

400 Bad Request

• Verifique se a imageUrl é uma URL válida e acessível
• Certifique-se de que o formato da imagem é suportado

Formato de Saída Inválido

• A saída deve sempre ser uma string (URL ou base64)
• Verifique se a resposta da API contém o campo de saída esperado

429 Too Many Requests

• Você excedeu o limite de taxa de 100 requisições por hora
• Aguarde a janela de limite de taxa ser redefinida antes de fazer mais requisições

Suporte

Se você encontrar problemas não cobertos aqui, entre em contato com nossa equipe de suporte.