Jev API Docs

Endpoint

Bu hosta POST /api/v1/decisions gönderin. chat-completions yolu ve akış yanıtı yoktur. GET /api/v1/models model kimliğini listeler.

POST https://jev-api.org/api/v1/decisions
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Kimlik doğrulama

Pano anahtarını Authorization: Bearer içine koyun. Eksik veya reddedilen anahtar 401 döner. Playground isteği çalıştırırken oturum hesabı için anahtar oluşturabilir.

Hızlı başlangıç

JEV_API_KEY’i panonuzdaki bir anahtara ayarlayın, ardından aşağıdaki isteği gönderin. Yeni hesaplar 2 kredi alır; 2 başarılı çağrı için yeterlidir.

curl https://jev-api.org/api/v1/decisions \
  -H "Authorization: Bearer $JEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "jev-1.13",
  "state": "Thanks for the refund. Still annoyed it took three emails.",
  "questions": {
    "sentiment": {
      "type": "choice",
      "instructions": "What is the overall sentiment of this message?",
      "criteria": {
        "positive": "Satisfied or thankful overall.",
        "mixed": "Both satisfied and unhappy.",
        "negative": "Unhappy overall."
      }
    },
    "needs_follow_up": {
      "type": "noul",
      "instructions": "Should a person reply to this message?"
    }
  }
}'

AI kodlama araçlarıyla kullanma

İstek sözleşmesinin tamamını içeren bir promptu kopyalayıp görevinizle birlikte Cursor, Claude Code veya ChatGPT'ye yapıştırın. Aynı referans /llms.txt adresinde.

İstek gövdesi

model, jev-1.13 veya jev-latest olur. state bir dize, JSON nesnesi veya metin dizisidir; en fazla 60.000 karakter. questions, 1 ile 6 snake_case kimliğin haritasıdır. Kimlik yalnızca yanıtınızın döndüğü etikettir, soru değildir. Asıl soruyu instructions içine 1 ile 2.000 karakterlik metin olarak yazın.

{
  "model": "jev-1.13",
  "state": "Thanks for the refund. Still annoyed it took three emails.",
  "questions": {
    "sentiment": {
      "type": "choice",
      "instructions": "What is the overall sentiment of this message?",
      "criteria": {
        "positive": "Satisfied or thankful overall.",
        "mixed": "Both satisfied and unhappy.",
        "negative": "Unhappy overall."
      }
    },
    "needs_follow_up": {
      "type": "noul",
      "instructions": "Should a person reply to this message?"
    }
  }
}

Soru türleri

Noul

type noul yalnızca instructions ister. noul alanı ifadenin doğru olma olasılığıdır, 0 ile 1 arası. Ayrı bir confidence alanı yoktur. Bir noul sorusunda criteria gönderirseniz bu endpoint onu yok sayar.

Choice

type choice, instructions ve criteria ister: en fazla 300 karakterlik açıklamalara eşlenen 2 ile 8 snake_case seçenek kimliğinden oluşan bir nesne. Yanıtta choice, her seçeneğin probabilities değeri ve confidence vardır.

Score

type score, en düşük önce olmak üzere 2 ile 10 düzey açıklamasından oluşan sıralı bir dizi ister. Yanıtta score, legend, probabilities ve confidence vardır.

Yanıt

Başarılı gövdede model, soru kimliklerinizle anahtarlanmış answers, input_tokens ve output_tokens içeren usage ve credits_used vardır. jev-latest gönderseniz bile model jev-1.13 bildirir. Aşağıda hızlı başlangıç isteğine örnek bir yanıt var; usage çıkarıldı.

{
  "model": "jev-1.13",
  "answers": {
    "sentiment": {
      "type": "choice",
      "choice": "mixed",
      "probabilities": { "mixed": 0.79, "negative": 0.2, "positive": 0.01 },
      "confidence": 0.61
    },
    "needs_follow_up": { "type": "noul", "noul": 0.83 }
  },
  "credits_used": 1
}

Olasılıkları ve confidence’ı okumak

Noul, instructions içindeki ifadenin doğru olma olasılığıdır. Choice ve Score, her seçenek veya düzey için bir olasılık ile confidence döner.

İkinci sıra, insana devretme sinyalidir. confidence düşükse veya iki seçenek yakınsa vakayı bir kişiye verin ya da daha somut bir soru daha sorun. Bu yakın vakalara bakmadan eşiği düşürmeyin.

Limitler

TypeSafe’in API’sinden farklar

TypeSafe AI, Jev’i POST https://api.typesafe.ai/v1/systemone üzerinde bir TypeSafe anahtarıyla sunar ve girdi token’ı başına ücretlendirir. Buradaki istek gövdesi aynı şekle sahiptir: model, state ve noul, choice veya score tipinde questions. Değişenler:

• Yol ve anahtar: jev-api.org üzerinde POST /api/v1/decisions, anahtar bu sitenin panosundan. TypeSafe anahtarları burada çalışmaz, bu sitenin anahtarları da TypeSafe’te çalışmaz.
• Model kimliği: jev-1.13 veya jev-latest gönderin. jev-1.13.0 gibi sürümlü bir kimlik 422 döner.
• Limitler: çağrı başına 1 ile 6 soru ve 2 ile 8 Choice seçeneği. TypeSafe 255’e kadar Choice seçeneğini belgeliyor.
• Alanlar: instructions metin olmalı ve her Choice seçeneğinin bir açıklaması olmalıdır. TypeSafe ayrıca nesne veya dizi instructions ile null seçenek açıklamalarını da kabul eder.
• Faturalama: başarılı çağrı başına 1 kredi, token sayısı ne olursa olsun.

Hatalar

• 401 — API anahtarı yok veya reddedildi.
• 402 — anahtar geçerli, bakiye bu çağrıyı karşılamaz. Upstream hatası kredi kullanmaz.
• 422 — gövde doğrulamadan geçmedi. Mesaj alanı söyler.
• 429 — karar hizmeti hız sınırında. Sonra yeniden deneyin.
• 502 — hizmet yanıt döndürmedi. Kredi kullanılmaz.