Orkas API

Orkas API belgeleri

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.

API anahtarı oluştur

Sohbet

Yapay zekâ uygulamalarında, komut satırı araçlarında veya kendi hizmetinizde OpenAI uyumlu Chat Completions biçimini kullanın.

Bağlantı ayarları

Bir uygulama temel URL, API anahtarı ve model istiyorsa aşağıdaki değerleri girin.

Ayar	Değer	Açıklama
`Base URL`	`https://orkas.ai/v1`	Bunu OpenAI uyumlu hizmet adresi olarak kullanın.
`API Key`	Hesap bölümünde bir anahtar oluşturun	Anahtarı uygulamanın API anahtarı alanına yapıştırın.
`model`	`orkas-llm-1.5`Önerilen	Günlük soru-cevap, yazı ve ofis işleri için en uygun seçenek. DeepSeek V4.1 Flash · GPT-6 Luna · Claude-Sonnet-5 · Gemini-3.8 Flash içerir.
`model`	`orkas-llm-1.5-pro`	Araştırma, video, Ar-Ge ve diğer karmaşık görevler için en uygun seçenek. GPT-6 Sol · Claude Opus 5.5 · Kimi K3 içerir.

Sohbet tamamlama oluştur

Uç nokta

POST

https://orkas.ai/v1/chat/completions

Sohbet tamamlama oluştur

Kimlik doğrulama

Authorization: Bearer $ORKAS_API_KEY

İstek gövdesi parametreleri

Parametre	Tür	Gerekli	Açıklama
`model`	string	Evet	`orkas-llm-1.5` veya `orkas-llm-1.5-pro`.
`messages`	array	Evet	Sohbet mesajları. Her öğe `role` ve `content` içerir.
`stream`	boolean	Hayır	`true` olduğunda akış hâlinde yanıt döndürür. Varsayılan: `false`.

İstek örneği

curl https://orkas.ai/v1/chat/completions \
  -H "Authorization: Bearer $ORKAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "orkas-llm-1.5",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Kredi kullanımı

Faturalandırma kalemi	Düşülen kredi	Faturalandırma birimi
`orkas-llm-1.5`	Girdi 20–280; önbellek okuma 2–28; önbellek oluşturma 25–350; çıktı 120–1,260	1M token başına; kesin birim ücret isteğe bağlıdır.
`orkas-llm-1.5-pro`	Girdi 140–1,000; önbellek okuma 14–100; önbellek oluşturma 175–1,250; çıktı 840–4,500	1M token başına; kesin birim ücret isteğe bağlıdır.

Ara

Web'de arama yapın ve uygulamanız için ilgili sonuçlardan oluşan kısa bir liste alın.

Web'de ara

Uç nokta

POST

https://orkas.ai/v1/search

Web'de ara

Kimlik doğrulama

Authorization: Bearer $ORKAS_API_KEY

İstek gövdesi parametreleri

Parametre	Tür	Gerekli	Açıklama
`query`	string	Evet	En fazla 2,000 karakterlik arama metni.
`max_results`	integer	Hayır	Sonuç sayısı, 1–20. Varsayılan: `8`.

İstek örneği

curl https://orkas.ai/v1/search \
  -H "Authorization: Bearer $ORKAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"latest battery research","max_results":8}'

Kredi kullanımı

Faturalandırma kalemi	Düşülen kredi	Faturalandırma birimi
Web'de ara	5.6	En fazla 20 sonuç için istek başına.

Konuşma

Metni ses dosyasına dönüştürün. Aşağıdaki listeden bir ses kimliği seçin ve ihtiyacınız olan ses biçimini belirleyin.

Sesleri listele

Uç nokta

GET

https://orkas.ai/v1/audio/voices

Sesleri listele

Kimlik doğrulama

Authorization: Bearer $ORKAS_API_KEY

İstek parametreleri

Bu uç noktanın istek parametresi yoktur.

İstek örneği

curl https://orkas.ai/v1/audio/voices \
  -H "Authorization: Bearer $ORKAS_API_KEY"

Kullanılabilir ses kimlikleri

Ses kimliği	Ad	Dil
`zh_female_vv_uranus_bigtts`	vivi 2.0	Çince / İngilizce
`saturn_zh_female_cancan_tob`	知性灿灿	Çince
`saturn_zh_female_keainvsheng_tob`	可爱女生	Çince
`saturn_zh_female_tiaopigongzhu_tob`	调皮公主	Çince
`saturn_zh_male_shuanglangshaonian_tob`	爽朗少年	Çince
`saturn_zh_male_tiancaitongzhuo_tob`	天才同桌	Çince
`zh_female_xiaohe_uranus_bigtts`	小何	Çince
`zh_male_m191_uranus_bigtts`	云舟	Çince
`zh_male_taocheng_uranus_bigtts`	小天	Çince
`en_male_tim_uranus_bigtts`	Tim	İngilizce
`en_female_dacey_uranus_bigtts`	Dacey	İngilizce
`en_female_stokie_uranus_bigtts`	Stokie	İngilizce

Konuşma üret

Uç nokta

POST

https://orkas.ai/v1/audio/speech

Konuşma üret

Kimlik doğrulama

Authorization: Bearer $ORKAS_API_KEY

İstek gövdesi parametreleri

Parametre	Tür	Gerekli	Açıklama
`model`	string	Evet	`orkas-tts-1` kullanın.
`input`	string	Evet	Sentezlenecek metin, en fazla 16,384 UTF-8 baytı.
`voice`	string	Evet	Yukarıdaki listeden ses kimliği.
`language`	string	Hayır	`zh-CN` veya `en` gibi anlatım dili. Seçilen ses tarafından desteklenmelidir; aksi takdirde sesin varsayılan dili kullanılır.
`response_format`	string	Hayır	`mp3`, `wav`, `opus` veya `ogg`. Varsayılan: `mp3`.
`speed`	number	Hayır	0.5 ile 2.0 arasında konuşma hızı. Varsayılan: `1.0`.

İstek örneği

curl https://orkas.ai/v1/audio/speech \
  -H "Authorization: Bearer $ORKAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"orkas-tts-1",
    "input":"你好，欢迎使用 Orkas。",
    "voice":"zh_female_vv_uranus_bigtts",
    "language":"zh-CN",
    "response_format":"mp3",
    "speed":1.0
  }' --output speech.mp3

Kredi kullanımı

Faturalandırma kalemi	Düşülen kredi	Faturalandırma birimi
Sesleri listele	0	İstek başına
Konuşma üret	0.125	En az bir saniyeye yukarı yuvarlanan tahmini çıktı saniyesi başına.

Görseller

Bir açıklamadan görsel üretin veya düzenleme için referans görseller sağlayın. Her istekte bir görsel döndürülür.

Görsel üret

Uç nokta

POST

https://orkas.ai/v1/images/generations

Görsel üret

Kimlik doğrulama

Authorization: Bearer $ORKAS_API_KEY

İstek gövdesi parametreleri

Parametre	Tür	Gerekli	Açıklama
`prompt`	string	Evet	En fazla 20,000 karakterlik görsel açıklaması.
`size`	string	Hayır	`2k`, `3k`, `4k` veya desteklenen bir genişlik×yükseklik değeri. Varsayılan: `2k`.
`response_format`	string	Hayır	`url` veya `b64_json`. Varsayılan: `b64_json`.
`reference_images`	array	Hayır	Düzenleme için en fazla dört HTTPS URL'si veya desteklenen görsel veri URL'si.
`async`	boolean	Hayır	`true` olduğunda görev kimliği döndürür. İstek zaman aşımını önlemek için önerilir. Varsayılan: `false`.

İstek örneği

curl https://orkas.ai/v1/images/generations \
  -H "Authorization: Bearer $ORKAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt":"A product photo on a clean studio background",
    "size":"2k",
    "response_format":"url",
    "async":true
  }'

Daha uzun istekler için: "async": true ayarlayın. API bir görev id değeri döndürür; sonuç hazır olana kadar durum URL'sini kullanın.

Üretim durumunu kontrol et

Uç nokta

GET

https://orkas.ai/v1/images/generations/{id}

Üretim durumunu kontrol et

Kimlik doğrulama

Authorization: Bearer $ORKAS_API_KEY

Yol parametreleri

Parametre	Tür	Gerekli	Açıklama
`id`	string	Evet	Oluşturma isteğinin döndürdüğü görev kimliği.

İstek örneği

curl https://orkas.ai/v1/images/generations/$TASK_ID \
  -H "Authorization: Bearer $ORKAS_API_KEY"

Kredi kullanımı

Faturalandırma kalemi	Düşülen kredi	Faturalandırma birimi
Görsel üret	22	Üretilen görsel başına
Ü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
  }'

Video durumunu kontrol et

Uç nokta

GET

https://orkas.ai/v1/videos/{id}

Video durumunu kontrol et

Kimlik doğrulama

Authorization: Bearer $ORKAS_API_KEY

Yol parametreleri

Parametre	Tür	Gerekli	Açıklama
`id`	string	Evet	Oluşturma isteğinin döndürdüğü görev kimliği.

İstek örneği

curl https://orkas.ai/v1/videos/$TASK_ID \
  -H "Authorization: Bearer $ORKAS_API_KEY"

Kredi kullanımı

Faturalandırma kalemi	Düşülen kredi	Faturalandırma birimi
`balanced` · Metinden veya görselden videoya · 480p	37	Çıktı saniyesi başına
`balanced` · Metinden veya görselden videoya · 720p	80	Çıktı saniyesi başına
`balanced` · Metinden veya görselden videoya · 1080p	248	Çıktı saniyesi başına
`quality` · Metinden veya görselden videoya · 480p	46	Çıktı saniyesi başına
`quality` · Metinden veya görselden videoya · 720p	100	Çıktı saniyesi başına
`quality` · Metinden veya görselden videoya · 1080p	248	Çıktı saniyesi başına
`balanced` / `quality` · Video düzenleme veya referans videodan üretim · 480p	51	Çıktı saniyesi başına
`balanced` / `quality` · Video düzenleme veya referans videodan üretim · 720p	109	Çıktı saniyesi başına
`balanced` / `quality` · Video düzenleme veya referans videodan üretim · 1080p	271	Çıktı saniyesi başına
Video durumunu kontrol et	0	İstek başına

Güvenlik ve sınırlar

API anahtarlarını gizli tutun, farklı uygulamalar için ayrı anahtarlar kullanın ve sızmış olabilecek bir anahtarı hemen silin.

Anahtarı Authorization: Bearer sk-orkas-… istek başlığında gönderin.
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.