RealVirtuality AI — Geliştirici API

REST API · JSON · kredi bazlı. Üretimden önce hesabından kredi düşülür.

1. Kimlik doğrulama

Hesabına giriş yap → realvirtuality.app → Hesabım → API Anahtarı Oluştur. Her istekte başlık olarak gönder:

Authorization: Bearer rv_live_xxxxxxxxxxxxxxxx

2. Temel URL

https://realvirtuality.app/v1

3. Uç noktalar (endpoints)

Endpoint	Gövde (JSON)	Kredi	Dönen
POST /v1/image	`{"prompt":"..."}`	5	`image_base64`
POST /v1/text	`{"prompt":"..."}`	2	`text`
POST /v1/translate	`{"text":"...","target":"en"}`	1	`translation`
POST /v1/bg-remove	`{"image":"<base64>"}`	2	`image_base64`
POST /v1/transcribe	`{"audio_url":"https://..."}`	3	`text`

4. Örnek (cURL)

curl -X POST https://realvirtuality.app/v1/image \
  -H "Authorization: Bearer rv_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"minimal coffee shop logo, 3d"}'

5. Örnek (Python)

import requests, base64
r = requests.post("https://realvirtuality.app/v1/image",
    headers={"Authorization":"Bearer rv_live_xxx"},
    json={"prompt":"a futuristic city at sunset"})
data = r.json()
open("out.png","wb").write(base64.b64decode(data["image_base64"]))

6. Yanıt kodları

`200`	Başarılı (her yanıtta kalan `kredi` döner)
`401`	Geçersiz API anahtarı
`402`	Yetersiz kredi — kredi al
`502`	Üretim hatası (kredi otomatik iade edilir)

7. Kredi & fiyat

Kredi paketleri ve fiyatlar: realvirtuality.app. API kullanımı normal kredilerle çalışır; ücretsiz günlük kota API'de geçerli değildir.