V
Viona AIAPI Documentation
Viona Developer API

Viona API dokümantasyonu

Viona AI modellerini web, mobil ve sunucu uygulamalarınıza bağlamak için gerekli endpoint, kimlik doğrulama, model seçimi ve hata yönetimi bilgileri.

01
Kimlik doğrulama

API anahtarını güvenli gönder

Her istekte API anahtarınızı Authorization başlığında Bearer değeri olarak gönderin. Alternatif olarak X-API-Key başlığı kullanılabilir.

Authorization: Bearer viona_live_YENI_API_KEYIN

Anahtarı tarayıcı kaynak koduna veya herkese açık depoya yazmayın. Üretim entegrasyonunda anahtarı sunucu tarafında saklayın.

02
Quickstart

İlk sohbet isteğini gönder

Chat endpointi OpenAI benzeri mesaj dizisi ve yanıt yapısı kullanır.

curl -X POST "https://dev.vionaai.site/api/v1/chat" \
  -H "Authorization: Bearer viona_live_YENI_API_KEYIN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viona-ti-3.0",
    "messages": [
      {"role": "user", "content": "Viona API ile kısa bir tanıtım yaz."}
    ],
    "temperature": 0.7,
    "max_tokens": 1024
  }'
const response = await fetch("https://dev.vionaai.site/api/v1/chat", {
  method: "POST",
  headers: {
    "Authorization": "Bearer viona_live_YENI_API_KEYIN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "viona-chat-1.5",
    messages: [
      { role: "user", content: "Merhaba Viona" }
    ],
    temperature: 0.7,
    max_tokens: 1024
  })
});

const data = await response.json();
console.log(data.choices[0].message.content);
<?php
$payload = [
    'model' => 'viona-codix-1.6',
    'messages' => [
        ['role' => 'user', 'content' => 'Güvenli bir PHP formu yaz.']
    ],
    'temperature' => 0.4,
    'max_tokens' => 2048
];

$ch = curl_init('https://dev.vionaai.site/api/v1/chat');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer viona_live_YENI_API_KEYIN',
        'Content-Type: application/json'
    ],
    CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_UNICODE),
    CURLOPT_TIMEOUT => 120
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo $response;
03
Endpoint

Chat completion

POSThttps://dev.vionaai.site/api/v1/chat
AlanTürAçıklama
modelstring

Kullanılacak Viona modelinin kimliği.

messagesarray

system, user ve assistant rollerinden oluşan mesaj dizisi.

temperaturenumber

0 ile 2 arasında üretim çeşitliliği. Varsayılan 0.7.

max_tokensinteger

64 ile 8192 arasında yanıt sınırı. Varsayılan 1024.

04
Modeller

Dört Viona AI modeli

Uygulamanızın ihtiyacına göre aşağıdaki model kimliklerinden birini gönderin.

viona-ti-3.0

Viona TI 3.0

Genel amaçlı akıl yürütme, analiz ve üretken görevler için dengeli model.

viona-mythrion

Viona Mythrion

Yaratıcı üretim, strateji, fikir geliştirme ve uzun biçimli içerikler için model.

viona-chat-1.5

Viona Chat 1.5

Hızlı, doğal ve çok turlu sohbet deneyimleri için model.

viona-codix-1.6

Viona Codix 1.6

Kod yazma, hata ayıklama, mimari tasarım ve teknik dokümantasyon için model.

GEThttps://dev.vionaai.site/api/v1/models
05
Yanıt

Başarılı yanıt yapısı

{
  "id": "req_123456",
  "object": "chat.completion",
  "created": 1785456000,
  "model": "viona-ti-3.0",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Merhaba! Sana nasıl yardımcı olabilirim?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 18,
    "completion_tokens": 12,
    "total_tokens": 30
  },
  "rate_limit": {
    "limit": 100,
    "remaining": 99,
    "reset_at": 1785512400
  }
}
06
İstek sınırları

Günlük 100 ücretsiz istek

Her yeni API anahtarı günlük 100 istek hakkıyla oluşturulur. Hak gece yarısında otomatik yenilenir. Daha yüksek limitler için faturalandırmanın etkinleştirilmesi gerekir; faturalandırma işlemleri şu anda bakım nedeniyle kapalıdır.

X-RateLimit-Limit

Günlük toplam istek hakkı.

X-RateLimit-Remaining

Bugün kalan istek hakkı.

X-RateLimit-Reset

Yenilenme zamanının Unix değeri.

07
Kaynak kısıtlaması

Yalnızca izin verilen sitelerden kabul et

API key ayarlarında her satıra bir origin ekleyebilirsiniz. Protokol ve alan adı birlikte yazılmalıdır. Sayfa yolu eklemeyin.

https://ornek.com
https://panel.ornek.com

Sunucu tarafındaki isteklerde origin başlığı gönderilmeyebilir. Kısıtlı bir anahtar kullanıyorsanız entegrasyon mimarinizi buna göre planlayın.

08
Hatalar

HTTP durum ve hata türleri

400invalid_request_error

JSON gövdesi veya istek biçimi geçersiz.

401authentication_error

API anahtarı eksik veya geçersiz.

403origin_not_allowed

İstek kaynağı izin verilen listede değil.

413request_too_large

İstek gövdesi veya içerik sınırı aşıldı.

422invalid_model

Model veya parametre doğrulaması başarısız.

429daily_quota_exceeded

Günlük istek hakkı tükendi.

502upstream_unavailable

Viona AI çekirdek servisi geçici olarak yanıt veremiyor.

503service_unavailable

Platform geçici olarak kullanılamıyor.

09
Güvenlik

Üretim kontrol listesi

Ortam değişkeni kullan

Anahtarınızı kaynak kod yerine sunucu ortam değişkeninde tutun.

Düzenli yenile

Sızıntı şüphesinde anahtarı panelden yenileyin veya iptal edin.

Origin kısıtla

Tarayıcı tabanlı kullanımda izin verilen kaynak listesini daraltın.

Kullanımı izle

Beklenmeyen trafik, hata ve gecikme değişimlerini panelden takip edin.