HÜMA AI Dokümantasyonu

5 AI platformunu tek arayüzden yönetin. Kapsamlı rehber ve API dokümantasyonu.

Giriş

HÜMA AI, birden fazla yapay zeka platformunu tek bir arayüz altında toplayan multi-AI yönetim platformudur. OpenAI ChatGPT, Anthropic Claude, Google Gemini, HÜMA AI ve Ollama gibi önde gelen AI modellerine tek bir API ile erişim sağlar.

Temel Özellikler

  • Çoklu AI Desteği: 5 farklı AI platformunu tek yerden yönetin
  • Unified API: Tek bir API formatı ile tüm modellere erişim
  • Akıllı Routing: Kullanım senaryonuza göre otomatik model seçimi
  • Maliyet Optimizasyonu: Gerçek zamanlı maliyet karşılaştırması ve optimizasyon
  • Türkçe Optimizasyonu: Türk kültürüne özel prompt engineering
  • Self-Hosted Seçenek: Kendi altyapınızda çalıştırma imkanı
  • WhatsApp Entegrasyonu: AI asistanınızı WhatsApp'tan kullanın

Sistem Gereksinimleri

Bileşen Minimum Önerilen
Node.js 16.x 20.x veya üzeri
RAM 512 MB 2 GB
Disk 500 MB 2 GB
İşletim Sistemi Linux, Windows, macOS Ubuntu 22.04 LTS

Kurulum

Cloud SaaS (Önerilen)

En hızlı başlangıç yolu cloud platformumuzu kullanmaktır. Kurulum gerektirmez, anında kullanmaya başlayabilirsiniz.

  1. app.huma.ai adresini ziyaret edin
  2. Hesap oluşturun veya giriş yapın
  3. API anahtarlarınızı yapılandırın
  4. Kullanmaya başlayın!

Self-Hosted (Docker)

Kendi sunucunuzda çalıştırmak için Docker kullanabilirsiniz.

# Docker Hub'dan çekin docker pull humaai/huma:latest # Çalıştırın docker run -d \ --name huma-ai \ -p 18789:18789 \ -v /path/to/config:/app/config \ -e NODE_ENV=production \ humaai/huma:latest # Tarayıcınızda açın # http://localhost:18789

Self-Hosted (Kaynak Kod)

Kaynak koddan kurulum için:

# Repository'yi klonlayın git clone https://github.com/humaai/huma.git cd huma # Bağımlılıkları yükleyin npm install # .env dosyasını oluşturun cp .env.example .env # API anahtarlarınızı yapılandırın nano .env # Uygulamayı başlatın npm start # Production için PM2 ile pm2 start server/api-server.js --name huma

İpucu

Production ortamında PM2 kullanmanızı öneriyoruz. PM2, uygulamanızın sürekli çalışmasını sağlar ve otomatik yeniden başlatma özelliği sunar.

Hardware Kurulumu (Raspberry Pi / NanoPi)

IoT cihazlarında çalıştırmak için özel kurulum scripti kullanın:

# Kurulum scriptini indirin wget https://install.huma.ai/hardware.sh # Çalıştırın chmod +x hardware.sh sudo ./hardware.sh # İzleyin sudo systemctl status huma

Hızlı Başlangıç

1. API Anahtarları

Öncelikle kullanmak istediğiniz AI platformlarının API anahtarlarını almanız gerekiyor:

2. Yapılandırma

Web arayüzünden Ayarlar > API Anahtarları bölümüne gidin ve anahtarlarınızı ekleyin:

# .env dosyası formatı (self-hosted için) OPENAI_API_KEY=sk-... ANTHROPIC_API_KEY=sk-ant-... GOOGLE_API_KEY=AIza... HUMA_API_KEY=huma_... OLLAMA_URL=http://localhost:11434

3. İlk Sohbet

  1. Ana panele dönün
  2. Sol menüden "Yeni Sohbet" butonuna tıklayın
  3. Üst menüden AI modelini seçin (GPT-4o, Claude, vb.)
  4. Mesajınızı yazın ve Enter'a basın

Model Seçimi İpuçları

  • GPT-4o: Genel amaçlı, hızlı yanıtlar
  • Claude 3.5 Sonnet: Uzun metinler, kod analizi
  • Gemini 2.0 Flash: Çok hızlı, düşük maliyet
  • HÜMA AI: Türkçe optimize, kültürel bağlam
  • Ollama (Llama 3.3): Tamamen offline, gizlilik

WhatsApp Entegrasyonu

HÜMA AI'yı WhatsApp Business API ile entegre ederek müşterilerinize AI destekli otomatik yanıt sistemi sunabilirsiniz.

Kurulum Adımları

  1. WhatsApp Business hesabı oluşturun
  2. Meta Business Manager'dan API erişimi alın
  3. HÜMA AI panelinden WhatsApp entegrasyonunu aktifleştirin
  4. Webhook URL'ini Meta'ya kaydedin
  5. Verification token'ı doğrulayın

Özellikler

  • Otomatik mesaj yanıtlama
  • Multi-AI model desteği
  • Medya dosyası işleme
  • Session yönetimi
  • Rate limiting

WhatsApp Politikaları

WhatsApp Business API kullanımında Meta'nın ticari mesajlaşma politikalarına uymak zorunludur. 24 saatlik mesajlaşma penceresi kuralına dikkat edin.

Sorun Giderme

API Anahtarı Hatası

Hata: "Invalid API key" veya "Unauthorized"

Çözüm:

  • API anahtarınızın doğru girildiğinden emin olun
  • Anahtarın aktif olduğunu kontrol edin
  • Platform'un (OpenAI, Claude, vb.) hesabınızda bakiye olduğundan emin olun

Rate Limit Aşımı

Hata: "Rate limit exceeded"

Çözüm:

  • İstek hızınızı azaltın
  • Daha yüksek tier'a yükseltin
  • Birden fazla API anahtarı kullanarak load balancing yapın

Model Yanıt Vermiyor

Çözüm:

  • Network bağlantınızı kontrol edin
  • Provider status sayfalarını kontrol edin
  • Timeout süresini artırın
  • Alternatif model deneyin

Self-Hosted Kurulum Sorunları

# Log'ları kontrol edin pm2 logs huma # Port kullanımda mı? netstat -tulpn | grep 18789 # Node.js versiyonu node --version # 20.x olmalı # Yeniden başlatın pm2 restart huma

Destek

Sorununuzu çözemediyseniz:

  • Email: support@huma.ai
  • Discord: discord.gg/humaai
  • GitHub Issues: github.com/humaai/huma/issues
  • Telefon: +90 850 XXX XX XX (Business ve Enterprise)