🚀 Ommini API Dokümantasyonu

n8n, Zapier, Make ve diğer otomasyon platformları ile Ommini'yi entegre edin.

Hızlı Başlangıç

API Key'inizi Ayarlar > API Keys sayfasından oluşturun.

Tüm isteklerde X-API-Key header'ını kullanın:

X-API-Key: omn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Base URL

https://yourdomain.com/api/v1

Authentication

Tüm endpoint'ler API Key authentication gerektirir. Her istekte header ekleyin:

X-API-Key: omn_your_secret_key_here

📹 Video Endpoints

POST /api/v1/video/create

Yeni video oluşturma isteği gönderir. Video arka planda işlenir.

Request Body

prompt required
Video için metin prompt (örn: "A golden sunset over mountains")
baslik optional
Video başlığı
stil optional
Görsel stil: "cinematic", "realistic", "anime" (varsayılan: "cinematic")
sure optional
Video süresi: "5" veya "10" saniye (varsayılan: "5")
oran optional
En-boy oranı: "9:16", "16:9", "1:1" (varsayılan: "9:16")

cURL Example

curl -X POST https://yourdomain.com/api/v1/video/create \
  -H "X-API-Key: omn_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A serene lake at sunset with mountains in background",
    "baslik": "Sunset Lake Video",
    "stil": "cinematic",
    "sure": "5",
    "oran": "16:9"
  }'

Response

{
  "success": true,
  "video_id": 123,
  "durum": "isleniyor",
  "mesaj": "Video oluşturma isteği alındı"
}
GET /api/v1/video/{video_id}

Video durumunu ve detaylarını getirir.

cURL Example

curl https://yourdomain.com/api/v1/video/123 \
  -H "X-API-Key: omn_your_key"

Response

{
  "id": 123,
  "baslik": "Sunset Lake Video",
  "prompt": "A serene lake at sunset...",
  "durum": "tamamlandi",
  "video_url": "https://cdn.example.com/video123.mp4",
  "thumbnail_url": "https://cdn.example.com/thumb123.jpg",
  "tarih": "2024-05-15T14:30:00"
}
GET /api/v1/videos

Videolarınızı listeler (sayfalama ile).

Query Parameters

limit optional - Sayfa başına sonuç (varsayılan: 50)
offset optional - Atlanacak sonuç sayısı (varsayılan: 0)

cURL Example

curl "https://yourdomain.com/api/v1/videos?limit=10&offset=0" \
  -H "X-API-Key: omn_your_key"

📝 Post Endpoints

POST /api/v1/post/create

Yeni sosyal medya gönderisi oluşturur.

Request Body

baslik required - Gönderi başlığı
icerik required - Gönderi içeriği
platform optional - instagram, linkedin, twitter, vb.
durum optional - taslak veya yayinlandi

cURL Example

curl -X POST https://yourdomain.com/api/v1/post/create \
  -H "X-API-Key: omn_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "baslik": "New Product Launch",
    "icerik": "Excited to announce our new product!",
    "platform": "linkedin",
    "durum": "taslak"
  }'
POST /api/v1/post/schedule

Gönderiyi gelecek bir tarihte yayınlamak için planlar.

Request Body

planlanan_tarih required - ISO 8601 format: "2024-05-15T14:30:00"

cURL Example

curl -X POST https://yourdomain.com/api/v1/post/schedule \
  -H "X-API-Key: omn_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "baslik": "Weekend Sale",
    "icerik": "Don't miss our weekend sale!",
    "platform": "instagram",
    "planlanan_tarih": "2024-05-18T10:00:00"
  }'

📄 Document Endpoints

POST /api/v1/document/create

Yeni doküman oluşturur.

Request Body

baslik required - Doküman başlığı
icerik required - Doküman içeriği (markdown destekler)
tur optional - Blog, Email, Rapor, vb.
GET /api/v1/documents

Dokümanlarınızı listeler.

Query Parameters

tur optional - Belirli türü filtreler
limit, offset optional - Sayfalama

✅ Health Check

GET /api/v1/health

API durumunu kontrol eder (authentication gerektirmez).

cURL Example

curl https://yourdomain.com/api/v1/health

Response

{
  "status": "ok",
  "version": "1.0.0",
  "service": "Ommini API"
}

⚠️ Error Handling

API standart HTTP durum kodları kullanır:

Error Response Format

{
  "detail": "Geçersiz API Key"
}

⏱️ Rate Limiting

Her API Key'in saatlik ve günlük istek limitleri vardır:

🔧 n8n Workflow Örneği

1. HTTP Request Node Ekleyin

2. JSON Body Örneği

{
  "prompt": "{{ $json.description }}",
  "stil": "cinematic",
  "sure": "5"
}

💡 Yardıma mı ihtiyacınız var?

Entegrasyon konusunda sorularınız varsa support@ommini.com adresinden bize ulaşın.