API Reference

Quick Start

Get your first photorealistic skin enhancement in under 5 minutes.

1. Get your API key

Sign up → Dashboard → Profile → API Keys → Generate key.

2. Make your first call

// npm install axios
const axios = require('axios');

const response = await axios.post(
  'https://api.skinforge.app/v1/enhance',
  {
    image_url:  'https://your-host.com/portrait.jpg',
    quality:    'hd',       // 'standard' | 'hd' | 'ultra'
    preserve:   true,       // identity preservation
    skin_tone:  'auto',     // 'auto' | 'dark' | 'medium' | 'light'
  },
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json',
    }
  }
);

console.log(response.data.outputUrl); // Enhanced image URL

3. Response

{
  "success":        true,
  "enhancementId":  "sf_abc123xyz",
  "outputUrl":      "https://cdn.skinforge.app/out/abc123.jpg",
  "watermarked":    false,
  "model":          "flux-srpo",
  "processingTime": 28400,
  "usageAfter": {
    "today":  1,
    "month":  1,
    "limit":  100
  }
}