Jev 시작하기

코드 없이 시작하기

개인 API 키를 제공하지 않고 이 사이트의 독립 무료 데모에서 자신의 글과 질문을 먼저 체험할 수 있습니다. 예/아니요 기준을 설정하거나 선택지 2–6개를 정의하세요. Jev를 자신의 앱에 연결하려면 아래에 별도로 안내된 TypeSafe 공식 계정 및 API 이용 절차를 따르세요.

데모는 글, 질문, 기준, 선택지를 합쳐 최대 10,000자까지 허용하며 Unicode 코드 포인트로 계산합니다. 이는 사이트 이용 한도이지 Jev의 컨텍스트 창이 아닙니다. 실시간 검사는 사람 확인이 필요할 수 있고 사용량이나 예산 한도에 도달하면 중단됩니다. 템플릿을 불러오는 것만으로 실행되거나 모델 결과가 미리 채워지지는 않습니다.

맞춤 편집기 열기 · 피드백 분류 템플릿 불러오기

1. 적절한 이용 경로부터 확인하기

2026년 9월 17일 기준으로 TypeSafe의 공개 사이트에는 대기자 명단이 안내되어 있습니다. 공식 빠른 시작 안내는 Playground와 API 사용법을 제공합니다. 문서 페이지를 열 수 있다고 해서 모든 계정에 모델 이용 권한이 있는 것은 아닙니다.

• 이용 권한이 없다면: TypeSafe 공식 웹사이트의 대기자 명단에 등록하세요. 이 사이트는 계정을 승인하거나 API 키를 발급할 수 없습니다.
• 계정에 이용 권한이 있다면: TypeSafe 콘솔을 열고 Playground 또는 API 키 발급 절차를 따르세요.

계정의 이용 가능 여부와 온보딩 절차는 바뀔 수 있습니다. 본인의 상태는 공식 콘솔에서 확인하세요.

2. 범위가 좁은 질문 하나 시도하기

Playground에서 짧은 가상의 메시지를 입력하고 Noul 질문 하나를 해 보세요. 예를 들어 전화를 요청하는 메시지를 사용한 뒤, 다시 전화해 달라는 요청이 명시되어 있는지 물어보세요. 다음에는 입력을 막연한 도움 요청으로 바꾸고 결과가 달라지는지 관찰하세요.

이는 탐색 연습이지 정확도 시험이 아닙니다. 대조적인 두 예제로 시작하면 질문이 의도한 차이를 잘 표현하고 있는지 살펴볼 수 있습니다.

Jev는 제공된 정보를 state라고 부릅니다. 문자열, JSON 객체, 배열을 사용할 수 있습니다. 더 복잡한 과제에서는 이름이 있는 필드를 사용해 메시지, 보조 기록, 관련 정책을 구분하세요. 입력 형식

curl --fail-with-body --silent --show-error \
  https://api.typesafe.ai/v1/systemone \
  -H "Authorization: Bearer $TYPESAFE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "model": "jev-latest",
  "state": "Please call me tomorrow morning to discuss the setup.",
  "questions": {
    "callback_requested": {
      "type": "noul",
      "instructions": "Does the sender explicitly ask for a phone call?"
    }
  }
}
JSON

4. 과제에 필요할 때만 구조 추가하기

다음 단계가 분류에 따라 달라지면 Choice, 의미 있는 순서형 수준이 있으면 Score, 예·아니요 확률이 필요하면 Noul을 사용하세요. 같은 state에 대한 독립적인 질문은 한 요청에 함께 넣고, 결과 처리는 애플리케이션에서 맡으세요.

구체적인 다음 단계로 고객 지원 티켓 예제를 따라가 보세요. 문서에 공개된 출력이 어떻게 전달 경로 제안으로 바뀌는지 보여 줍니다.

5. 이용 권한 문제와 요청 문제를 구분해 해결하기

콘솔 로그인이 완료되지 않으면 공식 콘솔의 일반 진입 경로에서 다시 열고 이용 권한이 있는 계정을 사용 중인지 확인하세요. 브라우저 로그인 문제를 해결하려고 API 요청을 계속 바꾸지 마세요. 로그인에 성공했다고 API 키가 발급되었다는 뜻도 아닙니다. 계정 관련 도움이 필요하면 TypeSafe의 공식 지원 경로를 이용하고, 공개 보고에는 키나 로그인 링크를 절대 포함하지 마세요.

HTTP 요청에서는 질문을 바꾸기 전에 상태 코드와 오류 본문을 확인하세요.

이 코드들은 API 참조 문서에 설명되어 있습니다. 429나 529에는 지수 백오프를 사용하세요. SDK는 기본적으로 이미 재시도하므로, 바깥에 별도 재시도 루프를 추가하기 전에 그 시도 횟수까지 고려하세요.

시간 초과는 부정 답변과 다릅니다. 전체 처리 기한과 최대 시도 횟수를 정하고, 해결되지 않은 작업은 검토 경로로 보내세요. 모델 요청을 재시도하더라도 담당자 배정 생성 같은 후속 작업이 반복 실행되지 않도록 하세요.

6. 예상 밖의 답 조사하기

이 방법들은 편집진이 제안하는 디버깅 절차입니다. Score 가이드는 소수 값을 설명하며, 한계 페이지에는 현재 공급업체의 주의 사항과 별도로 구분한 커뮤니티 관찰 내용이 연결되어 있습니다.

jev-latest 별칭은 더 새로운 모델을 가리키게 될 수 있습니다. 시험할 때는 반환된 모델 식별자를 기록하고, 재현성이 중요하다면 계정에서 지원하는 버전 고정 식별자를 사용하세요. 모델 별칭

7. 첫 작업 흐름을 실제로 사용할 준비가 되었는지 판단하기

자동 동작을 활성화하기 전에 예상 판단을 담은 작은 예제 모음을 유지하고, 오류를 검토하며, 해당 작업 흐름에 맞는 임계값을 선택하세요. 요금 계산기로 입력 토큰 지출을 예상하고, 비교 가이드로 다른 도구에 맡길 부분을 결정하세요.