🚀 Ommini API Belgeleri

n8n, Zapier, Make ve diğer otomasyon araçlarıyla Ommini'de video, gönderi ve doküman oluşturun.

Hızlı Başlangıç

API anahtarınızı Ayarlar → API Anahtarları sekmesinden oluşturun.

Tüm isteklerde anahtarı X-API-Key başlığında gönderin:

X-API-Key: omn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Temel Adres

https://ommini.com/api/v1

Kimlik Doğrulama

Sağlık kontrolü dışındaki tüm uç noktalar API anahtarı ister. Anahtar eksikse, geçersizse ya da devre dışı bırakılmışsa yanıt 401 olur.

Her anahtar yalnızca kendi hesabınızın kayıtlarına erişir.

📹 Video

POST /api/v1/video/create

Yapay zekâ ile video üretimini başlatır (fal.ai Kling v1.6). Üretim arka planda sürer ve genellikle 2-4 dakika alır.

Her video aylık plan kotanızdan düşülür. Kota dolduysa 5 kredi kullanılır. Kota ve kredi yetmiyorsa yanıt 429 olur.

İstek Gövdesi

prompt zorunlu

Videoyu anlatan metin. En iyi sonuç için İngilizce yazın.

baslik isteğe bağlı

Video başlığı. Verilmezse prompt metninin ilk 60 karakteri kullanılır.

sure isteğe bağlı

Süre (saniye): "5" ya da "10". Varsayılan: "5".

oran isteğe bağlı

En-boy oranı: "9:16", "16:9" ya da "1:1". Varsayılan: "9:16".

stil isteğe bağlı

Videoyla birlikte kaydedilen stil etiketi. Varsayılan: "cinematic".

cURL Örneği

curl -X POST https://ommini.com/api/v1/video/create \
  -H "X-API-Key: omn_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A calm turquoise sea at sunrise, gentle waves, cinematic drone shot",
    "baslik": "Sunrise Sea",
    "sure": "5",
    "oran": "9:16"
  }'

Yanıt

{
  "success": true,
  "video_id": 197,
  "durum": "isleniyor",
  "mesaj": "..."
}

GET /api/v1/video/{video_id}

Videonun durumunu ve ayrıntılarını getirir. Video işleniyorsa durum her sorguda güncellenir.

durum değerleri: isleniyor (üretim sürüyor), hazir (video_url dolu) ve hata (üretim başarısız).

Video hazır olana kadar 15-30 saniyede bir sorgulayın.

cURL Örneği

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

Yanıt

{
  "id": 197,
  "baslik": "Sunrise Sea",
  "prompt": "A calm turquoise sea at sunrise, gentle waves, cinematic drone shot",
  "stil": "cinematic",
  "sure": "5",
  "oran": "9:16",
  "durum": "hazir",
  "video_url": "https://v3b.fal.media/files/.../output.mp4",
  "thumbnail_url": null,
  "tarih": "2026-10-09T20:02:11"
}

GET /api/v1/videos

Videolarınızı en yeniden eskiye listeler.

Sorgu Parametreleri

limit isteğe bağlı

Döndürülecek en fazla kayıt sayısı. Varsayılan: 50.

offset isteğe bağlı

Atlanacak kayıt sayısı (sayfalama). Varsayılan: 0.

Yanıttaki total alanı bu yanıtta dönen kayıt sayısıdır. Her videoda id, baslik, durum, video_url ve tarih bulunur.

cURL Örneği

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

📝 Gönderi

Bu uç noktalar gönderiyi Ommini hesabınıza kaydeder. Gönderiyi sosyal medya hesaplarınızda kendileri yayınlamazlar.

POST /api/v1/post/create

Yeni bir gönderi kaydı oluşturur.

İstek Gövdesi

baslik zorunlu

Gönderi başlığı.

icerik zorunlu

Gönderi metni.

platform isteğe bağlı

Örneğin instagram, linkedin, twitter. Varsayılan: "genel".

durum isteğe bağlı

"taslak" ya da "yayinlandi". Varsayılan: "taslak".

cURL Örneği

curl -X POST https://ommini.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"
  }'

Yanıt

{
  "success": true,
  "post_id": 42,
  "mesaj": "..."
}

GET /api/v1/posts

Gönderilerinizi en yeniden eskiye listeler.

Sorgu Parametreleri

platform isteğe bağlı

Yalnızca bu platformdaki gönderiler.

durum isteğe bağlı

Yalnızca bu durumdaki gönderiler (taslak, yayinlandi, planli).

limit, offset isteğe bağlı

Sayfalama. Varsayılan: 50 ve 0.

Her gönderide id, baslik, icerik, platform, durum, tarih ve planlanan_tarih bulunur.

cURL Örneği

curl "https://ommini.com/api/v1/posts?platform=linkedin&durum=taslak" \
  -H "X-API-Key: omn_your_key"

POST /api/v1/post/schedule

Gönderiyi planlanan tarihiyle birlikte planli durumunda kaydeder.

İstek Gövdesi

baslik zorunlu

Gönderi başlığı.

icerik zorunlu

Gönderi metni.

platform zorunlu

Örneğin instagram, linkedin, twitter.

planlanan_tarih zorunlu

ISO 8601 biçiminde tarih, örneğin "2026-11-15T10:00:00". Biçim yanlışsa yanıt 400 olur.

cURL Örneği

curl -X POST https://ommini.com/api/v1/post/schedule \
  -H "X-API-Key: omn_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "baslik": "Weekend Sale",
    "icerik": "Do not miss our weekend sale!",
    "platform": "instagram",
    "planlanan_tarih": "2026-11-15T10:00:00"
  }'

Yanıt

{
  "success": true,
  "post_id": 43,
  "planlanan_tarih": "2026-11-15T10:00:00",
  "mesaj": "..."
}

📄 Doküman

POST /api/v1/document/create

Dokümanlar sayfanıza yeni bir doküman kaydeder.

İstek Gövdesi

baslik zorunlu

Doküman başlığı.

icerik zorunlu

Doküman metni.

tur isteğe bağlı

Doküman türü, örneğin Blog, Email, Rapor. Varsayılan: "Genel".

cURL Örneği

curl -X POST https://ommini.com/api/v1/document/create \
  -H "X-API-Key: omn_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "baslik": "Q4 Content Plan",
    "icerik": "Week 1: product teaser...",
    "tur": "Rapor"
  }'

Yanıt

{
  "success": true,
  "document_id": 15,
  "mesaj": "..."
}

GET /api/v1/documents

Dokümanlarınızı en yeniden eskiye listeler. Her dokümanda içeriğin ilk 200 karakteri döner.

Sorgu Parametreleri

tur isteğe bağlı

Yalnızca bu türdeki dokümanlar.

limit, offset isteğe bağlı

Sayfalama. Varsayılan: 50 ve 0.

✅ Sağlık Kontrolü

GET /api/v1/health

API'nin çalıştığını doğrular. API anahtarı gerekmez.

cURL Örneği

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

Yanıt

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

⚠️ Hata Kodları

API standart HTTP durum kodlarını kullanır:

200 OK - İstek başarılı
400 Bad Request - Geçersiz değer (örneğin sure, oran ya da tarih biçimi)
401 Unauthorized - API anahtarı eksik, geçersiz ya da devre dışı
404 Not Found - Kayıt bulunamadı ya da hesabınıza ait değil
422 Unprocessable Entity - Zorunlu alan eksik ya da alan türü yanlış
429 Too Many Requests - Video kotası ve kredi yetersiz
500 Internal Server Error - Sunucu hatası

Hata Yanıtı

{
  "detail": "API key required. Add an X-API-Key header."
}

detail alanındaki açıklama Accept-Language başlığına göre (tr, en veya ar) döner; başlık yoksa İngilizcedir. Otomasyonlarınızda hatanın türünü HTTP durum kodundan anlayın.

🔧 n8n Örneği: Video Üret ve Hazır Olunca Al

1. Üretimi başlatın (HTTP Request)

Method: POST
URL: https://ommini.com/api/v1/video/create
Headers: X-API-Key = omn_your_key
Body: JSON

{
  "prompt": "{{ $json.description }}",
  "sure": "5",
  "oran": "9:16"
}

2. Bekleyin (Wait)

60 saniye bekleyin.

3. Durumu sorgulayın (HTTP Request)

Method: GET
URL: https://ommini.com/api/v1/video/{{ $json.video_id }}

4. Kontrol edin (IF)

durum değeri hazir ise video_url ile devam edin. isleniyor ise 2. adıma dönün, hata ise akışı durdurun.

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

Entegrasyonla ilgili sorularınız için destek@ommini.com adresinden bize ulaşın.