Jev 사용법

여기서 테스트한 뒤 키 만들기

jevmodel.org 플레이그라운드에서 범위가 좁은 판단 하나를 테스트하세요. 결과가 유용하면 로그인해 대시보드를 열고 API 키를 만든 뒤 서버의 JEVMODEL_API_KEY로 저장합니다.

답의 집합은 작고 안정적으로 유지하세요. 필드 이름은 모호한 주제가 아니라 코드가 따라갈 분기 이름으로 정합니다.

import os
import requests

response = requests.post(
    "https://jevmodel.org/v1/systemone",
    headers={"Authorization": f"Bearer {os.environ['JEVMODEL_API_KEY']}"},
    json={
        "state": "I was charged twice. Please fix this ASAP.",
        "model": "jev-latest",
        "questions": {
            "category": {
                "type": "choice",
                "instructions": "What is this ticket about?",
                "criteria": {"billing": "payments", "technical": "broken product", "other": "other"},
            },
        },
    },
    timeout=15,
)
print(response.json())

HTTP 규격

이미 이 요청을 보내는 저장소 ↗는 Jev 프로젝트 디렉터리에 있습니다.

https://jevmodel.org/v1/systemone으로 POST 요청을 보냅니다. model은 jev-latest 또는 고정 버전을 사용합니다. state는 직렬화 후 8,000자까지, questions는 이름이 붙은 choice, score, noul 질문 1~8개를 담는 객체입니다.

• jevmodel.org 엔드포인트는 API 키당 분당 120개 요청을 허용합니다.
• 성공한 요청마다 입력 토큰이 차감됩니다. 업스트림 오류는 환불되며 재시도할 때 Idempotency-Key 헤더를 권장합니다.
• 코드에 신뢰도 임계값을 두세요. Jev는 분기를 쉽게 만들지만 위험을 없애지는 않습니다.

curl -X POST https://jevmodel.org/v1/systemone \
  -H "Authorization: Bearer $JEVMODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-latest",
    "state": "Customer: I was charged twice and I am furious.",
    "questions": {
      "topic": {
        "type": "choice",
        "instructions": "What is the issue about?",
        "criteria": { "billing": "money problems", "bug": "broken product" }
      },
      "urgent": {
        "type": "noul",
        "instructions": "Escalate to a human now?"
      }
    }
  }'

답을 받은 뒤에 할 일

애플리케이션 코드에서 분기하세요. topic이 billing이고 escalate.noul이 임계값을 넘으면 사람에게 넘기고, 신뢰도가 낮으면 같은 상태를 더 큰 모델이나 검토자에게 보냅니다. 입력, 출력, 버전, 이후 결과를 기록해야 Jev가 실제로 워크플로를 돕는지, 단지 단호해 보이기만 하는지 알 수 있습니다.