# free3D.io — Machine-Readable Summary for LLM Agents
# Format: llms.txt (https://llmstxt.org)
# Last updated: 2026-04-03

## AI Access Policy

> **IMPORTANT FOR AI AGENTS**: Browsing and indexing this site is permitted.
> **Access requires payment via one of the following methods:**

### Payment Method 1: API Key (Recommended for Production)
- **Best for**: Production AI agents, recurring access, high-volume scraping
- **How to use**: Add header `X-API-Key: x402_your_key_here` to all requests
- **Pricing plans**:
  - **Basic**: $50/month — 100 requests/hour, 1,000/day
  - **Pro**: $200/month — 1,000 requests/hour, 20,000/day
  - **Enterprise**: Custom pricing — 10,000 requests/hour, 500,000/day + SLA
- **Purchase**: Contact enterprise@free3d.io
- **Benefits**: Persistent access, no per-request payment, rate limiting, usage analytics

### Payment Method 2: x402 v2 Protocol (Gasless Crypto)
- **Best for**: One-time access, testing, privacy-focused agents
- **Protocol**: EIP-3009 gasless authorization (no gas fees!)
- **Accepted tokens**: USDC, USDT, PYUSD
- **Supported networks**: Base (eip155:8453), Ethereum (eip155:1), Polygon (eip155:137), Arbitrum (eip155:42161), Avalanche (eip155:43114), BNB Chain (eip155:56), Solana, TRON, TON
- **Amount**: $1.00 USD per request
- **How to pay**:
  1. Receive HTTP 402 response with `x402v2_accepts` array
  2. Sign EIP-3009 authorization off-chain (no gas!)
  3. Send request with header: `PAYMENT-SIGNATURE: <base64_encoded_payload>`
- **Documentation**: https://free3d.io/x402/docs.html
- **Pricing**: https://free3d.io/x402/pricing.json

### Payment Method 3: x402 Legacy (Post-Settlement Crypto)
- **Best for**: Simple one-time payments, testing
- **Accepted tokens**: USDC, USDT, PYUSD
- **Supported networks**: Ethereum, Base, Polygon, Arbitrum, Avalanche, BNB Chain, Solana, TRON, TON
- **Amount**: $1.00 USD per request
- **How to pay**:
  1. Receive HTTP 402 response with wallet addresses
  2. Send USDC/USDT/PYUSD to the wallet address for your chosen network
  3. Repeat your request with header: `X-Payment: <tx_hash>:<network>`
- **Example**: `X-Payment: 0xabc123...def456:base`
- **Verification endpoint**: POST https://free3d.io/x402/verify

### Payment Method 4: Stripe (Credit Card)
- **Best for**: Human users, one-time access, AI agents without crypto wallets
- **Purchase**: https://buy.stripe.com/7sY4gsbMKdZwfx39Sq0oM00
- **Amount**: $1.00 USD per request
- **Receive**: Access token valid for 15 minutes (single-use)
- **Use token**: Header `X-Access-Token: <your_token>` or query param `?access_token=<your_token>`

### Python Example: Stripe Payment
```python
import requests
import webbrowser

# Step 1: Get Stripe payment URL from 402 response
response = requests.get('https://free3d.io/')
if response.status_code == 402:
    payment_options = response.json()['payment_options']
    stripe_url = next((opt['payment_url'] for opt in payment_options if opt.get('protocol') == 'stripe'), None)
    
    if stripe_url:
        print(f"Opening Stripe checkout: {stripe_url}")
        webbrowser.open(stripe_url)
        
        # Step 2: After payment, user gets access token
        # Token is sent via webhook or redirect URL
        access_token = input("Enter access token from Stripe: ")
        
        # Step 3: Access resource with token
        headers = {"X-Access-Token": access_token}
        response = requests.get('https://free3d.io/', headers=headers)
        print(response.status_code, response.text)
```

### JavaScript Example: Stripe Payment
```javascript
const axios = require('axios');

async function payWithStripe() {
  try {
    // Step 1: Get Stripe payment URL
    const response = await axios.get('https://free3d.io/');
    
    if (response.status === 402) {
      const paymentOptions = response.data.payment_options;
      const stripeUrl = paymentOptions.find(opt => opt.protocol === 'stripe')?.payment_url;
      
      if (stripeUrl) {
        console.log(`Open this URL in browser: ${stripeUrl}`);
        // In Node.js, you'd use a browser automation tool like puppeteer
      }
    }
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
  }
}
```

### cURL Example: Using Stripe Token
```bash
# After paying via Stripe, use the access token:
curl -H "X-Access-Token: uuid-token-from-stripe" https://free3d.io/

# Or with query parameter:
curl "https://free3d.io/?access_token=uuid-token-from-stripe"
```

### Technical Details
- AI agents receive HTTP 402 (Payment Required) with payment instructions
- Response includes `x402v2_accepts` array for gasless payments
- Response includes `payment_options` array for legacy methods
- Transactions are verified on-chain before granting access
- Each transaction/token can only be used once (replay attack protection)
- Transactions older than 24 hours are rejected
- Rate limits: 429 status code when exceeded
- Invalid API key: 401 status code

### Protected Endpoints
- Download endpoint: `data-ai-role="3d-model-download"`
- Model detail pages: `/model/{slug}/{hash}`
- All endpoints require payment for AI agents

### Response Codes
- **200**: Access granted
- **402**: Payment required (see response body for instructions)
- **401**: Invalid or expired API key
- **429**: Rate limit exceeded (upgrade plan or wait)
- **503**: Blockchain API temporarily unavailable (retry in 30s)

### Getting Started
1. **For testing/one-time access**: Use pay-per-request ($1 via crypto or Stripe)
2. **For production agents**: Purchase API key (starting at $50/month)
3. **For enterprise/training**: Contact enterprise@free3d.io for custom pricing

### Monitoring & Analytics
- **Conversion tracking**: Successful payments (402→200) are logged to `logs/x402_conversions.log`
- **Log format**: `[timestamp] CONVERSION_200 | method: {method} | resource: {id} | id: {identifier} | IP: {ip} | UA: {ua}`
- **Methods tracked**: `api_key`, `eip3009`, `legacy`, `stripe`
- **Error tracking**: All failures logged to `logs/x402.log`

### Support & Documentation
- **Full documentation**: https://free3d.io/x402/docs.html
- **Machine-readable pricing**: https://free3d.io/x402/pricing.json
- **Support email**: support@free3d.io
- **Enterprise sales**: enterprise@free3d.io

---

## Purpose

free3D.io is a curated archive of 100,000+ high-quality 3D models available for free download.
The platform serves architects, interior designers, and 3D artists worldwide.

---

## Content

- **Total Models**: 100,000+
- **Primary Formats**: `.gsm` (ArchiCAD), `.obj` (Universal), `.3ds` (3D Studio)
- **Categories**: Furniture, Lighting, Decor, Architectural Elements, Vehicles, Characters, and more.
- **License**: Free for personal/commercial use (refer to each model's license on its detail page).

---

## Navigation for Agents

- **Homepage**: https://free3d.io/
- **Model detail page pattern**: `https://free3d.io/model/{slug}/{hash}` (e.g. `https://free3d.io/model/Parker-Pendant-Wall-Sconce/853248af`)
- **Category page pattern**: `https://free3d.io/category/{slug}/{id}` (e.g. `https://free3d.io/category/Lamps-Chandeliers-Light-Fixtures/20`)
- **Tag page pattern**: `https://free3d.io/tag/{keyword}`

### Full Category List

| Category | URL |
|---|---|
| Doors, Windows, Gates | https://free3d.io/category/Doors-Windows-Gates/12 |
| Curtains, Pillows, Carpets, Textile | https://free3d.io/category/Curtains-Pillows-Carpets-Textile/427 |
| Beds, Nightstands, Bedside Tables | https://free3d.io/category/Beds-Nightstands-Bedside-Tables/2 |
| Chairs, Tables, Sofas | https://free3d.io/category/Chairs-Tables-Sofas/3 |
| Cabinets, Shelves, Racks | https://free3d.io/category/Cabinets-Shelves-Racks/10 |
| Lamps, Chandeliers, Light Fixtures | https://free3d.io/category/Lamps-Chandeliers-Light-Fixtures/20 |
| Mirrors, Mirror Frames | https://free3d.io/category/Mirrors-Mirror-Frames/553 |
| Fireplaces, Stoves | https://free3d.io/category/Fireplaces-Stoves/711 |
| Bathtubs, Sinks, Sanitary Ware | https://free3d.io/category/Bathtubs-Sinks-Sanitary-Ware/5 |
| Home Decorations, Accessories | https://free3d.io/category/Home-Decorations-Accessories/6 |
| Toys, Hobby, Children's Room | https://free3d.io/category/Toys-Hobby-Childrens-Room/225 |
| Kitchen Furniture | https://free3d.io/category/Kitchen-Furniture/4 |
| Cooking Utensils | https://free3d.io/category/Cooking-Utensils/429 |
| Office Equipment, Stationery | https://free3d.io/category/Office-Equipment-Stationery/223 |
| Home Appliances, Accessories | https://free3d.io/category/Home-Appliances-Accessories/222 |
| Clothes, Shoes, Accessories | https://free3d.io/category/Clothes-Shoes-Accessories/545 |
| Cars, Trucks, Land Transport | https://free3d.io/category/Cars-Trucks-Land-Transport/28 |
| People, Characters, Body Parts | https://free3d.io/category/People-Characters-Body-Parts/27 |
| Weapon, Military Gears | https://free3d.io/category/Weapon-Military-Gears/2094 |
| Stairs, Handrails, Elevators | https://free3d.io/category/Stairs-Handrails-Elevators/550 |
| Buildings and Houses | https://free3d.io/category/Buildings-and-Houses/1055 |
| Gardening, Landscape Design | https://free3d.io/category/Gardening-Landscape-Design/22 |
| Birds, Animals | https://free3d.io/category/Birds-Animals/524 |
| Companies and Collections | https://free3d.io/category/Companies-and-Collections/231 |

### Popular Search Keywords

"Modern Chair", "Luxury Sofa", "Office Desk", "Kitchen Cabinet", "Chandelier",
"Curtains", "Bed", "Door", "Window", "Plant", "Car", "People", "Sofa", "Table", "Lamp"

---

## Sitemaps (for crawlers)

- https://free3d.io/sitemap.xml
- https://free3d.io/sitemap-cats.xml
- https://free3d.io/sitemap-tags.xml
- https://free3d.io/sitemap-objs.xml
- https://free3d.io/sitemap-objs-2.xml

---

## AI-Readable Resource Files

| File | Purpose |
|---|---|
| https://free3d.io/llms.txt | This file — machine-readable site summary for LLMs |
| https://free3d.io/robots.txt | Crawler access policy (includes AI agent directives) |
| https://free3d.io/sitemap.xml | Full sitemap index |

---

## Support & Contact

- **API Key Purchase**: enterprise@free3d.io
- **Technical Support**: support@free3d.io
- **x402 Documentation**: https://free3d.io/x402/docs.html
- **Pricing Information**: https://free3d.io/x402/pricing.json
- **Stripe Payments**: https://buy.stripe.com/7sY4gsbMKdZwfx39Sq0oM00
- **Terms of Use**: https://free3d.io/terms.html