Goat API
Reference

SKYMOD tarafından geliştirilen Goat büyük dil modeline erişmek için üretim odaklı API. Sohbet, kod, özetleme, analiz ve Türkçe ağırlıklı kurumsal kullanım senaryoları için tasarlanmıştır.

Chat API Uyumlu

SSE Streaming

Türkçe Öncelikli

Production Ready

Overview Giriş

Goat API, SKYMOD Teknoloji tarafından geliştirilen Goat büyük dil modeline HTTP üzerinden erişim sağlar. Goat; kullanıcılarla doğal dilde konuşabilen, talimatları takip edebilen, uzun metinleri analiz edebilen, kod üretebilen ve kurumsal bilgi iş akışlarında asistan olarak kullanılabilen genel amaçlı bir dil modelidir.

Tüm istekler HTTPS üzerinden yapılmalıdır. API yanıtları JSON formatında döner.

Goat Model

Goat, SKYMOD tarafından geliştirilen yeni nesil büyük dil modelidir. Kullanıcı tarafında model adı her zaman goat olarak kullanılır.

Model Card

Fine-Tuning & Alignment

Capabilities

Goat; doğal dilde talimat takip etmek, karmaşık metinleri özetlemek, kod yazmak ve çok turlu diyaloglarda bağlamı korumak için tasarlanmıştır.

Quick Start

curl https://goat.skymod.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-<API_KEY>" \
  -d '{"model":"goat","messages":[{"role":"user","content":"Merhaba! Bana Türkiye hakkında 3 ilginç bilgi ver."}],"max_tokens":512,"temperature":0.7}'

import requests

response = requests.post(
    "https://goat.skymod.ai/v1/chat/completions",
    headers={
        "Authorization": "Bearer sk-<API_KEY>",
        "Content-Type": "application/json",
    },
    json={
        "model": "goat",
        "messages": [{"role": "user", "content": "Merhaba!"}],
        "max_tokens": 512, "temperature": 0.7,
    },
)
print(response.json()["choices"][0]["message"]["content"])

const res = await fetch("https://goat.skymod.ai/v1/chat/completions", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer sk-<API_KEY>",
  },
  body: JSON.stringify({
    model: "goat",
    messages: [{role: "user", content: "Merhaba!"}],
    max_tokens: 512, temperature: 0.7,
  }),
});
const data = await res.json();
console.log(data.choices[0].message.content);

{
  "id": "chatcmpl-a8f3d2b1c4e5",
  "object": "chat.completion",
  "model": "goat",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "İşte Türkiye hakkında 3 ilginç bilgi..."},
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens": 28, "completion_tokens": 147, "total_tokens": 175}
}

Authentication

Goat API, Bearer token tabanlı kimlik doğrulama kullanır. /health hariç tüm endpoint'ler kimlik doğrulama gerektirir.

Header Formatı

Authorization: Bearer sk-<API_KEY>

Güvenlik Notları

• API anahtarları sunucuda SHA-256 hash olarak saklanır; plaintext asla kaydedilmez.
• Anahtarınızı kaynak koda veya log dosyalarına yazmayın — .env / environment variable kullanın.
• Anahtarın sızdığını düşünüyorsanız SKYMOD ekibiyle iletişime geçerek derhal iptal ettirin.
• Her proje veya müşteri için ayrı anahtar oluşturulması önerilir.

Base URL & Versioning

https://goat.skymod.ai

Tüm endpoint'ler bu base URL altında /v1/ prefix'i ile sunulur.

Chat Completions

Bir konuşma geçmişini alarak bir sonraki asistan mesajını üretir. Hem tek seferlik sorgular hem de çok turlu diyaloglar için kullanılır.

Request Body

İstek gövdesi application/json formatında gönderilmelidir.

Thinking

Goat API'de thinking tamamen opsiyoneldir. Alan gönderilmezse mevcut Chat Completions request/response sözleşmesi aynı kalır. Yeni thinking alanı gönderildiğinde proxy, public sözleşmeyi vLLM tarafındaki thinking_token_budget ve chat_template_kwargs.enable_thinking ayarlarına çevirir.

Adaptive Thinking

{
  "model": "goat",
  "messages": [{"role": "user", "content": "Bu mimariyi güvenlik ve performans açısından analiz et."}],
  "max_tokens": 3000,
  "thinking": {
    "type": "adaptive",
    "effort": "high",
    "include_reasoning": false
  }
}

Manual Thinking

{
  "model": "goat",
  "messages": [{"role": "user", "content": "2x + 5 = 13, x kaçtır?"}],
  "max_tokens": 1500,
  "thinking": {
    "type": "manual",
    "budget_tokens": 800,
    "include_reasoning": true
  }
}

Thinking Metadata

Yeni thinking alanı kullanıldığında yanıt, uygulanan ayarı gösteren opsiyonel goat.thinking metadata'sı içerebilir.

{
  "goat": {
    "thinking": {
      "type": "adaptive",
      "effort": "high",
      "applied_level": "high",
      "token_budget": 3072,
      "reasoning_included": false
    }
  }
}

🎛️ Parameter Playground

Parametrelerin etkisini görsel olarak keşfedin. Kod örneği otomatik güncellenir.

Message Object

Role Açıklamaları

Response Schema

ChatCompletion Object

Choice Object

Assistant Message Object

Usage Object

Streaming (SSE)

İstek gövdesinde "stream": true gönderildiğinde API, Server-Sent Events formatında yanıt verir. Her chunk bir data: satırı olarak gelir; akış data: [DONE] ile biter.

Thinking açıkken streaming yanıtlarında delta.reasoning chunk'ları gelebilir. thinking.include_reasoning: false gönderildiğinde proxy bu alanları filtreler ve istemci yalnızca nihai delta.content akışını görür.

curl https://goat.skymod.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-<API_KEY>" \
  --no-buffer \
  -d '{"model":"goat","messages":[{"role":"user","content":"Uzun bir hikaye anlat."}],"stream":true,"thinking":{"type":"adaptive","effort":"medium","include_reasoning":false}}'

import requests, json

with requests.post(
    "https://goat.skymod.ai/v1/chat/completions",
    headers={"Authorization": "Bearer sk-<API_KEY>", "Content-Type": "application/json"},
    json={"model": "goat", "messages": [{"role": "user", "content": "Uzun bir hikaye anlat."}], "stream": True, "thinking": {"type": "adaptive", "effort": "medium", "include_reasoning": False}},
    stream=True,
) as resp:
    for line in resp.iter_lines():
        if line and line.startswith(b"data: "):
            payload = line[6:]
            if payload == b"[DONE]": break
            chunk = json.loads(payload)
            print(chunk["choices"][0]["delta"].get("content", ""), end="", flush=True)

const res = await fetch("https://goat.skymod.ai/v1/chat/completions", {
  method: "POST",
  headers: {"Content-Type": "application/json", "Authorization": "Bearer sk-<API_KEY>"},
  body: JSON.stringify({model: "goat", messages: [{role: "user", content: "Uzun bir hikaye anlat."}], stream: true, thinking: {type: "adaptive", effort: "medium", include_reasoning: false}}),
});
const reader = res.body.getReader();
const decoder = new TextDecoder();
while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  for (const line of decoder.decode(value).split("\n")) {
    if (!line.startsWith("data: ") || line === "data: [DONE]") continue;
    const chunk = JSON.parse(line.slice(6));
    process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
  }
}

List Models

curl https://goat.skymod.ai/v1/models \
  -H "Authorization: Bearer sk-<API_KEY>"

Health Check

curl https://goat.skymod.ai/health
# → {"status": "ok"}

Postman Collection

Güncel Postman koleksiyonu public olarak aşağıdaki adresten indirilebilir. Koleksiyon yeni thinking sözleşmesini, adaptive/manual örneklerini, reasoning gizleme ve streaming kullanımını içerir.

curl https://goat.skymod.ai/postman
# → goat-api-skymod.postman_collection.json

Errors

API, hata durumlarında standart HTTP durum kodları ve JSON hata gövdesi döner.

Kod Örnekleri

Goat API standart HTTP istekleriyle kullanılır.

import requests

API_KEY = "sk-<API_KEY>"
headers = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}
payload = {
    "model": "goat",
    "messages": [
        {"role": "system", "content": "Sen yardımcı bir asistansın."},
        {"role": "user", "content": "Python decorator nedir?"},
    ],
    "temperature": 0.5, "max_tokens": 1024,
}
response = requests.post("https://goat.skymod.ai/v1/chat/completions", json=payload, headers=headers)
print(response.json()["choices"][0]["message"]["content"])

async function ask(question: string): Promise<string> {
  const res = await fetch("https://goat.skymod.ai/v1/chat/completions", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.GOAT_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({model: "goat", messages: [{role: "user", content: question}], max_tokens: 1024}),
  });
  const data = await res.json();
  return data.choices[0].message.content;
}

from openai import OpenAI

client = OpenAI(
    api_key="sk-<API_KEY>",
    base_url="https://goat.skymod.ai/v1",
)
response = client.chat.completions.create(
    model="goat",
    messages=[{"role": "user", "content": "Goat API ile neler yapabilirim?"}],
    temperature=0.5, max_tokens=512,
)
print(response.choices[0].message.content)

Best Practices

Temperature Seçimi

Token Yönetimi

• max_tokens değerini gerçekçi tutun; fazla büyük değerler gereksiz gecikmeye yol açar.
• finish_reason === "length" ise yanıt kesilmiş demektir — max_tokens değerini artırın.
• Uzun konuşmalarda bağlam penceresi aşılmaması için eski mesajları budayın.

Guardrails Güvenlik Katmanı

Goat API, üretim kullanımı için guardrail katmanıyla çalışır. Bu katman, kullanıcı isteği modele ulaşmadan önce ve yanıt kullanıcıya dönmeden önce riskli içerikleri azaltmaya yardımcı olur. Amaç; güvenli, tutarlı ve kurumsal kullanıma uygun bir yanıt davranışı sağlamaktır.

Risk Kapsamı

Response Davranışı

Normal isteklerde mevcut Chat Completions istek ve yanıt yapısı korunur. Guardrail tarafından riskli değerlendirilen içeriklerde kullanıcıya güvenli, kısa ve yönlendirici bir yanıt dönebilir. Bu davranış uygulama entegrasyonunu bozmadan riskli akışları azaltmak için tasarlanmıştır.

Production Guide

Goat API üretim ortamlarında backend servisleri üzerinden çağrılmalıdır.

Limits & Quotas

Performans