Jev 시작하기: API 키, 무료 체험, 모든 이용 방법

Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing with 'invalid redirect'. I'm losing sales every hour this is down. Please help ASAP.

Jev를 이용하는 세 가지 방법

Jev는 TypeSafe의 System One 모델입니다. 공개 빌드는 jev-1.13.0 하나뿐이며, 다음 세 가지 방법으로 이용할 수 있습니다.

1. JevStation 가입 없는 체험: 브라우저에서 계정 없이, 프리셋 사용 사례만 이용할 수 있습니다.
2. JevStation 계정과 API 키: 50 크레딧 무료, 이후에는 일회성 크레딧 팩을 구매합니다.
3. TypeSafe 직접 이용: 모델 제공사의 자체 API이며 대기자 명단이 있습니다.

1. 플레이그라운드에서 JevStation 체험하기

절차. 플레이그라운드를 열고 위의 지원 티켓 분류 예시 같은 프리셋을 고른 뒤, 원하면 텍스트를 수정해 실행하세요.

요금. 무료입니다. IP 주소당 하루 3회 실행할 수 있습니다.

장점. 계정도, 카드도, 코드도 필요 없습니다. 실제 모델이 계산한 실제 확률을 몇 초 안에 확인할 수 있습니다.

단점. 질문은 프리셋에서 가져오며 바꿀 수 없고, 수정 가능한 텍스트는 2,000자까지입니다. Jev가 어떻게 답하는지 살펴보는 용도이지, 내 사용 사례를 테스트하는 용도는 아닙니다.

이런 분께 적합합니다. Jev를 더 자세히 살펴볼 가치가 있는지 판단하려는 분.

2. JevStation 계정과 API 키

절차. 가입한 뒤 설정 › API Keys를 열어 키를 만들고, 그 키로 POST https://jevstation.com/api/v1/systemone을 호출하세요. 같은 계정으로 플레이그라운드에서 직접 만든 질문도 사용할 수 있습니다.

요금. 신규 계정에는 30일간 유효한 50 크레딧이 무료로 지급되며, 카드나 제공사 키는 필요 없습니다. 이후 크레딧은 구독이 아니라 일회성 팩으로 판매됩니다. 5,000 크레딧에 $9.90, 12,000 크레딧에 $15.90이며 유효 기간은 24개월입니다. 표준 평가(state 최대 8,000자, 질문 최대 5개)는 1 크레딧입니다. 더 큰 평가(최대 24,000자, 질문 최대 12개)는 3 크레딧입니다. 실패한 평가는 자동으로 환불됩니다. 자세한 내용은 요금을 확인하세요.

장점. 대기자 명단이 없습니다. 토큰 단위가 아니라 평가 단위로 결제하므로, 모델이 텍스트를 어떻게 토큰화하든 요청 가격이 달라지지 않습니다. 질문 세트를 설계하는 플레이그라운드, 저장된 평가 스레드, 자동 환불도 함께 제공됩니다.

단점. 호출당 비용이 순수 토큰 요금보다 높습니다. 일반적인 평가의 Jev 정가 기준 비용은 약 $0.00002이지만, 1 크레딧은 소형 팩에서 $0.00198, 대형 팩에서 $0.00133입니다. 처리량은 계정별로 제한되며, 구매한 팩에 따라 한도가 올라갑니다. 현재 한도는 GET /api/v1/systemone으로 확인할 수 있습니다. 이 배포 환경은 모델 버전을 고정해 두므로 요청의 model 필드는 무시됩니다.

이런 분께 적합합니다. 지금 바로 Jev를 호출하고 싶은 개발자, API와 함께 플레이그라운드를 쓰고 싶은 팀, 사용량이 아주 많지 않은 모든 분.

3. TypeSafe 직접 이용

절차. TypeSafe 대기자 명단에 등록하세요(신규 가입을 받고 있는지는 TypeSafe에서 확인하세요). 승인되면 TypeSafe 키로 POST https://api.typesafe.ai/v1/systemone을 호출합니다. LangChain에서 연동을 공개하고 있으며, Python용은 langchain-typesafe, JavaScript용은 @langchain/typesafe입니다.

요금. 사용한 만큼 내는 종량제로, 입력 토큰 100만 개당 $0.042이고 출력 토큰은 무료입니다. 셀프서비스 요금제와 무료 사용량은 없습니다. 더 높은 한도나 데이터 보관 없음(zero data retention)은 TypeSafe 영업팀을 통해 진행합니다.

장점. 호출당 가격이 가장 낮고, 요청 제한이 가장 높으며(TypeSafe 공표 기준 분당 1,200건, 초당 250,000 토큰), jev-latest와 jev-preview 별칭을 포함해 모델 버전을 직접 제어할 수 있습니다.

단점. 이용을 시작하기까지 기다려야 합니다. 또한 TypeSafe는 요청 제한이 동적으로 조정되고 있으며 예고 없이 바뀔 수 있다고 밝히고 있습니다.

이런 분께 적합합니다. 접근 권한을 기다릴 수 있는 대량 프로덕션 워크로드.

JevStation API 호출하기

모든 예시는 위 체험에서 쓴 지원 티켓을 질문 두 개와 함께 보냅니다. $JEVSTATION_API_KEY는 직접 만든 키로 바꿔 넣으세요.

cURL

curl -X POST https://jevstation.com/api/v1/systemone \
  -H "Authorization: Bearer $JEVSTATION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "state": "I have been trying to connect my Stripe account for 3 days and it keeps failing with invalid redirect. I am losing sales every hour.",
    "questions": {
      "category": {
        "type": "choice",
        "instructions": "Which team should handle this support ticket?",
        "criteria": {
          "billing": "Payments, invoices, refunds or plan changes",
          "integrations": "Connecting or syncing a third-party service",
          "bug": "The product behaves incorrectly",
          "account": "Login, access or account settings"
        }
      },
      "churn_risk": {
        "type": "noul",
        "instructions": "Is the customer at risk of churning?"
      }
    }
  }'

Python (requests)

import os
import requests

resp = requests.post(
    "https://jevstation.com/api/v1/systemone",
    headers={"Authorization": f"Bearer {os.environ['JEVSTATION_API_KEY']}"},
    json={
        "state": "I have been trying to connect my Stripe account for 3 days "
                 "and it keeps failing with invalid redirect. I am losing sales every hour.",
        "questions": {
            "category": {
                "type": "choice",
                "instructions": "Which team should handle this support ticket?",
                "criteria": {
                    "billing": "Payments, invoices, refunds or plan changes",
                    "integrations": "Connecting or syncing a third-party service",
                    "bug": "The product behaves incorrectly",
                    "account": "Login, access or account settings",
                },
            },
            "churn_risk": {
                "type": "noul",
                "instructions": "Is the customer at risk of churning?",
            },
        },
    },
    timeout=30,
)
body = resp.json()
if body["code"] != 0:
    raise RuntimeError(body["message"])

data = body["data"]
print(data["answers"]["category"]["choice"], data["answers"]["category"]["confidence"])
print(data["answers"]["churn_risk"]["noul"])
print("credits left:", data["credits"]["remaining"])

Node (fetch)

const res = await fetch('https://jevstation.com/api/v1/systemone', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.JEVSTATION_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    state:
      'I have been trying to connect my Stripe account for 3 days and it keeps failing with invalid redirect. I am losing sales every hour.',
    questions: {
      category: {
        type: 'choice',
        instructions: 'Which team should handle this support ticket?',
        criteria: {
          billing: 'Payments, invoices, refunds or plan changes',
          integrations: 'Connecting or syncing a third-party service',
          bug: 'The product behaves incorrectly',
          account: 'Login, access or account settings',
        },
      },
      churn_risk: {
        type: 'noul',
        instructions: 'Is the customer at risk of churning?',
      },
    },
  }),
});

const body = await res.json();
if (body.code !== 0) throw new Error(body.message);

const { answers, credits } = body.data;
console.log(
  answers.category.choice,
  answers.churn_risk.noul,
  credits.remaining
);

응답 내용

응답은 봉투(envelope) 형식입니다. code는 성공하면 0, 오류가 나면 -1이고, message는 ok 또는 오류 메시지이며, 결과는 data 아래에 들어 있습니다. 아래 값은 형식만 보여 주는 예시이며 실제 수치는 다를 수 있습니다.

{
  "code": 0,
  "message": "ok",
  "data": {
    "model": "jev-1.13.0",
    "answers": {
      "category": {
        "type": "choice",
        "choice": "integrations",
        "probabilities": {
          "billing": 0.2,
          "integrations": 0.7,
          "bug": 0.08,
          "account": 0.02
        },
        "confidence": 0.6
      },
      "churn_risk": { "type": "noul", "noul": 0.8 }
    },
    "usage": { "input_tokens": 180, "output_tokens": 0 },
    "credits": { "charged": 1, "remaining": 199 },
    "latency_ms": 400
  }
}

Choice 답변에는 가장 가능성이 높은 선택지, 모든 선택지의 확률, 신뢰도 값이 담깁니다. Score 답변에는 설정한 레벨상의 값, 범례, 신뢰도가 담깁니다. Noul 답변은 0에서 1 사이의 단일 확률이며 신뢰도는 없습니다. 오류가 나면 실제 HTTP 상태 코드도 함께 설정됩니다. 키가 없거나 유효하지 않으면 401, 요청이 잘못되었거나 너무 크면 400 또는 413, 크레딧이 부족하면 402, 요청 제한에 걸리면 429, 평가가 실패하면 502이며 이 경우 크레딧은 환불됩니다. 모든 필드는 문서에서 확인할 수 있습니다.

Jev redeem code? 없지만 50 무료 크레딧을 받을 수 있습니다

무료 크레딧. JevStation의 모든 신규 계정에는 가입 시 30일간 유효한 50 크레딧이 지급되며, 카드도 코드 입력도 필요 없습니다. 표준 평가 50회에 해당하는 양입니다. 계정이 없어도 플레이그라운드에서 프리셋 사용 사례를 하루 3회 무료로 실행할 수 있습니다.

Redeem code. Jev redeem code는 없습니다. JevStation은 Jev 크레딧용 redeem code, 프로모션 코드, 쿠폰 코드를 발행하지 않으며 필요하지도 않습니다. 50 무료 크레딧은 계정과 함께 지급됩니다. 다른 사이트에서 JevStation의 Jev 크레딧을 받을 수 있다고 주장하는 코드는 저희가 발행한 것이 아닙니다. TypeSafe 직접 이용에는 무료 사용량이 전혀 없습니다.

가입하고 50 무료 크레딧 받기: 카드도 코드도 필요 없고, 첫 API 키는 약 1분이면 만들 수 있습니다.

구독. 구독은 없습니다. 크레딧은 일회성 팩(5,000 크레딧에 $9.90, 12,000 크레딧에 $15.90, 유효 기간 24개월)으로 판매하므로 해지해야 할 정기 결제가 없습니다. TypeSafe 직접 이용은 토큰 단위 종량제입니다. 비용 계산기는 요금에서 확인하세요.

한눈에 비교

API 키를 받고 첫 호출 보내기

1. 가입하기. /sign-up에서 계정을 만드세요. 30일간 유효한 50 크레딧이 무료로 지급됩니다.
2. 키 만들기. 설정 › API Keys를 열어 키를 생성하세요. 코드에 직접 쓰지 말고 JEVSTATION_API_KEY로 저장해 두세요.
3. 키 확인하기. 같은 Bearer 헤더로 GET https://jevstation.com/api/v1/systemone을 보내세요. 비용은 들지 않으며 요금제, 남은 크레딧, 요청 제한이 반환됩니다.
4. 첫 호출 보내기. 위의 예시 중 아무거나 실행하세요. 표준 평가이므로 1 크레딧이 사용됩니다.

코드를 작성하기 전에 플레이그라운드에서 먼저 질문을 설계해 보는 것이 좋습니다. 같은 규격으로 동작하므로, 거기서 보이는 답변이 곧 코드에서 받게 될 답변입니다. 질문을 작성하는 방법은 Jev가 답할 수 있는 질문 설계하기에서, 호출 한 번의 토큰 비용 내역은 Jev 평가 한 번에 드는 비용에서 다룹니다.

같은 키와 엔드포인트로 Cloudflare의 의사결정 모델 Clef도 실행할 수 있습니다. 요청에 "model": "clef-flash" 또는 "model": "clef"를 추가하세요. Clef를 이용하는 모든 방법은 How to get Clef(영어)에서, 어느 모델이 더 적합한지는 Jev vs Clef(영어)에서 확인하세요.