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.
1. Hızlı Başlangıç
Cobalt API'yi dakikalar içinde projenize entegre edebilirsiniz:
Ana Discord sunucumuzdan /api-key komutunu kullanarak anında kişisel anahtarınızı oluşturun.
Resmi OpenAI SDK'sında veya HTTP istemcinizde base_url alanını https://api.cobaltsapp.com/v1 olarak ayarlayın.
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:
| 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.
curl "https://api.cobaltsapp.com/ask?key=YOUR_API_KEY&prompt=Dünyanın+en+yüksek+dağı+hangisidir?&model=deepseek-v4-flash"
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.
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)
<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:
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. |