Ücretsiz yapay zekâ API ile ilk isteğini gönder

Yapay zekâ API nedir?

Yapay zekâ API, uygulamanın bir modele HTTP üzerinden mesaj gönderip yanıt almasını sağlar. Sohbet arayüzü, metin özetleme veya bir yazı asistanı geliştirirken modelin çalıştığı altyapıyı uygulamandan ayrı tutabilirsin. Entegrasyonun temel parçaları servis adresi, API anahtarı ve model adıdır.

WhatOTP, Chat Completions biçimini kullanan bir API sunar. gpt-6-astra bu platformun genel model takma adıdır; yanıtları üreten model ve kullanılabilirlik, yönetici tarafından bağlanan sağlayıcıya bağlıdır. Başlamadan önce sistem durumu sayfasından bağlantının etkin olduğunu kontrol et.

1. Hesabını ve API anahtarını oluştur

Ücretsiz hesabına giriş yaptıktan sonra panelde API anahtarları bölümünü aç. Projene kolayca tanıyabileceğin bir ad vererek anahtar oluştur. Anahtarın tamamı yalnızca oluşturulduğu anda gösterilir; sunucu ortam değişkenine kaydet.

WHATOTP_API_KEY anahtarını, WHATOTP_BASE_URL ise kullandığın WhatOTP adresinin /v1 ile biten API kökünü taşımalıdır. Yerel geliştirmede örnek adres http://localhost:3000/v1 olur. Yayındaki projen için kendi servis alan adını kullan.

• Anahtarı tarayıcıya gönderilen JavaScript içine yazma.
• Geliştirme ve üretim projeleri için ayrı anahtarlar oluştur.
• Ortam değişkenlerini değiştirdikten sonra uygulama sunucunu yeniden başlat.

2. OpenAI SDK ile ilk isteğini gönder

Node.js projenin terminalinde npm install openai komutunu çalıştır. Aşağıdaki örneği sunucu tarafındaki bir dosyada kullan. SDK, isteği yapılandırdığın baseURL adresine gönderir; OpenAI hesabına ait bir anahtar yerine WhatOTP anahtarını kullanmalısın.

messages dizisi modele gönderilecek konuşmayı taşır. Basit bir deneme için tek user mesajı yeterlidir. Yanıt metni choices dizisinin ilk elemanındaki message.content alanında bulunur. İstek başarısızsa içeriği okumadan önce SDK’nın döndürdüğü hatayı işle.

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.WHATOTP_API_KEY,
  baseURL: process.env.WHATOTP_BASE_URL,
});

const response = await client.chat.completions.create({
  model: "gpt-6-astra",
  messages: [{ role: "user", content: "Hello, Astra!" }],
});

console.log(response.choices[0]?.message.content);

3. Sonucu ve kullanımını kontrol et

Panelde istek geçmişini açarak durum kodunu, seçilen modeli ve yanıt süresini incele. Kullanım değerinin yanında ≈ işareti varsa token sayısı sağlayıcının bildirdiği kesin sayı yerine bir tahmindir. Aynı isteği tekrar tekrar göndermeden önce hata kodunu kontrol etmek gereksiz trafiği azaltır.

401 hatasında anahtarını ve hesabının etkinliğini kontrol et. 400 hatasında model adı ile istek alanlarını gözden geçir. 503, sağlayıcının henüz bağlı olmaması veya model erişiminin duraklatılması anlamına gelebilir. Playground’daki etiketli demo yanıtı, gerçek API bağlantısının çalıştığını kanıtlamaz.

İlk bağlantıdan çalışan bir ürüne

İlk yanıtı aldıktan sonra uygulamana yükleniyor durumu, hata mesajı ve kullanıcıya yeniden deneme imkânı ekle. Daha akıcı bir sohbet deneyimi için streaming kullanabilirsin. Desteklenen alanların güncel listesi ve hata kodları dokümantasyonda yer alır.

Platformun bu sürümünde kullanım ücreti veya günlük istek/token kotası uygulanmaz. Bununla birlikte bağlı sağlayıcının limitleri ve teknik kapasitesi erişimi etkileyebilir. Ürün akışını bu olasılığı dikkate alarak tasarla; modelin her isteğe aynı sürede yanıt vereceğini varsayma.