API · AIforYU.com

API anahtarı

Yükleniyor…

İlk istek

Anahtarını Authorization başlığında gönder:

curl {{API}}/v1/chat/completions \
  -H "Authorization: Bearer $AIFORYU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.8:27b",
    "messages": [{"role": "user", "content": "Merhaba!"}]
  }'

Python

Resmî openai paketiyle yalnızca adresi değiştirmen yeterli:

import os
from openai import OpenAI

client = OpenAI(
    base_url="{{API}}/v1",
    api_key=os.environ["AIFORYU_API_KEY"],
)

stream = client.chat.completions.create(
    model="qwen3.8:27b",
    messages=[{"role": "user", "content": "Merhaba!"}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

Görsel göndermek

Görseli base64 data URL olarak ekle. Yalnızca JPEG ve PNG kabul edilir; görsel başına yaklaşık 2 MB, istek başına en çok 4 görsel. Bağlantıdan görsel indirilmez.

import base64, os
from openai import OpenAI

client = OpenAI(base_url="{{API}}/v1", api_key=os.environ["AIFORYU_API_KEY"])

with open("afis.jpg", "rb") as dosya:
    gorsel = base64.b64encode(dosya.read()).decode()

yanit = client.chat.completions.create(
    model="qwen3.8:27b",
    messages=[{"role": "user", "content": [
        {"type": "text", "text": "Bu afişi kısaca anlat."},
        {"type": "image_url", "image_url": {"url": f"data:image/jpeg;base64,{gorsel}"}},
    ]}],
)
print(yanit.choices[0].message.content)

Uç noktalar

Uç nokta	Ne yapar
`GET /v1/models`	Kullanılabilir modelleri listeler.
`POST /v1/chat/completions`	Sohbet yanıtı üretir. `stream: true` desteklenir.

Hata kodları

Kod	Anlamı	Ne yapmalı
`400`	İstek geçersiz; ör. desteklenmeyen model veya görsel.	Hata mesajına göre isteği düzelt.
`401`	Anahtar eksik veya geçersiz.	Anahtarını kontrol et.
`403`	Hesap henüz onaylanmadı.	Yöneticiye başvur.
`429`	Sunucu yoğun veya kullanım sınırı doldu.	Bekleyip tekrar dene.
`503`	Model sunucusu çalışmıyor.	Daha sonra tekrar dene.

Kullanım sınırları ekip kullanımında belirlenecek.