Dokümantasyon

Karınca Labs API'ye
Hoş Geldiniz.

Karınca Labs API, Claude, GPT ve Gemini gibi en güçlü yapay zeka modellerini tek bir uç nokta üzerinden kullanmanızı sağlar. Anthropic ve OpenAI uyumlu formatlarla çalışır — mevcut araçlarınızı değiştirmenize gerek yok.

Hızlı Başlangıç

Bir dakikada hazır.

API key'inizi alın ve ilk isteğinizi gönderin.

export ANTHROPIC_BASE_URL="https://api.karincalabs.com"
export ANTHROPIC_API_KEY="kl-your-api-key"

export OPENAI_BASE_URL="https://api.karincalabs.com/v1"
export OPENAI_API_KEY="kl-your-api-key"

curl https://api.karincalabs.com/v1/messages \
  -H "x-api-key: kl-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-4-7",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Merhaba, Claude!" }
    ]
  }'

claude

Kimlik Doğrulama

Her istekte API key gönderin.

API key'iniz her istekte gereklidir. Kullandığınız endpoint formatına göre farklı header'lar kullanılır.

/v1/messages için (Anthropic formatı)

/v1/chat/completions için (OpenAI formatı)

API Referansı

Mesaj oluştur

Anthropic Messages API formatında istek gönderin. Tüm modeller için aynı format kullanılır — sadece model alanını değiştirin.

Claude ile örnek

curl https://api.karincalabs.com/v1/messages \
  -H "x-api-key: kl-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-4-7",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Merhaba, Claude!" }
    ]
  }'

Streaming

"stream": true ekleyerek Server-Sent Events alın:

curl https://api.karincalabs.com/v1/messages \
  -H "x-api-key: kl-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-4-7",
    "max_tokens": 1024,
    "stream": true,
    "messages": [
      { "role": "user", "content": "Kısa bir şiir yaz" }
    ]
  }'

Örnek Yanıt

{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Merhaba! Size nasıl yardımcı olabilirim?"
    }
  ],
  "model": "claude-opus-4-7",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 14,
    "output_tokens": 12
  }
}

Chat tamamlama (OpenAI formatı)

OpenAI Chat Completions formatı. OpenAI SDK, LiteLLM veya her OpenAI uyumlu araçla doğrudan kullanılabilir.

Claude ile örnek

curl https://api.karincalabs.com/v1/chat/completions \
  -H "Authorization: Bearer kl-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-7",
    "messages": [
      { "role": "system", "content": "Yardımcı bir asistansın." },
      { "role": "user", "content": "Merhaba!" }
    ],
    "max_tokens": 1024
  }'

GPT ile örnek

curl https://api.karincalabs.com/v1/chat/completions \
  -H "Authorization: Bearer kl-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      { "role": "user", "content": "Merhaba, GPT!" }
    ],
    "max_tokens": 1024
  }'

Örnek Yanıt

{
  "id": "chatcmpl-9f3kB0",
  "object": "chat.completion",
  "model": "claude-opus-4-7",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "Merhaba! Size nasıl yardımcı olabilirim?"
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 14,
    "completion_tokens": 12,
    "total_tokens": 26
  }
}

Resim üret (OpenAI uyumlu)

Tek istekle yüksek kaliteli görsel üretimi. Model seçimi yok — backend her zaman Nano Banana Pro kullanır. Sabit fiyat: $0.039/resim. Cline, n8n veya OpenAI uyumlu her aracla kullanılabilir.

Örnek istek

curl https://api.karincalabs.com/v1/images/generations \
  -H "Authorization: Bearer kl-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "kahve içen bir karınca, fotorealistik",
    "aspect_ratio": "1:1"
  }'

İstek alanları

Video üret (asenkron)

Veo 3.1 ile 4-8 saniye arası HD video. Asenkron — POST edenjob_id döner, sonrasında GET ile durumu sorgulanır. Saniye başına $0.15 (8sn = $1.20). Pre-flight bakiye reservation, başarısızda otomatik iade.

1. Job başlat

curl https://api.karincalabs.com/v1/videos/generations \
  -H "Authorization: Bearer kl-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "kahve içen karınca, sinematik",
    "duration_seconds": 6
  }'

İlk yanıt (queued)

{
  "ok": true,
  "job_id": "kl_xyz789",
  "status": "queued",
  "cost_panel_usd": 0.90,
  "duration_seconds": 6,
  "estimated_seconds": 90
}

2. Durumu sorgula

# Job durumunu sorgulama (her 5sn'de bir)
curl https://api.karincalabs.com/v1/videos/JOB_ID \
  -H "Authorization: Bearer kl-your-api-key"

Tamamlanan yanıt

{
  "ok": true,
  "job_id": "kl_xyz789",
  "status": "completed",
  "prompt": "kahve içen karınca, sinematik",
  "duration_seconds": 6,
  "cost_panel_usd": 0.90,
  "result_urls": ["https://scale.claude.gg/result/abc123.mp4"],
  "error_message": null,
  "created_at": "2026-05-09T01:00:00Z",
  "completed_at": "2026-05-09T01:01:30Z"
}

İstek alanları

Job durumları

Desteklenen modelleri listele

Hesabınızın erişebildiği tüm modelleri OpenAI formatında döner.

curl https://api.karincalabs.com/v1/models \
  -H "Authorization: Bearer kl-your-api-key"

Medya Üretimi

Sohbette resim üretimi

KarincaLabs sohbet arayüzünde (chat.karincalabs.com) Claude veya GPT ile konuşurken doğal dilde resim isteyebilirsiniz. Model generate_image tool'unu otomatik çağırır, proxy resmi üretir ve görsel inline olarak sohbete düşer.

Nasıl çalışır

• Eligible model'leri seçin (Claude Opus 4-7/4-6, Sonnet 4-6, GPT-5.5/5.4 — diğer modellerde tool inject edilmez)
• Doğal dilde prompt yazın: "kedi resmi yap", "şu manzarayı çiz: ...", "bu prompt'tan bir görsel üret: ..."
• Model tool çağırır → proxy Vertex AI'a (Nano Banana Pro) yönlendirir → resim ~10sn içinde sohbete düşer
• Hesabınızdan sabit $0.039 kesilir. Devam mesajıyla aynı resmi yeniden düzenlemesini isteyebilirsiniz ("daha sarı yap", "16:9 oranında") — yeni istek olarak çalışır.

Video Studio

karincalabs.com/account/studio sayfasından görsel ve video üretebilirsiniz. Görsel tarafında Nano Banana Pro, video tarafında Veo 3.1 kullanılır; 4-8sn arası HD video, prompt + süre seçimi, aktif iş listesi ve geçmiş kayıtlarınız tek sayfada.

Fiyat tablosu

İş akışı

• Studio sayfasında prompt yazıp süre seçin, "Video üret"e basın
• Bakiyenizden fiyat hold edilir (rezervasyon)
• İş "queued" → "processing" → "completed" akışında ilerler (~60-180sn)
• Tamamlandığında geçmiş listenize düşer, video player ile inline oynatılabilir, indirilebilir
• Başarısız olursa rezervasyon otomatik iade edilir — para kaybı yok

SDK & Araçlar

SDK Örnekleri

Anthropic veya OpenAI SDK'larını kullanarak Karınca API'ye bağlanabilirsiniz. Sadece base_url ve api_key parametrelerini değiştirmeniz yeterlidir.

Anthropic SDK

# pip install anthropic
import anthropic

client = anthropic.Anthropic(
    api_key="kl-your-api-key",
    base_url="https://api.karincalabs.com"
)

# Claude
msg = client.messages.create(
    model="claude-opus-4-7",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Merhaba!"}]
)
print(msg.content[0].text)

# GPT — aynı client, sadece model değiştir
msg = client.messages.create(
    model="gpt-5.5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Merhaba GPT!"}]
)

OpenAI SDK

# pip install openai
from openai import OpenAI

client = OpenAI(
    base_url="https://api.karincalabs.com/v1",
    api_key="kl-your-api-key"
)

response = client.chat.completions.create(
    model="claude-opus-4-7",
    messages=[
        {"role": "system", "content": "Yardımcı bir asistansın."},
        {"role": "user", "content": "Merhaba!"}
    ],
    max_tokens=1024
)
print(response.choices[0].message.content)

Uyumluluk

Karınca Labs API, Anthropic ve OpenAI uyumlu tüm araçlarla çalışır. Sadece base_url ve api_key değerlerini değiştirin — geri kalanı aynı kalır.

AI Kod Editörleri & IDE Eklentileri

CLI Araçları

SDK & Framework Entegrasyonları

Kurulum Kılavuzları

Cline Kurulum Rehberi

Claude API hizmetini Cline eklentisi üzerinden kullanmak için aşağıdaki adımları takip edin.

Limitler & Hatalar

Rate Limits

Rate limit'ler hesap başına uygulanır ve bakiye durumunuza göre değişir.

Yanıt Header'ları

Her API yanıtında rate limit bilgileri döner:

x-karinca-request-id: req-uuid-here
x-ratelimit-limit-requests: 30
x-ratelimit-remaining-requests: 28
x-ratelimit-reset-requests: 2026-04-02T09:00:00.000Z

Hata Kodları

Tüm hatalar JSON formatında döner. ok: false, code ve message alanlarını kontrol edin.

Desteklenen Modeller

Model Listesi

Sohbet modelleri /v1/messages (Anthropic) ve /v1/chat/completions (OpenAI) formatında kullanılabilir. Görsel ve video modelleri Studio ile medya endpoint'lerinden çalışır.