Orkas'ın sohbet, arama, konuşma, görsel ve video yeteneklerini kendi araçlarınıza bağlayın. Çoğu yapay zekâ uygulamasının kullandığı temel URL'yi, API anahtarını ve model adlarını bulmak için Sohbet bölümünden başlayın.
Chat ve Responses, model yanıtları ve uygulamanızın işleyeceği özel işlev çağrıları sağlar; görüntü ve video uç noktaları medya üretir. Bu API çağrıları masaüstü Commander görevini başlatmaz veya masaüstü ajanlarını otomatik olarak devreye sokmaz. Ek ajan koordinasyonu, uygulamanızın iş akışına bağlıdır.
Bağlantı ayarları
Bir uygulama temel URL, API anahtarı ve model istiyorsa aşağıdaki değerleri girin.
13–23 kredi / çıktı görseli + 5 / girdi görseli (≤2.61 MP: 13; >2.61 MP: 23)
Üretim durumunu kontrol et
0
İstek başına
Videolar
Metinden veya referans medyadan video oluşturun. Video istekleri eşzamansız çalışır; ilerlemeyi kontrol etmek için döndürülen görev kimliğini kullanın.
Video oluştur
Uç nokta
POST
https://orkas.ai/v1/videos
Video oluştur
Kimlik doğrulama
Authorization: Bearer $ORKAS_API_KEY
İstek gövdesi parametreleri
Parametre
Tür
Gerekli
Açıklama
prompt
string
Evet
Üretilecek veya düzenlenecek videonun açıklaması.
duration
integer
Hayır
4–15 saniye. Varsayılan: 5.
resolution
string
Hayır
480p, 720p veya 1080p. Varsayılan: 720p.
quality
string
Hayır
balanced hız ve kredi kullanımını dengeler; quality üretim kalitesine ve kararlılığa öncelik verir. Varsayılan: balanced. Orkas uyumlu video modelini yine otomatik seçer.
ratio
string
Hayır
16:9, 9:16, 1:1, 4:3, 3:4 veya 21:9. Varsayılan: 16:9.
generate_audio
boolean
Hayır
Video sesi üret. Varsayılan: true.
reference_image_urls
array
Hayır
En fazla dokuz herkese açık HTTPS görsel URL'si.
reference_video_urls
array
Hayır
En fazla üç herkese açık HTTPS video URL'si.
operation
string
Hayır
generate veya edit. Düzenleme için en az bir referans video gerekir. Varsayılan: generate.
seed
integer
Hayır
Tekrarlanabilir üretim için isteğe bağlı rastgelelik tohumu.
İstek örneği
curl https://orkas.ai/v1/videos \
-H "Authorization: Bearer $ORKAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt":"Camera circles a ceramic lamp in a dark studio",
"duration":5,
"resolution":"720p",
"quality":"balanced",
"ratio":"16:9",
"generate_audio":true
}'
Bir sohbete ait kredi kullanımını gruplamak için o sohbetin isteklerinde X-Orkas-Conversation-Id başlığıyla aynı, anlam taşımayan kimliği gönderin. Yalnızca harf, rakam, - veya _ kullanın (en fazla 64 karakter); başlık veya mesaj içeriği göndermeyin.
Anahtarı tarayıcı veya mobil uygulama koduna, URL'lere, günlüklere ya da kaynak kod yönetimine koymayın.
Diğer hizmetleri etkilemeden değiştirilebilmesi için her uygulamaya ayrı bir anahtar oluşturun.
Anahtar başına sınırlar: dakikada sohbet ve arama için 120, konuşma için 60, görsel için 30 ve video için 10 istek. Durum kontrollerinde dakikada 120 isteğe izin verilir.
İstekler çok sık gönderilirse API HTTP 429 döndürür. Tekrar denemeden önce kısa süre bekleyin.
Kredi geçmişi
API kullanımı, Orkas içindeki kullanımdan ayırt edebilmeniz için Orkas Web kredi geçmişinde ayrı işaretlenir.