tAI API referansı

Endpoint

Bu API'deki her şey tek bir URL üzerinden yapılır:

# Base URL
https://api.artfical.com/v1

Tek bir tamamlama endpoint'i, POST /v1/chat/completions, ve tek bir salt okunur listeleme endpoint'i, GET /v1/models vardır. Yüzey bundan ibarettir. Model başına ayrı bir endpoint, streaming ile streaming olmayan istekler için ayrı bir endpoint (aynı URL, istek gövdesindeki bir alanla değiştirilerek her ikisini de işler) veya araç çağrısı turları için ayrı bir endpoint yoktur. OpenAI'nin Chat Completions API'sine, GitHub'ın çıkarım endpoint'lerine veya OpenAI uyumlu bir yapı sunan onlarca sağlayıcıdan herhangi birine karşı geliştirme yaptıysanız, bu size zaten tanıdık gelecektir. Bu benzerlik kasıtlıdır: mevcut bir OpenAI uyumlu istemciyi (resmi openai Python veya Node paketi, LangChain, LlamaIndex, OpenCode gibi bir kodlama ajanı veya kendi ince sarmalayıcınız) bir tAI API anahtarıyla https://api.artfical.com/v1 adresine yönlendirmek, çok az kod değişikliğiyle ya da hiç değişiklik yapmadan çalışmalıdır.

İlk isteğe giden en kısa yol

Üç şey gerekir: console.artfical.com üzerinde bir çalışma alanı, o çalışma alanındaki API anahtarları sayfasından oluşturulmuş bir API anahtarı ve herhangi bir HTTP istemcisi. İşte curl kullanan en kısa hali:

# Replace tai-sk-... with your own key
curl https://api.artfical.com/v1/chat/completions \
  -H "Authorization: Bearer tai-sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tai-4.1",
    "messages": [{"role": "user", "content": "Merhaba, kendini tanıt."}]
  }'

Bu tek istek başlı başına tam, çalışan bir entegrasyondur. Bu bölümdeki geri kalan her şey, streaming, araç çağrısı, görsel girişi, örnekleme kontrolleri, aynı yapının üzerine kurulu isteğe bağlı bir katmandır; öğrenilmesi gereken ayrı bir API değildir. Sohbet Tamamlamaları sayfası isteği ve yanıtı ayrıntılı olarak ele alır; Kimlik Doğrulama sayfası anahtarın nasıl verildiğini, kapsamının ne olduğunu ve nasıl yenilendiğini (rotate) anlatır.

Bu bölüm nasıl düzenlendi

Buradaki sayfalar, insanların bunlara gerçekte ihtiyaç duyduğu sıraya göre gruplandırılmıştır, temeldeki uygulamanın organize edildiği sıraya göre değil. İlk grup, başlarken, ne inşa ediyor olursanız olun herkesin ihtiyaç duyduğu kısımdır: nasıl kimlik doğrulanacağı, bir istek ve yanıtın yapısı, streaming'in tek bir bloklayan yanıttan nasıl farklı olduğu ve hangi modellerin mevcut olduğunu, her birinin neyi desteklediğini ve maliyetini nasıl keşfedeceğiniz. İkinci grup, istek seçenekleri, temel bir isteğin üzerine isteğe bağlı olan her şeyi kapsar: bir yanıtın nasıl üretildiğini şekillendiren örnekleme ayarları, modele çağırabileceği araçların nasıl verileceği ve metnin yanında bir görselin nasıl gönderileceği. Üçüncü grup, referans, baştan sona okunmak için değil, başvurulmak içindir: bir hata yanıtının tam yapısı ve her türün ne anlama geldiği, hız sınırlamasının nasıl çalıştığı ve bunu hangi başlıkların yansıttığı, modele göre fiyatlandırma tablosu ve mevcut bir OpenAI SDK entegrasyonundan geçiş yapan herkes için özel olarak nelerin olduğu gibi desteklendiği ve nelerin desteklenmediği.

Bu bölüm kimin için

Bu bölüm, API'ye karşı doğrudan kod yazan biri için yazılmıştır; bu bir arka uç servisi, bir betik ya da tAI'yi birbirinin yerine geçebilen OpenAI uyumlu sağlayıcılardan biri olarak ele alan OpenCode gibi bir ajan çatısı olabilir. HTTP istekleri göndermeye ve JSON okumaya aşina olduğunuzu varsayar, ancak tAI'ye özgü herhangi bir ön bilgi gerektirmez. Bunun yerine tAI'yi sohbet ürününün kendisi üzerinden nasıl kullanacağınızı arıyorsanız, bu konu bu bölümde değil ana tAI dokümanlarında ele alınır. tAI'nin güvenlik açısından nasıl değerlendirildiğini ve ürünün hangi korumalarla inşa edildiğini arıyorsanız, aradığınız Güvenlik bölümüdür. Bu bölüm yalnızca geliştiriciye yönelik HTTP API'yi kapsar: ne gönderdiğiniz, ne aldığınız ve her alanın ve başlığın ne anlama geldiği.

Kararlılıkla ilgili bir not

Bu bölümde belgelenen istek ve yanıt yapıları, kararlı tutmayı taahhüt ettiğimiz yapılardır. API büyüdükçe zaman içinde yeni bir alanın eklenmesini beklemelisiniz; ancak belgelenmiş bir alanın anlamının değişmesi veya bir alternatif sunulmadan kaldırılması, gelişigüzel yaptığımız bir şey değildir. Bir şey gerçekten geçiciyse veya değişme olasılığı yüksekse, ilgili sayfa bunu, sizi zor yoldan öğrenmeye bırakmak yerine açıkça belirtir. Bir alan veya davranış bu bölümde hiçbir yerde geçmiyorsa, bir yanıtta gözlemlemiş olsanız bile onu desteklenen sözleşmenin bir parçası saymayın; çünkü haber verilmeden değişebilir veya kaldırılabilir.