Bağlantı kılavuzu

Proje ve API anahtarı oluşturma, Python ve curl bağlantısı, akış, bütçeler ve ServerNet AI API hataları.

  1. Modeli ve kullanılabilirliğini kontrol edin.
  2. Giriş yapın; ai:chat ve ai:models:read izinleriyle proje ve anahtar oluşturun.
  3. Cüzdanınıza bakiye ekleyin; küçük çıktı limitiyle deneme isteği gönderin.
  4. İsteğin kullanımını ve ücretini panelde inceleyin.
Anahtar yalnızca bir kez gösterilir. Sunucu ortam değişkeninde saklayın; tarayıcı koduna, GitHub’a veya günlüklere eklemeyin.

Temel URL

https://servernet.cloud/v1

Önce GET /v1/models ile kullanılabilir modelleri alın. Dönen id değerini isteklerde model adı olarak kullanın.

curl https://servernet.cloud/v1/models \
  -H "Authorization: Bearer $SERVERNET_API_KEY"

Python örneği

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["SERVERNET_API_KEY"],
    base_url="https://servernet.cloud/v1",
    max_retries=0,
)
models = client.models.list()
if not models.data:
    raise RuntimeError("No models available")
answer = client.chat.completions.create(
    model=models.data[0].id,
    messages=[{"role": "user", "content": "Hello"}],
    max_tokens=128,
    extra_headers={"Idempotency-Key": "my-request-001"},
)
print(answer.choices[0].message.content)

curl örneği

curl https://servernet.cloud/v1/chat/completions \
  -H "Authorization: Bearer $SERVERNET_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: my-request-002" \
  -d '{"model":"di-anthropicclaude-fable-5-86c0c8bf10","messages":[{"role":"user","content":"Hello"}],"max_tokens":128}'

Akış için stream=true gönderin. Son usage olayı token sayılarını ve servernet_charge_irt değerini içerir; ardından [DONE] gelir.

Aynı isteği yeniden denerken aynı Idempotency-Key değerini kullanın. Başarılı yanıtlar 24 saat boyunca yeniden ücret alınmadan oynatılır. x-should-retry:false varsa otomatik tekrar denemeyin.

Hatalar ve takip

401 geçersiz anahtar; 402 bakiye veya bütçe sınırı; 403 anahtar veya proje izni; 429 hız sınırı; 503 model veya sağlayıcı hazır değil. Gönderim sonrası bağlantı kesilirse kullanım kontrol edilene kadar rezerv tutulur. Destek için X-Request-Id değerini saklayın.

AI paneliModelleri karşılaştır