Tek endpoint.
Model bazlı güç.

API anahtarını güvenli gönder

Her istekte platform 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

Viona 4 ile ilk isteğinizi gönderin

Endpoint ve mesaj biçimi mevcut entegrasyonlarla aynıdır. Yalnızca model alanında istediğiniz model kimliğini kullanın.

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-4",
    "messages": [
      {"role": "user", "content": "Merhaba Viona"}
    ]
  }'

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-4-codix",
    messages: [{ role: "user", content: "Bu PHP fonksiyonunu optimize et." }]
  })
});

const data = await response.json();
console.log(data.choices[0].message.content);

<?php
$payload = json_encode([
    'model' => 'viona-4-pro',
    'messages' => [
        ['role' => 'user', 'content' => 'Bu mimariyi değerlendir.']
    ]
], JSON_UNESCAPED_UNICODE);

$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 => $payload
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

import requests

response = requests.post(
    "https://dev.vionaai.site/api/v1/chat",
    headers={
        "Authorization": "Bearer viona_live_YENI_API_KEYIN",
        "Content-Type": "application/json",
    },
    json={
        "model": "viona-4-mini",
        "messages": [{"role": "user", "content": "Bunu 3 maddede özetle."}],
    },
    timeout=120,
)
response.raise_for_status()
print(response.json()["choices"][0]["message"]["content"])

Chat completion

Dört ayrı kullanım profili

Her profilin yönergeleri, çıktı bütçesi ve görev işleyişi ayrıdır. Bu ayarlar sağlayıcı modelinin parametre sayısını veya eğitimini değiştirmez. Codix, çok dosyalı HTML/CSS/JS ve 3D projelerinde dosya sözleşmeleri, performans ve tam kaynak teslimine odaklanır.

Üst bütçe tek seferde bu kadar token üretileceği garantisi değildir. Girdi ve birikmiş yanıt bağlamı doldurursa üretim durur. Uzun projeleri dosya dosya üretin. Ek sağlayıcı çağrıları gecikmeyi ve sağlayıcı kullanımını artırabilir; mevcut Viona kredi tarifesi korunur.

Hangi modeli seçmeliyim?

Kısa ve ekonomik işler için Mini, dengeli genel kullanım için Viona 4, yazılım geliştirme için Codix, karmaşık analiz ve ileri üretim için Pro önerilir.

API'de kullanılan kimlikler

Yeni Viona 4 ailesi aşağıdaki temiz model ID'leriyle seçilir. Eski modeller kaldırılmamıştır.

viona-4-mini
viona-4
viona-4-codix
viona-4-pro

Güncel model kataloğu

GET /api/v1/models uç noktası model adı, açıklama, kredi maliyeti ve yetenek bilgilerini döndürür.

Mevcut response sözleşmesi korunur

choices[0].message.content aynı yerdedir. finish_reason: length yanıtın tamamlanmadığını gösterir; içerik korunur. Viona 4 yanıtındaki ek generation alanı planlama, çağrı sayısı, tahmini kullanım ve durma nedenini bildirir. usage bütün başarılı üretim turlarının toplamıdır. Bu API JSON yanıt verir; SSE/streaming veya tool execution desteği eklenmemiştir.

Başarılı yanıtta seçtiğiniz model kimliği model alanında geri döner. credits.cost ve X-Credit-Cost gerçek model maliyetini gösterir.

{
  "id": "req_...",
  "object": "chat.completion",
  "model": "viona-4",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "..."},
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 18,
    "completion_tokens": 42,
    "total_tokens": 60
  },
  "credits": {"cost": 2, "remaining": 98}
}

Kredi tüketimi artık modele göre değişir

Eski modellerin mevcut kredi maliyeti korunur. Viona 4 ailesinde varsayılan hiyerarşi Mini 1, Viona 4 2, Codix 3 ve Pro 4 kredidir. Başarısız upstream isteğinde tüketilen kredi mevcut iade akışıyla geri verilir.

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

HTTP durum ve hata türleri

Yeni modeller mevcut API hata gövdesini kullanır; ayrı ve uyumsuz bir error schema oluşturulmaz.

İstemci anahtarı ile provider secret'ını ayırın

Kullanıcıların viona_live_... anahtarları platform kimlik doğrulaması içindir. Upstream/provider anahtarları yalnızca sunucu tarafında tutulur ve frontend'e gönderilmez.