Geliştiriciler

Asistanı kendi uygulamana, MCP istemcine ya da siteme taşı. Her kapıda bedel sohbet ekranındakiyle aynı.

3 adımda başla

1
Anahtarını oluştur
Profil → Geliştirici sekmesinden bir API anahtarı al. Anahtar hesabının adına çalışır.
API anahtarlarını yönet →
2
Burada dene
Aşağıdaki deneme alanında bir uç nokta seç, anahtarını yapıştır ve Test et'e bas.
Deneme alanı →
3
Koduna ekle
Hazır cURL, JavaScript ya da Python örneğini kopyala; MCP ve widget için sekmelere bak.
Dokümantasyon →

Deneme alanı

Bir uç nokta seç, parametreleri doldur ve Test et'e bas. İstekler gerçek; kodu olduğu gibi kopyalayabilirsin.

POST/api/v1/conversations

Yeni sohbet: { text, locale?, model?, tools? } — tools ile görsel, video, müzik ya da ses üret.

BaşlıklarAPI anahtarıGiriş yapAuthorization: BearerYalnız bu sayfanın belleğinde tutulur; hiçbir yere kaydedilmez.

Gövdetextmodel

tools

Seçmezsen asistan karar verir. Video ve müzik arka planda üretilir; sohbeti okuyarak sonucu al.

Yanıt gelene kadar bekle

Gerçek istek: mesaj bedeli kredinden düşer. (1 kredi)

Kod

curl -X POST "https://yapayzeka.my/api/v1/conversations" \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"text":"…","locale":"tr"}'

Yanıt gövdesi

Yanıt burada görünecek.

Dokümantasyon

Kimlik doğrulama

Profil → Geliştirici sekmesinden bir API anahtarı oluştur ve her isteğe başlık olarak ekle. Anahtar hesabın adına çalışır; kimseyle paylaşma.

Authorization: Bearer sk_...

REST API

JSON alır ve döner. Yanıt arka planda yazılır: mesajı gönder, sonra sohbeti okuyarak `pending: false` olana kadar bekle.

POST/api/v1/conversationsYeni sohbet: { text, locale?, model?, tools? } — tools ile görsel, video, müzik ya da ses üret.
POST/api/v1/conversations/{id}Sohbete yeni mesaj: { text, locale?, model?, tools? }
GET/api/v1/conversations/{id}Sohbetin son mesajları ve `pending` durumu
GET/api/v1/conversationsSon sohbetlerin
GET/api/v1/creditsKalan kredin
GET/api/v1/toolsKullanılabilir araçlar ve kredi bedelleri

curl -X POST https://yapayzeka.my/api/v1/conversations \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"text": "Merhaba", "locale": "tr", "thinking": false}'
# → {"id": "…"}  — yanıtı birkaç saniye sonra oku
curl https://yapayzeka.my/api/v1/conversations/{id} -H "Authorization: Bearer sk_..."

İsteğe bağlı alanlar: thinking (false → akıl yürütme kapalı, daha hızlı ve ucuz yanıt), instructions (bu tura özel sistem talimatı, en fazla 20.000 karakter; her istekte yeniden gönder), private (true → paket özel sohbete izin vermiyorsa 402 needs-private). Okunan mesajlarda reasoning alanı modelin akıl yürütmesini taşır.

Hatalar: 401 geçersiz anahtar · 402 kredi yetmiyor ya da Pro gerekiyor · 409 önceki yanıt sürüyor ya da yayın onayı gerekiyor · 429 hız sınırı.