Nace.AI: Drex v1.5
Drex 1.5는 제공된 텍스트나 JSON을 유형이 지정된 질문에 비추어 평가하고 확률, 선택된 레이블 또는 소수점 루브릭 점수를 반환합니다. Nace.AI는 분류, 라우팅, 우선순위 지정을 위한 텍스트 전용 결정과 버전별 상태(state) 및 요청 한도를 문서화하고 있습니다.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
Drex 1.5는 Nace.AI의 텍스트 결정 모델입니다. 제공된 사실을 폐쇄형 질문에 비추어 평가하고, 열린 서술형 응답 대신 유형이 지정된 수치 답변을 반환합니다. 요청은 하나의 상태(state)와 이름이 붙은 질문들을 결합하며, 결과는 같은 질문 이름으로 각 답을 식별합니다. 덕분에 워크플로는 구체적인 범주, 확률, 루브릭상의 위치를 받아 활용할 수 있고, 그 결과에 따른 동작은 애플리케이션이 맡습니다.
상태 준비하기
상태는 모든 질문이 다루는 정보입니다. Drex는 JSON 문자열, 객체, 배열, 숫자, 불리언, null을 받으며, state 필드는 필수입니다. null도 제작사의 검증을 통과하지만 의미 있는 근거를 제공하세요. 문자열은 메시지, 문서, 녹취록에 적합하고, 객체는 이미 필드로 정리된 사실에 적합합니다. 결정에 영향을 주는 정보는 유지하고, 자료가 길면 관련 없는 필드는 생략하세요. 표현 방식을 바꾸면 답이 달라질 수 있으므로, 확률 임계값을 해석할 때는 입력 형식을 일정하게 유지하세요.
Drex 1.5는 텍스트만 읽습니다. 문서화된 인터페이스는 상태나 질문 안에 포함된 이미지, 오디오, 동영상, PDF 콘텐츠를 거부하며, 인코딩된 미디어와 미디어 콘텐츠 객체도 마찬가지입니다. 이러한 자료를 근거로 사용하려면 먼저 캡션, 인식된 문서 텍스트, 녹취록을 준비하세요. 텍스트로 된 주소는 가져온 문서나 이미지가 아니며, 모델은 그것을 열 수 없습니다. 고객 지원 요청이라면 유용한 상태는 실제 메시지와 관련 맥락이지, 모델이 받지 않은 자료에 대한 참조가 아닙니다.
예/아니요 확률, 선택, 점수
noul 질문은 조건이 성립하는지 묻고, 예일 확률의 추정치를 0에서 1 사이의 숫자로 반환합니다. 질문은 비어 있지 않은 지시문이나, 비어 있지 않은 참/거짓 기준을 최소 하나 이상 사용해 정의하세요. 예를 들어 메시지가 고장 난 기능을 보고하는지 묻고, 느린 동작도 고장으로 볼지 정의할 수 있습니다. Drex는 예/아니요를 가르는 기본 기준값을 두지 않으며, 확률을 어떻게 해석할지는 결과를 사용하는 워크플로가 정합니다.
선택(choice) 질문은 순서가 없는 집합에서 제공된 레이블 하나를 고르고, 모든 레이블에 대한 확률을 반환합니다. 기준은 반환되는 레이블을 키로 하는 객체이며, 각 설명은 문자열 또는 null입니다. 짧고 안정적인 키를 사용하고 범주 경계를 명확히 설명하세요. 예시 라우팅 작업으로 접근 문제, 제품 결함, 일반 질문을 구분하고, 어느 쪽에도 맞지 않는 메시지를 위한 기타(other) 범주를 둘 수 있습니다. 선택된 레이블은 라우팅에 유용하고, 분포는 두 선택지를 구분하기 어려운 사례를 찾는 데 도움이 됩니다.
점수(score) 질문은 순서가 있는 단계 레이블 배열을 사용합니다. 인덱스는 0부터 시작하며, 반환되는 점수는 각 단계 인덱스에 해당 확률을 곱한 값의 합입니다. 따라서 점수는 이름 붙은 단계 사이의 값이 될 수 있습니다. 심각도 척도라면 외관상 문제, 우회 방법이 있는 문제, 작업이 완전히 막힌 경우를 무엇으로 구분하는지 정의하세요. 결과에는 기대 점수와 함께 단계 범례와 확률이 포함됩니다. 평균이나 추세에는 소수점 점수를 유지하세요. 가장 가능성 높은 단계를 고르는 것과 기대 점수를 반올림하는 것은 서로 다른 질문에 대한 답입니다.
공유 근거와 결과 읽기
제작사는 같은 상태에 대해 1개에서 512개까지의 질문을 허용합니다. 각 질문에는 category나 severity처럼 비어 있지 않고 의미 있는 식별자를 붙여, 번호가 매겨진 질문을 찾아보지 않고도 해당 답을 이해할 수 있게 하세요. 여러 요구 사항을 하나의 모호한 기준으로 합치지 말고, 독립적인 관심사는 각각 별도의 질문으로 나누세요. 하나의 메시지로 범주 선택, 심각도 점수, 조건 확인을 모두 수행할 수 있으며, 각 질문은 고유한 의미를 유지합니다.
선택 및 점수 답변에는 확률 분포와 별도로 신뢰도가 포함됩니다. 제작사는 신뢰도를 가장 높은 선택지 확률과 명시적으로 구분하므로, 한쪽에서 다른 쪽을 계산하지 마세요. 예/아니요 결정에서는 선택된 결과와 함께 원시 확률을 보존하세요. 불확실한 선택에서는 이긴 레이블만으로 확실하다고 여기지 말고 경쟁하는 확률들을 살펴보세요. 검토 임계값은 잘못된 양성 또는 음성 결과가 낳는 영향을 기준으로 정하고, 대표적인 레이블 지정 사례로 평가하세요.
버전과 크기 한도
Drex 1.5는 상태 허용량 131,072토큰과 행(row) 허용량 139,264토큰을 문서화하고 있습니다. 행 허용량은 상태에 지시문과 선택지를 포함한 가장 긴 단일 질문을 더한 크기에 해당하며, 요청에 포함된 모든 질문의 합이 아닙니다. 직렬화된 상태와 질문은 합쳐서 1,048,576 UTF-8 바이트 안에도 들어가야 합니다. 요청이 바이트 한도를 충족하면서도 토큰 한도를 초과할 수 있습니다. 이전 1.0 에디션은 상태와 행 모두에 대해 32,768토큰을 별도로 명시하므로, 그 한도를 1.5에 그대로 적용해서는 안 됩니다.
Nace는 drex-v1.5를 버전이 고정된 제작사 식별자로, drex-latest를 가리키는 대상이 바뀌는 별칭으로 문서화합니다. 워크플로가 특정 한도에 의존한다면 의도한 에디션을 명시적으로 지정하세요. 형식이 잘못된 질문, 누락된 상태, 크기를 초과한 입력은 검증 문제이므로, 범주를 바꾸거나 답을 추측할 것이 아니라 입력을 바로잡아야 합니다. 관찰 가능한 근거를 중심으로 기준을 준비하고, 유형이 지정된 결과, 원래 사실, 질문 정의를 함께 보존하세요. 그러면 확률을 보장된 판정으로 오인하지 않고 결정을 라우팅, 우선순위 지정, 검토에 활용할 수 있습니다.
Ailoot Ultra · System One POST /v1/systemone nace-ai/drex-v1.5
nace-ai/drex-v1.5시작하기
Drex 1.5는 제공된 텍스트나 JSON을 유형이 지정된 질문에 비추어 평가하고 확률, 선택된 레이블 또는 소수점 루브릭 점수를 반환합니다. Nace.AI는 분류, 라우팅, 우선순위 지정을 위한 텍스트 전용 결정과 버전별 상태(state) 및 요청 한도를 문서화하고 있습니다.
- 허용 입력
- 텍스트
- 결과
- decisions
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · System One POST /v1/systemone
- 입력
text- 출력
decisions- 출력 형식
- json
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 nace-ai/drex-v1.5 | 기본값— |
필드provider | 유형schema | 요건선택 사항 | 값과 한도 | 기본값— |
필드questions | 유형object | 요건필수 | 값과 한도 | 기본값— |
필드session_id | 유형string | 요건선택 사항 | 값과 한도 | 기본값— |
필드state | 유형schema | 요건필수 | 값과 한도 | 기본값— |
필드trace | 유형schema | 요건선택 사항 | 값과 한도 | 기본값— |
필드user | 유형string | 요건선택 사항 | 값과 한도 | 기본값— |
필드questions.<id>.type | 유형string | 요건필수 | 값과 한도 noul, choice, score | 기본값— |
필드questions.<id>.instructions | 유형string|object|array | 요건필수 | 값과 한도 | 기본값— |
필드questions.<id>.criteria | 유형object|array | 요건선택 사항 | 값과 한도 조건: choice/score: 필수; noul: 선택 사항. choice의 criteria는 객체이며, score는 minItems1인 배열입니다. | 기본값— |
필드questions.<id>.criteria.true | 유형string|object|array | 요건필수 | 값과 한도 적용 조건: noul 조건 객체가 제공됨 | 기본값— |
필드questions.<id>.criteria.false | 유형string|object|array | 요건필수 | 값과 한도 적용 조건: noul 조건 객체가 제공됨 | 기본값— |
입력 자료 조합
noul · 필수: state, questions.<id>.type=noul, questions.<id>.instructions
choice · 필수: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · 필수: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수content_type | 명세application/json |
매개변수required | 명세model, state, questions |
매개변수material_types | 명세text |
매개변수optional_controls | 명세provider, session_id, trace, user |
매개변수multimodal_input_binding | 명세null |
수명 주기: synchronous
정확한 모델 ID를 전송하고 네이티브 응답 전체를 보존하세요.
요금
요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.
- 빠른 모드
- 미지정 빠른 모드를 선택한 경우
- Flex 모드
- 미지정 flex 모드를 선택한 경우
- 최대 추론 수준
- 미지정 최대 추론 수준에 default 조정값을 적용하는 경우
Ailoot 요금
설정별 가격
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.
| 설정 | 요금표 | 컨텍스트 토큰 수 초과 기준 | 컨텍스트 토큰 수 이하 기준 | 요금 |
|---|---|---|---|---|
| 설정토큰의 기본 단가 | 요금표기본 요금 | 컨텍스트 토큰 수 초과 기준— | 컨텍스트 토큰 수 이하 기준상한 없음 | 요금 입력 · 입력 토큰 $0.00008 / 1K 토큰 출력 · 출력 토큰 $0 / 1K 토큰 입력 · 캐시 읽기 — / 1K 토큰 입력 · 캐시 쓰기 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 — / 1K 토큰 |
| 설정요청 길이 구간 1 | 요금표— | 컨텍스트 토큰 수 초과 기준0 | 컨텍스트 토큰 수 이하 기준상한 없음 | 요금 입력 · 입력 토큰 $0.00008 / 1K 토큰 출력 · 출력 토큰 $0 / 1K 토큰 입력 · 캐시 읽기 — / 1K 토큰 입력 · 캐시 쓰기 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 — / 1K 토큰 |
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
요청 예제
Ailoot Ultra · System One
{
"model": "nace-ai/drex-v1.5",
"questions": {
"is_bug": {
"criteria": {
"false": "The customer is asking a question or requesting a feature.",
"true": "The customer describes broken or unexpected product behavior."
},
"instructions": "Is the customer reporting a software defect?",
"type": "noul"
},
"team": {
"criteria": {
"account": "Login, permissions, or profile issues.",
"frontend": "Rendering, layout, or browser compatibility issues.",
"payments": "Checkout, billing, or payment processing issues."
},
"instructions": "Which team should own this ticket?",
"type": "choice"
},
"urgency": {
"criteria": [
"Can wait for the next release",
"Should be fixed this week",
"Blocking revenue right now"
],
"instructions": "How urgent is this ticket?",
"type": "score"
}
},
"state": {
"customer_tier": "enterprise",
"ticket": "My checkout page shows a blank screen after I click Pay. I have tried two browsers."
}
}set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"
export AILOOT_REQUEST_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))
if not isinstance(p,dict): raise SystemExit('Request must be a JSON object')
p['model']='nace-ai/drex-v1.5'
Path('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/systemone \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))
PY_RESULT
결과 수신 및 저장
Ailoot Ultra · System One
json
완료된 결과 모두 보관
반환된 완전한 응답, 파일, 콘텐츠 부분을 모두 보관하세요.
제공된 모든 질문 ID별 답변의 정확한 유형, noul/choice/score 값, 신뢰도, 확률 및 범례가 보존됩니다. 원본 JSON 전체는 정산이 끝난 후에만 저장되고 반환됩니다.
원래 응답을 확인해야 할 경우
원래 작업과 전체/부분 응답을 보존하세요. POST를 재전송하지 마세요.
응답 필드
| 필드 | 유형 |
|---|---|
필드model | 유형string |
필드id | 유형string |
필드provider | 유형string |
필드answers.<id>.type | 유형string |
필드answers.<id>.noul | 유형number |
필드answers.<id>.choice | 유형string |
필드answers.<id>.score | 유형number |
필드answers.<id>.confidence | 유형number |
필드answers.<id>.probabilities | 유형object |
필드answers.<id>.legend | 유형object |
필드usage.input_tokens | 유형integer |
필드usage.output_tokens | 유형integer |
필드usage.cost | 유형number |
오류와 다음 단계
| 응답 | 조건 | 다음 단계 |
|---|---|---|
응답400 · invalid_request_error | 조건필수 필드, 표현 형식 또는 값이 유효하지 않음 | 다음 단계표시된 요청 필드를 수정하세요. |
별칭
모델 별칭
Ailoot Ultra nace-ai/drex-v1.5
메서드 경로 별칭
위에 표시된 메서드 경로를 사용하세요.
관련 호출용 ID
FAQ · Nace.AI: Drex v1.5
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/systemone·nace-ai/drex-v1.5:text→decisions- 요청은 어떤 필드를 사용하나요?
POST /v1/systemone·nace-ai/drex-v1.5:model,provider,questions,session_id,state,trace,user