İçeriğe geç
Kılavuzlar
Kılavuzlar

Hızlı başlangıç

Desteklenen eşzamanlı veya akış protokolü aracılığıyla RunAPI dil modellerini çağırın.

Markdown'ı görüntüle

RunAPI, dil modellerini tanıdık genel protokol şekilleri aracılığıyla sunar. Mevcut uyumlu bir istemciyi https://runapi.ai adresine yönlendirin, bir RunAPI model tanımlayıcısı kullanın ve standart bir API anahtarıyla kimlik doğrulaması yapın.

Bir protokol seçin

  • OpenAI uyumlu Chat Completions, POST /v1/chat/completions kullanır.
  • OpenAI uyumlu Responses, POST /v1/responses kullanır.
  • Anthropic uyumlu Messages, POST /v1/messages kullanır.
  • Gemini uyumlu içerik üretimi, /v1beta/models/{model}:generateContent veya :streamGenerateContent kullanır.

Mevcut istemcinize ve uygulama akışınıza en uygun protokolü seçin. Model kataloğu, her modelin hangi genel protokolleri desteklediğini belirtir.

İstek gönder

Bu Chat Completions isteği tek bir eş zamanlı yanıt döndürür:

SHELL 
curl "https://runapi.ai/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [{"role": "user", "content": "Summarize why idempotency matters."}]
  }'

İsteği ve yanıtı seçilen protokol biçiminde tutun. Tam alanlar, araç çağrısı, yapılandırılmış çıktı ve modele özgü kısıtlamalar için işlemin API Başvurusunu kullanın.

Çıktıyı akış olarak gönder

Protokolün akış seçeneğini ayarlayın ve döndürülen sunucu tarafından gönderilen olayları aşamalı olarak tüketin. Chat Completions için "stream": true ekleyin; Gemini uyumlu çağrılar için :streamGenerateContent işlemini kullanın. İstemciniz protokolün terminal olayını aldığında akışı kapatın.

Teslimat doğruluğunu incele

Kabul edilen her LLM yanıtı X-RunAPI-Fidelity içerir. full değeri isteğin herhangi bir eksiklik olmadan iletildiğini gösterir. lossy değeri, RunAPI’nin isteği tamamlamak için isteğe bağlı bazı denetimleri atladığını gösterir; X-RunAPI-Omitted-Fields bu alanların virgülle ayrılmış adlarını içerir. Zorunlu yaşam döngüsü, devam, araç veya türlendirilmiş öğe semantiği korunamayan istekler, bir Görev oluşturulmadan önce reddedilir.

Her iki başlık da CORS aracılığıyla açıktır, bu nedenle tarayıcı istemcileri bunları inceleyebilir. Tam teslim davranışı uygulama için önemli olduğunda bunları istek tanımlayıcısıyla birlikte kaydedin.

Hataları ve kullanımı işle

401 yanıtını kimlik doğrulama hatası, 4xx yanıtlarını istek veya ilke sorunu olarak değerlendirin; yalnızca geçici sunucu veya ağ hatalarında yeniden deneyin. Token kullanımını nihai yanıttan veya seçilen protokol biçimindeki terminal akış olayından okuyun; destek için istek tanımlayıcılarını uygulama günlüklerinde saklayın.