API Dokumantasyonu

Base URL

https://v2.recai.io/v1

Tum API istekleri bu base URL uzerinden yapilir. OpenAI SDK'larinda base_url parametresini degistirmeniz yeterlidir.

Kimlik Dogrulama

Tum API isteklerinde Authorization header'i zorunludur:

header
Authorization: Bearer sk-your-api-key

API anahtarinizi kayit olarak veya dashboard'dan alabilirsiniz.

Endpoint'ler

Method	Endpoint	Aciklama
POST	`/v1/chat/completions`	Chat tamamlama (streaming destekli)
GET	`/v1/models`	Kullanilabilir model listesi
GET	`/api/balance/:keyid`	Bakiye sorgulama
POST	`/api/register`	Yeni kullanici kaydi
POST	`/api/login`	Kullanici girisi

POST /v1/chat/completions

Parametreler:

Parametre	Tip		Aciklama
`model`	string	zorunlu	Model adi
`messages`	array	zorunlu	[{role, content}] mesaj dizisi
`stream`	boolean	opsiyonel	SSE streaming
`temperature`	number	opsiyonel	0-2 arasi yaraticilik
`top_p`	number	opsiyonel	Nucleus sampling
`max_tokens`	integer	opsiyonel	Maks cikti token
`stop`	string/array	opsiyonel	Durma dizisi
`timeout`	integer	opsiyonel	Zaman asimi (sn)
`think`	boolean	opsiyonel	Derin dusunme
`deepsearch`	boolean	opsiyonel	Derin arama

Python

                    python
                    
                
from openai import OpenAI

client = OpenAI(
    base_url="https://v2.recai.io/v1",
    api_key="sk-your-api-key"
)

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "system", "content": "Sen yardimci bir asistansin."},
        {"role": "user", "content": "Merhaba!"}
    ],
    temperature=0.7
)

print(response.choices[0].message.content)

JavaScript / Node.js

                    javascript
                    
                
import OpenAI from 'openai';

const client = new OpenAI({
    baseURL: 'https://v2.recai.io/v1',
    apiKey: 'sk-your-api-key'
});

const response = await client.chat.completions.create({
    model: 'deepseek-chat',
    messages: [{ role: 'user', content: 'Merhaba!' }]
});

console.log(response.choices[0].message.content);

cURL

                    curl
                    
                
curl https://v2.recai.io/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role": "user", "content": "Merhaba!"}],
    "temperature": 0.7
  }'

Streaming

                    python
                    
                
stream = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "Merhaba!"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

POST /api/register

Parametre	Tip		Aciklama
`firstName`	string	zorunlu	Ad
`lastName`	string	zorunlu	Soyad
`email`	string	zorunlu	E-posta
`password`	string	zorunlu	Sifre (min 6)
`phone`	string	opsiyonel	Telefon
`company`	string	opsiyonel	Sirket

Basarili kayitda sessionToken ve apiKey doner.

GET /v1/models

Kullanilabilir modellerin listesini OpenAI formatiyla doner. Auth gerektirir.