Ferman AI API Dokümantasyonu

REST API — OpenAI istemcileriyle uyumlu format, herhangi bir HTTP istemcisiyle kullanabilirsiniz.

Kimlik Doğrulama

Tüm API isteklerinde Authorization header'ına API anahtarınızı ekleyin:

Authorization: Bearer fai_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

API anahtarı oluşturmak için Dashboard → API sayfasını ziyaret edin.

Rate Limits

Her API isteği aylık API çağrı kotanıza sayılır. Kota aşıldığında 429 Too Many Requests döner.

Her mesajdaki token tüketimi de toplam token kullanımınıza işlenir ve dashboard'da görüntülenebilir.

Plan Limitleri

Endpoint: Modeller

{
  "object": "list",
  "data": [
    {
      "id": "ferman3.5",
      "object": "model",
      "owned_by": "ollama"
    }
  ]
}

Endpoint: Chat Completions

{
  "model": "ferman3.5",
  "messages": [
    { "role": "system",    "content": "Sen yardımcı bir asistansın." },
    { "role": "user",      "content": "Merhaba, nasıl çalışıyorsun?" }
  ],
  "stream": false
}

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1741000000,
  "model": "ferman3.5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Merhaba! Ben Ferman AI, size nasıl yardımcı olabilirim?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 24,
    "completion_tokens": 18,
    "total_tokens": 42
  }
}

Chat API: Sohbet Listesi

{ "success": true, "chats": [{ "id": 42, "title": "Merhaba", "slug": "merhaba-a1b2", "model": "ferman3.5", "message_count": 5 }] }

Chat API: Sohbet Oluştur

{ "success": true, "chat_id": 43, "slug": "python-x9k2", "title": "Python" }

Chat API: Sohbet Geçmişi

{ "success": true, "chat": { "id": 42, "title": "Merhaba" }, "messages": [{ "id": 101, "role": "user", "content": "Merhaba!", "token_count": 12 }, { "id": 102, "role": "assistant", "content": "Yardımcı olabilirim?", "token_count": 18 }] }

Chat API: Mesaj Gönder (SSE)

data: {"id":"chatcmpl-abc","choices":[{"delta":{"content":"Merhaba"},"finish_reason":null}]}
data: {"choices":[{"delta":{},"finish_reason":"stop"}],"done":true}
data: [DONE]

Chat API: Sohbet Güncelle

{ "success": true, "message": "Güncellendi" }

Chat API: Sohbet Sil

{ "success": true, "message": "Sohbet silindi" }

Chat API: Mesaj Tepkisi

{ "success": true, "message": "Kaydedildi" }

Örnek: cURL

curl -X POST https://ferman.net.tr/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer fai_ANAHTARINIZ" \
  -d '{
    "model": "ferman3.5",
    "messages": [
      {"role": "user", "content": "Merhaba!"}
    ]
  }'

Örnek: PHP

<?php
$ch = curl_init('https://ferman.net.tr/api/v1/chat/completions');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Authorization: Bearer fai_ANAHTARINIZ',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'model'    => 'ferman3.5',
        'messages' => [
            ['role' => 'user', 'content' => 'Merhaba!'],
        ],
    ]),
]);
$response = json_decode(curl_exec($ch), true);
echo $response['choices'][0]['message']['content'];

Örnek: Python (requests)

import requests

response = requests.post(
    'https://ferman.net.tr/api/v1/chat/completions',
    headers={
        'Content-Type': 'application/json',
        'Authorization': 'Bearer fai_ANAHTARINIZ',
    },
    json={
        'model': 'ferman3.5',
        'messages': [
            {'role': 'user', 'content': 'Merhaba!'}
        ]
    }
)
print(response.json()['choices'][0]['message']['content'])

Örnek: JavaScript (fetch)

const response = await fetch('https://ferman.net.tr/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer fai_ANAHTARINIZ',
  },
  body: JSON.stringify({
    model: 'ferman3.5',
    messages: [
      { role: 'user', content: 'Merhaba!' }
    ]
  })
});

const data = await response.json();
// data.choices[0].message.content