Geliştirici Dokümantasyonu

Yüksek performanslı akıl yürütme (reasoning) modelleri, düşünme desteği ve OpenAI SDK tam uyumluluğuna sahip kurumsal seviye API mimarisi.

Base URL https://api.cobaltsapp.com/v1
Auth Authorization: Bearer <API_KEY>

1. Hızlı Başlangıç

Cobalt API'yi dakikalar içinde projenize entegre edebilirsiniz:

01 API Anahtarı Alın

Ana Discord sunucumuzdan /api-key komutunu kullanarak anında kişisel anahtarınızı oluşturun.

02 Base URL Yapılandırın

Resmi OpenAI SDK'sında veya HTTP istemcinizde base_url alanını https://api.cobaltsapp.com/v1 olarak ayarlayın.

03 İstek Gönderin

Dilediğiniz modeli seçerek metin üretimi, akıl yürütme (reasoning) veya görsel üretim isteklerinizi gönderin.

2. Aktif Model Kataloğu

Sistemde bulunan tüm modeller gerçek zamanlı olarak aşağıda listelenmiştir:

Tümü (23) Ücretsiz Genel (8) Özel Sunucular (12) Görsel (3)
Model ID Model Adı & Açıklama Erişim & Durum Eylem
deepseek-v4-flash Thinking DeepSeek V4 Flash
Gelişmiş akıl yürütme ve problem çözme modeli (Thinking / Reasoning destekli)
GENEL ÜCRETSİZ
gemma-4-31b-it Thinking Gemma 4 31B IT
Gelişmiş analiz ve düşünme modeli (Thinking destekli)
GENEL ÜCRETSİZ
gpt-oss-20b GPT-OSS 20B
21B MoE akıl yürütme ve hızlı sohbet modeli
GENEL ÜCRETSİZ
minimax-m3 MiniMax M3
Uzun bağlamlı yüksek performanslı sohbet modeli
GENEL ÜCRETSİZ
nemotron-3-super-120b-a12b Nemotron 3 Super 120B
Yüksek performanslı akıl yürütme ve analiz modeli
GENEL ÜCRETSİZ
qwen3.6-27b Thinking Qwen 3.6 27B
Akıl yürütme destekli Qwen modeli (Think ayrıştırma)
GENEL ÜCRETSİZ
lfm-2.6b-local LFM 2.6B Local
Kompakt ve verimli akıl yürütme modeli (128K bağlam)
GENEL ÜCRETSİZ
nemotron-omni-local Thinking Nemotron Omni Local
Çok modlu algılama ve akıl yürütme modeli (256K bağlam)
GENEL ÜCRETSİZ
gpt-oss-120b GPT-OSS 120B
117B MoE üstün zeka ve problem çözme modeli
MODIQUE Sunucuya Katıl
nemotron-ultra-550b-local Nemotron Ultra 550B Local
Sınır sınıfı akıl yürütme modeli (55B aktif, 1M bağlam)
MODIQUE Sunucuya Katıl
nemotron-lightning-local Nemotron Lightning Local
Hızlı MoE modeli (3B aktif / 30B toplam, 1M bağlam)
MODIQUE Sunucuya Katıl
dots-3-note-local Dots 3 Note Local
MoE modeli (16B aktif / 280B toplam, 512K bağlam)
MODIQUE Sunucuya Katıl
qwen3.8-max Thinking Qwen 3.8 Max
En üst düzey amiral gemisi Qwen 3.8 Max yüksek zeka ve kodlama modeli
MODIQUE Sunucuya Katıl
qwen3.8-max-thinking Thinking Qwen 3.8 Max Thinking
Gelişmiş mantıksal çıkarım ve derin düşünme destekli Qwen 3.8 Max modeli
MODIQUE Sunucuya Katıl
llama-3.3-70b-instruct Llama 3.3 70B Instruct
Gelişmiş diyalog ve talimat modeli
YAZILIM HUB Sunucuya Katıl
north-mini-code-local North Mini Code Local
Ajansal kodlama modeli (256K bağlam)
YAZILIM HUB Sunucuya Katıl
laguna-s-local Laguna S Local
Kodlama ajan modeli (118B toplam, 8B aktif, 262K bağlam)
YAZILIM HUB Sunucuya Katıl
laguna-xs-local Laguna XS Local
Kompakt kodlama ajan modeli (33B-A3B, 262K bağlam)
YAZILIM HUB Sunucuya Katıl
qwen3.7-plus Thinking Qwen 3.7 Plus
Qwen 3.7 Plus yüksek kapasiteli akıl yürütme ve genel zeka modeli
YAZILIM HUB Sunucuya Katıl
qwen3.7-plus-thinking Thinking Qwen 3.7 Plus Thinking
Derin düşünme ve adım adım akıl yürütme özellikli Qwen 3.7 Plus modeli
YAZILIM HUB Sunucuya Katıl
gpt-image-1 5 / gün GPT Image 1
Ultra yüksek kaliteli görsel üretim modeli (Günlük 5 limit)
GÖRSEL MODELİ
flux 20 / gün Flux Schnell
Hızlı ve yüksek detaylı görsel üretim modeli (Günlük 20 limit)
GÖRSEL MODELİ
turbo 20 / gün SDXL Turbo
Anlık ve seri görsel üretim modeli (Günlük 20 limit)
GÖRSEL MODELİ

3. OpenAI SDK Entegrasyonu (Chat Completions)

Cobalt API; Python, Node.js, Go ve REST için resmi openai SDK'ları ile %100 uyumludur.

from openai import OpenAI

client = OpenAI(
    base_url="https://api.cobaltsapp.com/v1",
    api_key="YOUR_API_KEY"
)

completion = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[
        {"role": "system", "content": "Sen yardımsever ve analitik bir yapay zeka asistanısın."},
        {"role": "user", "content": "Kuantum hesaplama ile klasik hesaplama arasındaki 3 temel fark nedir?"}
    ],
    temperature=0.7,
    max_tokens=2048
)

# Akıl yürütme (reasoning) ve model cevabı
msg = completion.choices[0].message
if getattr(msg, "reasoning", None) or getattr(msg, "reasoning_content", None):
    print("[DÜŞÜNCE SÜRECİ]:", getattr(msg, "reasoning_content", msg.reasoning))

print("[CEVAP]:", msg.content)

4. Simple Ask API (Ultra Hızlı Soru-Cevap)

JSON veya karmaşık nesne yapılarıyla uğraşmadan tek bir URL veya basit POST gövdesiyle yanıt alın.

GET /ask (Tarayıcı veya cURL)
curl "https://api.cobaltsapp.com/ask?key=YOUR_API_KEY&prompt=Dünyanın+en+yüksek+dağı+hangisidir?&model=deepseek-v4-flash"
POST /ask (JSON İstek)
curl -X POST https://api.cobaltsapp.com/ask   -H "Content-Type: application/json"   -d '{
    "key": "YOUR_API_KEY",
    "prompt": "Python ile Fibonacci dizisi fonksiyonu yaz.",
    "model": "deepseek-v4-flash",
    "format": "json"
  }'

5. Görsel Üretim API (3 Model)

Metin istemi (prompt) üzerinden görsel üretin. gpt-image-1 modeli günlük 5 istek kotasına sahipken; flux ve turbo modelleri günlük 20 istek kotasına sahiptir.

Python OpenAI SDK (Images)
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cobaltsapp.com/v1",
    api_key="YOUR_API_KEY"
)

# Model seçenekleri: "gpt-image-1" (5/gün), "flux" (20/gün), "turbo" (20/gün)
response = client.images.generate(
    model="gpt-image-1",
    prompt="A futuristic cyberpunk city with neon lights and flying cars",
    size="1024x1024"
)

print(response.data[0].url)
Doğrudan URL / HTML <img> Etiketi
<img src="https://api.cobaltsapp.com/generate?key=YOUR_API_KEY&prompt=cat+in+space&model=flux" alt="Görsel" />

6. Limitler, Kotalar ve Başlıklar

Her API anahtarı için uygulanan günlük kotalar ve hız limitleri:

150 / gün
Sohbet & LLM Modelleri
20 / gün
Standart Görsel (flux, turbo)
5 / gün
Özel Görsel (gpt-image-1)
25 req / min
Hız Sınırı (Rate Limit)

Limit Sorgulama Endpoint'i (GET /usage)

Kalan günlük hakkınızı sorgulamak için aşağıdaki endpoint'i kullanabilirsiniz:

curl "https://api.cobaltsapp.com/usage?key=YOUR_API_KEY"

7. Hata Kodları ve Yanıt Standartları

Cobalt API standart HTTP durum kodlarını ve OpenAI hata nesnesi şemasını kullanır:

HTTP Kodu Hata Türü (type) Sebep & Çözüm
401 authentication_error API anahtarı eksik, geçersiz veya veritabanında bulunamadı.
403 permission_denied İstenen özel model için gerekli Discord sunucusuna üye değilsiniz.
404 invalid_request_error Model bulunamadı (model_not_found).
429 rate_limit_error Günlük istek limitiniz veya anlık hız sınırınız aşıldı.
500 / 502 upstream_error Model servisinde geçici bağlantı hatası oluştu.