API Documentation

Authorization: Key YOUR_API_TOKEN

Content-Type: multipart/form-data

files: [binary file data]    # PDF datasheet or image
prompt: string               # Description of the component (optional)
tool_type: string            # Target EDA tool: "eagle", "kicad", or "allegro"

{
  "result": "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<!DOCTYPE eagle ...>...",
  "success": true
}

curl -X POST https://inference.footprintai.net/v1/api/generate-lib/ \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "files=@/path/to/datasheet.pdf" \
  -F "tool_type=eagle" \
  -F "prompt=QFN-48 package with exposed pad"

const formData = new FormData();
formData.append('files', datasheetFile);
formData.append('tool_type', 'eagle');
formData.append('prompt', 'QFN-48 package with exposed pad');

const response = await fetch('https://inference.footprintai.net/v1/api/generate-lib/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN'
  },
  body: formData
});

const data = await response.json();
console.log(data.result); // Library XML content

import requests

url = "https://inference.footprintai.net/v1/api/generate-lib/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

with open("datasheet.pdf", "rb") as f:
    files = {"files": f}
    data = {
        "tool_type": "eagle",
        "prompt": "QFN-48 package with exposed pad"
    }
    response = requests.post(url, headers=headers, files=files, data=data)

result = response.json()
with open("output.lbr", "w") as f:
    f.write(result["result"])

// 401 Unauthorized - Invalid or missing API token
{"error": "Invalid API token"}

// 402 Payment Required - Subscription required or tokens exhausted
{"error": "Subscription required"}

// 400 Bad Request - Invalid request parameters
{"error": "Missing required field: files"}