Skip to content

Docs

Geliştirici belgeleri

AITREE, OpenAI API’siyle uyumludur. Çoğu SDK’da yalnızca base_url ve api_key değerlerini değiştirmeniz yeterli.

API Anahtarı Al

Kimlik doğrulama

Authorization başlığında bir Bearer token gönderin. Anahtarları konsolda oluşturup yönetin.

Authorization: Bearer $AITREE_API_KEY

Sohbet tamamlamaları

Akış dahil, OpenAI /v1/chat/completions ile aynı parametreler.

curl https://aitree.ai/v1/chat/completions \
  -H "Authorization: Bearer $AITREE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash-0731",
    "stream": true,
    "messages": [{ "role": "user", "content": "用一句话解释什么是算力中转站" }]
  }'

Anthropic Messages

Claude modelleri yerel Anthropic protokolünü de destekler: resmî SDK’nın base_url’ini AITREE’ye yönlendirin (/v1 olmadan) ve aynı API anahtarını kullanın.

import anthropic

client = anthropic.Anthropic(base_url="https://aitree.ai", api_key="YOUR_AITREE_KEY")

msg = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}],
)
print(msg.content[0].text)

Görsel üretimi

OpenAI /v1/images/generations ile aynıdır; görsel URL’leri döndürür. Modele göre çağrı başına veya token başına faturalandırılır.

curl https://aitree.ai/v1/images/generations \
  -H "Authorization: Bearer $AITREE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "a glowing compute tree at night, cinematic",
    "size": "1024x1024"
  }'

Video üretimi

Videolar asenkron görevlerdir: POST /v1/video/generations bir task_id döndürür; video URL’sini almak için status succeeded olana kadar GET /v1/video/generations/{id} uç noktasını sorgulayın.

# 1. submit
curl https://aitree.ai/v1/video/generations \
  -H "Authorization: Bearer $AITREE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "model": "doubao-seedance-2-0-fast-260128", "prompt": "drone shot through a forest of light", "seconds": "5" }'

# 2. poll until status is "succeeded"
curl https://aitree.ai/v1/video/generations/$TASK_ID \
  -H "Authorization: Bearer $AITREE_API_KEY"

Modelleri listele

Anahtarınızın şu anda erişebildiği modelleri keşfedin.

curl https://aitree.ai/v1/models \
  -H "Authorization: Bearer $AITREE_API_KEY"

Anahtarlar ve güvenlik

Her anahtara harcama limiti, son kullanma tarihi, model izin listesi ve IP izin listesi tanımlanabilir. Bir anahtar sızarsa konsoldan devre dışı bırakıp yenisini oluşturun.

Hatalar

Hata yanıtları OpenAI yapısını izler; kaynağı error.type belirtir.

{
  "error": {
    "message": "insufficient user quota",
    "type": "new_api_error",
    "code": "insufficient_user_quota"
  }
}

Uyumluluk

Resmî OpenAI SDK’ları, LangChain, LlamaIndex, Cherry Studio, Open WebUI, Cursor ve özel base_url kabul eden diğer tüm araçlarla çalışır.

Geliştirici belgeleri · AITREE