Rakita API · v1 · EU
OpenAPI şeması
RAKITA API · V1

Entegrasyon rehberi

Konuşmayı yazıya çevirin, metin üretin ve klonlanmış seslerle konuşma sentezleyin. Tüm yüzeylerde aynı API anahtarını ve yalnızca Rakita model adlarını kullanın.

BASE URLhttps://rakitaapi.ceyberdigital.com/v1
rakita-sttWebSocket transkripsiyon
rakita-llmJSON, SSE ve WebSocket
rakita-ttsSes, streaming ve klonlama

Kimlik doğrulama

REST/SSE isteklerinde Bearer header kullanın. Node.js WebSocket istemcileri aynı header’ı gönderebilir. Tarayıcı WebSocket istemcileri ise `rakita` ve API anahtarını alt protokoller olarak iletir; sunucu yalnızca `rakita` protokolünü geri seçer.

HTTP header
Authorization: Bearer rk_live_••••••••••••
API anahtarı güvenliği

Anahtarı istemci paketine veya herkese açık kaynak koda gömmeyin. Web uygulamalarında mümkünse bağlantıyı kendi sunucunuzdan kurun.

Hangi streaming biçimi?

STTWebSocket

İkili ses gönderin; geçici ve final token olayları alın.

LLMSSE veya WebSocket

OpenAI uyumlu SSE ya da JSON WebSocket parçaları kullanın.

TTSSSE veya WebSocket

SSE’de base64, WebSocket’te doğrudan binary ses alın.

WEBSOCKET · BINARY AUDIO

rakita-stt

İlk mesaj oturum yapılandırmasıdır. Sonraki binary frame’ler ses parçasıdır. {"type":"finalize"} bekleyen tokenları finalleştirir. Kullanım socket’in açık kaldığı süre üzerinden ölçülür.

WSS/v1/realtime/transcriptions
Node.js · tam akış
import fs from "node:fs";
import WebSocket from "ws";

const ws = new WebSocket(
  "wss://rakitaapi.ceyberdigital.com/v1/realtime/transcriptions",
  { headers: { Authorization: `Bearer ${process.env.RAKITA_API_KEY}` } }
);

ws.on("open", () => {
  ws.send(JSON.stringify({
    model: "rakita-stt",
    audio_format: "pcm_s16le",
    sample_rate: 16000,
    num_channels: 1,
    language_hints: ["tr", "en"],
    enable_endpoint_detection: true
  }));

  const audio = fs.createReadStream("ornek.pcm", { highWaterMark: 3200 });
  audio.on("data", chunk => ws.send(chunk));
  audio.on("end", () => ws.send(JSON.stringify({ type: "finalize" })));
});

ws.on("message", raw => {
  const event = JSON.parse(raw.toString());
  if (event.tokens) {
    const text = event.tokens
      .filter(token => !token.text.startsWith("<"))
      .map(token => token.text)
      .join("");
    console.log(event.tokens.some(token => !token.is_final) ? "geçici" : "final", text);

    // finalize oturumu kapatmaz. Tek seferlik kullanımda <fin>
    // final tokenı geldikten sonra bağlantıyı normal biçimde kapatın.
    if (event.tokens.some(token => token.is_final && token.text === "<fin>")) {
      ws.close(1000);
    }
  }
});

Tarayıcı bağlantısı

Browser WebSocket
const ws = new WebSocket(
  "wss://rakitaapi.ceyberdigital.com/v1/realtime/transcriptions",
  ["rakita", RAKITA_API_KEY]
);

ws.addEventListener("open", () => {
  ws.send(JSON.stringify({
    model: "rakita-stt",
    audio_format: "webm",
    language_hints: ["tr"]
  }));
});

// MediaRecorder parçası geldiğinde:
// ws.send(await blob.arrayBuffer());
// Konuşma bittiğinde:
// ws.send(JSON.stringify({ type: "finalize" }));

Temel yapılandırma

modelgerekli

`rakita-stt`

audio_formatgerekli

`auto`, `webm`, `wav`, `pcm_s16le` ve desteklenen biçimler.

sample_rateraw audio

PCM için örnekleme hızı; ör. 16000.

num_channelsraw audio

Mono için 1, stereo için 2.

language_hintsopsiyonel

Beklenen diller; ör. ["tr","en"].

enable_speaker_diarizationopsiyonel

Konuşmacı etiketlerini etkinleştirir.

Yanıt olayları

`tokens[].text` metni, `tokens[].is_final` kesinleşme durumunu, `speaker` konuşmacıyı; `final_audio_proc_ms` işlenen final ses süresini bildirir. `finalize` yalnızca bekleyen tokenları kesinleştirir ve bağlantıyı açık tutar. Tek seferlik kullanımda final <fin> tokenından sonra socket’i `1000` koduyla kapatın.

REST · SSE · WEBSOCKET

rakita-llm

Chat completions gövdesi OpenAI istemci biçimiyle uyumludur. `stream:false` tek JSON, `stream:true` SSE döndürür. Giriş ve çıkış tokenları ayrı ölçülür.

POST/v1/chat/completions
JavaScript · SSE
const response = await fetch(
  "https://rakitaapi.ceyberdigital.com/v1/chat/completions",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${RAKITA_API_KEY}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      model: "rakita-llm",
      messages: [{ role: "user", content: "Üç maddelik bir özet yaz." }],
      stream: true,
      temperature: 0.4
    })
  }
);

const reader = response.body.getReader();
const decoder = new TextDecoder();
let buffer = "";

while (true) {
  const { value, done } = await reader.read();
  if (done) break;
  buffer += decoder.decode(value, { stream: true });
  const events = buffer.split("\n\n");
  buffer = events.pop() ?? "";

  for (const event of events) {
    const data = event.split("\n")
      .find(line => line.startsWith("data:"))?.slice(5).trim();
    if (!data || data === "[DONE]") continue;
    const chunk = JSON.parse(data);
    process.stdout.write(chunk.choices?.[0]?.delta?.content ?? "");
  }
}

LLM WebSocket

WSS/v1/realtime/chat
Browser WebSocket
const ws = new WebSocket(
  "wss://rakitaapi.ceyberdigital.com/v1/realtime/chat",
  ["rakita", RAKITA_API_KEY]
);

ws.onmessage = event => {
  const message = JSON.parse(event.data);

  if (message.type === "session.ready") {
    ws.send(JSON.stringify({
      type: "response.create",
      model: "rakita-llm",
      messages: [{ role: "user", content: "Merhaba!" }],
      temperature: 0.5
    }));
  }

  if (message.type === "response.chunk") {
    const text = message.data.choices?.[0]?.delta?.content;
    if (text) console.log(text);
  }
};

Olay sırası `session.ready` → `response.start` → `response.chunk` → `response.done` şeklindedir. Aynı bağlantıda yanıt tamamlandıktan sonra yeni istek gönderebilirsiniz.

REST · SSE · BINARY WEBSOCKET

rakita-tts

Varsayılan sesi veya hesabınıza yüklediğiniz `voice_...` kimliğini kullanın. Kullanım NFC-normalize Unicode karakter sayısına göre ölçülür.

POST/v1/audio/speech
cURL · tek ses dosyası
curl https://rakitaapi.ceyberdigital.com/v1/audio/speech \
  -H "Authorization: Bearer $RAKITA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "rakita-tts",
    "input": "Siparişiniz hazır. İyi günlerde kullanın.",
    "voice": "voice_xxxxxxxxx",
    "response_format": "wav",
    "stream": false
  }' --output yanit.wav

SSE ses akışı

JavaScript · SSE
const response = await fetch(
  "https://rakitaapi.ceyberdigital.com/v1/audio/speech",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${RAKITA_API_KEY}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      model: "rakita-tts",
      input: "Bu ses parça parça iletilir.",
      voice: "rakita-default",
      response_format: "pcm",
      speed: 1,
      stream: true
    })
  }
);

// text/event-stream içindeki speech.audio.delta olaylarında
// audio alanı base64 kodlu PCM ses parçasıdır.
// speech.audio.done olayı akışın tamamlandığını bildirir.

Streaming isteklerinde `response_format` `pcm` veya `wav`, `speed` ise `1` olmalıdır.

TTS WebSocket

WSS/v1/realtime/speech
Browser WebSocket · binary audio
const ws = new WebSocket(
  "wss://rakitaapi.ceyberdigital.com/v1/realtime/speech",
  ["rakita", RAKITA_API_KEY]
);
ws.binaryType = "arraybuffer";

const audioChunks = [];
ws.onmessage = event => {
  if (event.data instanceof ArrayBuffer) {
    audioChunks.push(event.data); // PCM/WAV binary ses parçası
    return;
  }

  const message = JSON.parse(event.data);
  if (message.type === "session.ready") {
    ws.send(JSON.stringify({
      type: "session.config",
      model: "rakita-tts",
      voice: "voice_xxxxxxxxx",
      response_format: "pcm"
    }));
    ws.send(JSON.stringify({ type: "input.text", text: "Merhaba, " }));
    ws.send(JSON.stringify({ type: "input.text", text: "size nasıl yardımcı olabilirim?" }));
    ws.send(JSON.stringify({ type: "input.done" }));
  }
  if (message.type === "audio.done") console.log("Ses tamamlandı");
};

Metni birden fazla `input.text` mesajıyla ekleyin ve `input.done` ile üretimi başlatın. `audio.start` sonrasında binary frame’ler, sonunda `audio.done` gelir.

Ses klonlama

WAV, MP3, M4A, OGG veya WebM referans kaydı yükleyin. En fazla 15 MB kabul edilir. Referans metnini vermek devamlılık ve telaffuz kalitesini artırır. Yalnızca kullanma yetkiniz olan sesleri yükleyin ve `consent=true` gönderin.

POST/v1/voices
cURL · özel ses oluştur
curl https://rakitaapi.ceyberdigital.com/v1/voices \
  -H "Authorization: Bearer $RAKITA_API_KEY" \
  -F "name=Marka Sesi" \
  -F "consent=true" \
  -F "reference_text=Merhaba, bugün size nasıl yardımcı olabilirim?" \
  -F "sample=@ornek.wav"
GET /v1/voiceslistele

Varsayılan ve özel ses kimliklerini döndürür.

DELETE /v1/voices/:idsil

Yalnızca aynı çalışma alanına ait özel sesi siler.

Kullanım ve ölçüm

API müşterileri 1–90 günlük özetlerini API anahtarıyla okuyabilir.

GET/v1/usage?days=30
STT · socket_seconds LLM · input_tokens / output_tokens TTS · characters

Hatalar ve istek kimliği

REST hataları kararlı bir `code`, güvenli mesaj ve `request_id` döndürür. Aynı kimlik `x-request-id` header’ında bulunur. WebSocket hataları `type:error` olayıyla aynı alanları taşır.

JSON
{
  "error": {
    "code": "invalid_api_key",
    "message": "API anahtarı geçersiz veya etkin değil.",
    "request_id": "01J..."
  }
}