Documentación

Inicio Rápido

Comienza con la API de Restauración de Fotos en solo unos minutos. Esta guía te llevará a través de los pasos esenciales para integrar la restauración de fotos impulsada por IA en tu aplicación.

Prerrequisitos

Antes de comenzar, asegúrate de tener:

  • Cuenta: Regístrate en restoreoldphotos.online
  • Clave API: Crea una clave API en la configuración
  • Créditos: Compra créditos de restauración de fotos
  • URL de Imagen: Una URL de imagen públicamente accesible para pruebas

Paso 1: Obtén Tu Clave API

  1. Visita restoreoldphotos.online
  2. Inicia sesión con tu cuenta de Google
  3. Navega a Configuración > Claves API
  4. Haz clic en el botón "Crear Nueva Clave API"
  5. Ingresa un nombre para la clave (ej: "Mi App")
  6. Después de crear la clave, copia el valor completo de la clave (¡guárdala de forma segura!)

Formato de la Clave API

  • Comienza con sk-
  • Contiene caracteres generados aleatoriamente
  • Ejemplo: sk-abc123def456ghi789...

Paso 2: Haz Tu Primera Llamada 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 o cadena 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);

Paso 3: Maneja la Respuesta

La API devuelve una respuesta JSON con la imagen restaurada:

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

O en formato base64:

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

El campo output contiene:

  • URL de Imagen: Enlace directo a la imagen restaurada
  • Cadena Base64: Datos de imagen codificados en base64

Paso 4: Muestra el Resultado

En HTML

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

En JavaScript

// Para URL o base64
const img = document.createElement('img');
img.src = restoredImage; // campo output de la respuesta de la API
document.body.appendChild(img);

Paso 5: Manejo de Errores

Siempre implementa un manejo de errores adecuado:

try {
  const restoredImage = await restorePhoto(imageUrl, apiKey);
  // Maneja el éxito
} catch (error) {
  if (error.message.includes('401')) {
    console.error('Clave API inválida');
  } else if (error.message.includes('402')) {
    console.error('Créditos insuficientes');
  } else if (error.message.includes('429')) {
    console.error('Límite de tasa excedido');
  } else {
    console.error('Error de API:', error.message);
  }
}

Gestión de Claves API

Gestionando Claves en Configuración

  • Ver lista de todas las claves API
  • Ver estadísticas de uso de claves
  • Desactivar o eliminar claves no utilizadas
  • Ver última vez que se usaron las claves

Mejores Prácticas de Seguridad

  • Nunca codifiques claves API en el código del lado del cliente
  • Almacena claves usando variables de entorno
  • Rota claves API regularmente
  • Usa claves diferentes para diferentes entornos

Ejemplo de Variables de Entorno

# archivo .env
PHOTO_RESTORE_API_KEY=sk-your-api-key-here
// Usa en el código
const apiKey = process.env.PHOTO_RESTORE_API_KEY;