Metadata-Version: 2.4
Name: ihub-phoenix
Version: 4.3.2
Summary: iHub Phoenix Native Server - Zero Third-Party Crypto/HTTP, Production-grade proprietary HTTP server with native AI stack
Author-email: "iHub Intelligence Ltd." <contact@ihub-global.com>
License: Proprietary - iHub Intelligence Ltd.
Project-URL: Homepage, https://ihub-global.com
Project-URL: Documentation, https://docs.ihub-global.com
Project-URL: Repository, https://github.com/ihub/phoenix
Project-URL: Bug Reports, https://github.com/ihub/phoenix/issues
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: requests>=2.34.0
Requires-Dist: stripe>=15.0.0
Requires-Dist: psutil>=5.9.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: isort>=5.12.0; extra == "dev"
Requires-Dist: flake8>=6.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Provides-Extra: monitoring
Requires-Dist: prometheus-client>=0.17.0; extra == "monitoring"
Requires-Dist: psutil>=5.9.0; extra == "monitoring"
Provides-Extra: redis
Requires-Dist: redis>=5.0.0; extra == "redis"
Provides-Extra: postgres
Requires-Dist: psycopg2-binary>=2.9.0; extra == "postgres"
Provides-Extra: all
Requires-Dist: ihub-phoenix[dev,monitoring,postgres,redis]; extra == "all"

# iHub APi Platform
<div align="center">

**Version 3.0.0** | [Terms of Service](https://api.ihub-global.com/terms.html) | [Privacy Policy](https://api.ihub-global.com/privacy.html) | [Support](mailto:support@ihub-global.com)

</div>

> Domain Clarification Note: The root `ihub-global.com` domain hosts the main consumer iHub application. All developer API, dashboard, and documentation resources run on the fully isolated dedicated `api.ihub-global.com` subdomain with independent DNS, caching, firewall and security rules to eliminate routing conflicts with the primary consumer platform.

---

## 📋 Table of Contents

- 📖 [Overview](#overview)
- 💰 [Pricing](#pricing)
- 🚀 [Quick Start](#quick-start)
- 🔐 [Authentication](#authentication)
- 📡 [API Endpoints](#api-endpoints)
- 💻 [Code Examples](#code-examples)
- ⚠️ [Error Handling](#error-handling)
- ⏱️ [Rate Limits](#rate-limits)
- 🧰 [SDKs & Libraries](#sdks--libraries)
- 🚢 [Deployment](#deployment)
- ❓ [FAQ](#faq)

---

## 📖 Overview

The iHub API allows developers to programmatically integrate iHub services into their applications. Create unlimited API keys, manage users, and build on top of the dedicated iHub developer platform, fully separated from the core consumer application hosted at root `ihub-global.com`.

### 🔗 Base URLs

| Environment | URL | Isolation Note |
|-------------|-----|----------------|
| **Production Developer API & Dashboard** | `https://api.ihub-global.com/api` | Independent subdomain, no shared routing with root consumer app |
| **Local Development** | `http://localhost:5000/api` | Local-only backend for offline testing |

### ✨ Features

- ✅ Unlimited API keys per project
- ✅ Unlimited projects per developer account
- ✅ Real-time cross-platform user management
- ✅ Enterprise-grade isolated subdomain security
- ✅ 99.9% uptime SLA dedicated exclusively to API workloads

---

## 💰 Pricing

### 🟤 Free Starter (Copper Tier) - $0/month
| Feature | Limit |
|---------|-------|
| API Requests | 1,000 text-only per day |
| Image/Video/Voice Generation | ❌ Locked |
| API Keys | Unlimited (sandbox only) |
| iHPay Payment Keys | Sandbox test keys only |
| iHub Aether Offline Engine | ❌ Locked |
| aether-compat GGUF Proxy | ❌ Locked |
| Live Merchant Checkout | ❌ Blocked |
| Support | Community Forum Access |
| **Cost** | **$0 / month** |

---

### ⚫ Basic (Iron Tier) - $19/month
| Feature | Limit |
|---------|-------|
| API Requests | 10,000 text-only per day |
| Image Generation | ✅ Test inference unlocked |
| Video/Voice Generation | ❌ Locked |
| API Keys | Unlimited live sandbox keys |
| iHPay Payment Keys | Limited live merchant keys |
| iHub Aether Offline Engine | ❌ Locked |
| aether-compat GGUF Proxy | ❌ Locked |
| Support | Email response within 48 hours |
| **Cost** | **$19 / month** |

---

### 🟠 Pro Developer (Amber / Enterprise Lite) - $29/month ⭐ Most Popular
| Feature | Limit |
|---------|-------|
| API Requests | 50,000 per day (text/image/voice) |
| Video Generation | ❌ Locked |
| API Keys | Unlimited live production keys |
| iHPay Payment Keys | ✅ Unlimited live merchant keys |
| Branded Payment Links | ✅ Included |
| QR Checkout | ✅ Included |
| Recurring Subscriptions | ✅ Included |
| iHub Aether Offline Engine | ✅ Single workstation deployment |
| aether-compat GGUF Proxy | ✅ Included |
| White-label Checkout | ❌ Locked (Enterprise Self-Host only) |
| Docker/Kubernetes Support | ❌ Locked (Enterprise Self-Host only) |
| Support | Priority Email within 24 hours |
| Real-Time Analytics Dashboard | ✅ Included |
| **Cost** | **$29 / month** |

---

### ⚪ Premium (Steel Tier) - $149/month
| Feature | Limit |
|---------|-------|
| API Requests | 200,000 per month combined quota |
| Video Generation | ✅ Fully unlocked |
| API Keys | Unlimited live production keys |
| iHPay Payment Keys | ✅ Unlimited live merchant keys |
| Team Member Seats | Up to 3 collaborative accounts |
| Advanced Payment Workflows | ✅ Included |
| iHub Aether Offline Engine | ✅ Full workstation deployment |
| aether-compat GGUF Proxy | ✅ Included |
| Docker/Kubernetes Support | ❌ Locked (Enterprise Self-Host only) |
| Support | Priority Email + Live Chat Support |
| Real-Time Analytics Dashboard | ✅ Included |
| **Cost** | **$149 / month** |

---

### 💜 Enterprise Self-Host (Amethyst Tier) - $499/month
| Feature | Limit |
|---------|-------|
| API Requests | 500,000 per month combined quota |
| Video Generation | ✅ Fully unlocked |
| API Keys | Unlimited live production keys |
| iHPay Payment Keys | ✅ Unlimited live merchant keys |
| White-label Unbranded Checkout | ✅ Full customer branding control |
| Bulk Mass Payment Link Generation | ✅ Included |
| Automated Vendor Payout Orchestration | ✅ Included |
| Discounted Platform Processing Fees | ✅ Eligible for $250k+ monthly transaction volume |
| iHub Aether Offline Engine | ✅ Full Docker CUDA container deployments |
| aether-compat GGUF Proxy | ✅ Multi-node load balancing support |
| Kubernetes Production Orchestration | ✅ Fully included |
| Team Shared Encrypted Secret Vaults | ✅ CollaborativeWorkspaceCore integration |
| Granular Role-Based Access Permissions | ✅ Included |
| Dedicated Enterprise Account Manager | ✅ 24/7 assigned support contact |
| Legally Binding Formal SLA Contract | ✅ Customizable terms |
| On-Premise Private Infrastructure Deployment | ✅ Available |
| Support | 24/7 Phone + Priority Email Support |
| **Cost** | **$499 / month** |

---

### ☁️ Cloud AI Inference Monthly Volume Tier Pricing
Pay-as-you-go overage pricing for cloud AI requests exceeding your plan’s fixed monthly quota.

| Monthly Combined Request Volume | Flat Base Monthly Fee | Cost Per 1,000 Additional Requests |
|----------------|----------|-------------------------------|
| 100,000 – 499,999 | $49 Flat | $0.49 |
| 500,000 – 1,999,999 | $149 Flat | $0.30 |
| 2,000,000 – 9,999,999 | $399 Flat | $0.20 |
| 10,000,000+ Custom Enterprise Scale | Covered under Amethyst Self-Host Tier | Auto-applied high-volume discounted overage rates |

---

### 📈 How to Upgrade Your Developer Plan
1. Register a free developer account via the dedicated API registration endpoint: `/api/register`
2. Log into your isolated developer dashboard at `https://api.ihub-global.com/dashboard.html`
3. Navigate to Billing > "Upgrade Plan" and complete secure payment checkout
4. Your active API keys automatically receive updated request limits within 60 seconds

> 🔒 **Global Platform Security Note:** All subscription tiers include AES-GCM post-quantum encryption, dedicated subdomain DDoS protection isolated from the main consumer app, and automated encrypted daily backups for all developer project data.

---

## 🚀 Quick Start Guide

### 1. Register a Dedicated Developer Account
All developer accounts exist solely on the `api.ihub-global.com` subdomain and are fully separate from consumer accounts on the root `ihub-global.com` platform.

```bash
curl -X POST https://api.ihub-global.com/api/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "developer@mycompany.com",
    "password": "SecurePass123!",
    "name": "Eyezman Developer",
    "company": "iHub Intelligence Limited"
  }'
