curl https://aireiter.com/api/v1/systemone \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "jev",
"input": {
"state": "The payment API timed out.",
"questions": {
"is_urgent": {
"type": "noul",
"instructions": "Does this need a person right now?"
}
}
}
}'
import os
import requests
response = requests.post(
"https://aireiter.com/api/v1/systemone",
headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
json={
"model": "jev",
"input": {
"state": "The payment API timed out.",
"questions": {
"is_urgent": {
"type": "noul",
"instructions": "Does this need a person right now?",
}
},
},
},
)
print(response.json()["result"]["result"]["answers"])
const response = await fetch("https://aireiter.com/api/v1/systemone", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "jev",
input: {
state: "The payment API timed out.",
questions: {
is_urgent: {
type: "noul",
instructions: "Does this need a person right now?",
},
},
},
}),
});
const data = await response.json();
console.log(data.result.result.answers);
{
"result": {
"state": "Completed",
"result": {
"model": "jev-1.14.0",
"answers": {
"is_urgent": {
"type": "noul",
"noul": 0.49
}
},
"usage": {
"input_tokens": 280,
"output_tokens": 23
}
}
},
"success": true,
"errors": [],
"messages": []
}
Jev
Jev 의사결정 인터페이스
- 동기식 의사결정 인터페이스이며, 채팅 인터페이스가 아니고 스트리밍 출력을 지원하지 않습니다
- 본문 자료
state와 여러 판단 문항questions를 제출하면 한 번의 응답으로 각 문항의 확률, 선택지, 점수 또는 이미지 내 위치를 반환합니다 - 이미지 입력 및 Box 위치 지정 문항(Beta)을 지원합니다
- 호출 시 모델명에
jev를 입력하세요
POST
/
api
/
v1
/
systemone
curl https://aireiter.com/api/v1/systemone \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "jev",
"input": {
"state": "The payment API timed out.",
"questions": {
"is_urgent": {
"type": "noul",
"instructions": "Does this need a person right now?"
}
}
}
}'
import os
import requests
response = requests.post(
"https://aireiter.com/api/v1/systemone",
headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
json={
"model": "jev",
"input": {
"state": "The payment API timed out.",
"questions": {
"is_urgent": {
"type": "noul",
"instructions": "Does this need a person right now?",
}
},
},
},
)
print(response.json()["result"]["result"]["answers"])
const response = await fetch("https://aireiter.com/api/v1/systemone", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "jev",
input: {
state: "The payment API timed out.",
questions: {
is_urgent: {
type: "noul",
instructions: "Does this need a person right now?",
},
},
},
}),
});
const data = await response.json();
console.log(data.result.result.answers);
{
"result": {
"state": "Completed",
"result": {
"model": "jev-1.14.0",
"answers": {
"is_urgent": {
"type": "noul",
"noul": 0.49
}
},
"usage": {
"input_tokens": 280,
"output_tokens": 23
}
}
},
"success": true,
"errors": [],
"messages": []
}
Authorizations
string
필수
API 키, Bearer Token 형식API Key 발급:API Key 관리 페이지에 접속하여 API Key를 확인하세요
Authorization: Bearer YOUR_API_KEY
Body
string
필수
모델 이름입니다.
jev로 고정하여 입력합니다.응답의 result.result.model은 업스트림에서 실제로 사용된 버전 번호(예: jev-1.14.0)입니다. 이 필드는 업스트림에서 반환되므로 요청에 버전 번호를 입력하지 마세요.object
필수
판단 내용입니다.
state, questions를 포함하며 이미지가 있는 경우 assets를 추가합니다.표시 필드 설명
표시 필드 설명
string | object | array
필수
판단할 자료입니다. 한 문장일 수도 있고 객체나 배열일 수도 있습니다. 판단을 완료하는 데 필요한 데이터만 넣고, API Key, 비밀번호 등 민감한 정보는 넣지 마세요.이미지가 포함된 경우
state에 이미지 참조명을 작성합니다(예: { "photo": "img-7f3a91" }). 참조명은 assets의 키에 해당합니다.object
이미지 테이블(Beta)입니다. 키는 참조명이고 값은 이미지 객체입니다. 이미지가 없으면 전달하지 않습니다.참조명은 순수 텍스트로 일치되며,
state, 문제의 instructions 또는 criteria 내 임의의 문자열에 작성할 수 있습니다. 모델은 해당 위치에서 이 이미지를 확인합니다. 참조명은 본문 텍스트와 겹치지 않는 문자열을 선택해야 하며, 이미지마다 UUID를 사용하는 것을 권장합니다. 각 참조명은 요청에 최소 한 번 이상 나타나야 합니다.object
필수
문제 테이블이며 비어 있을 수 없습니다. 키 이름은 직접 지정하며, 각 문제는 하나의 객체입니다.각 문제에는
type과 instructions가 있어야 합니다.noul— 진위형(OX) 문제. 0에서 1 사이의 ‘예’ 확률을 나타내는noul을 반환합니다.criteria는 선택 사항이며 형태는{ "true": "어떠한 경우에 참인지", "false": "어떠한 경우에 거짓인지" }입니다.choice— 단일 선택형.criteria는 필수이며 ‘옵션명 → 설명’ 형태의 객체입니다. 반환되는choice는 선택된 옵션명입니다.score— 점수 매기기.criteria는 필수이며 낮은 순에서 높은 순으로 정렬된 최소 2개 이상의 항목으로 구성된 배열입니다. 반환되는score는 어느 단계에 해당하는지 나타내는 숫자이며, 첫 번째 항목은 0이고 소수일 수 있습니다. 예를 들어 3단계인 경우1.99는 거의 세 번째 항목에 해당함을 나타냅니다.box— 이미지 내 위치 지정(Beta). 이미지가 반드시 포함되어야 하며criteria는 허용되지 않습니다.instructions에는 무엇을 찾는지, 어느 이미지에 있는지를 작성합니다(예:"the car in `photo`"). 대상을 둘러싼 사각형을 반환합니다.
noul, choice, score, box를 동시에 포함할 수 있습니다. stream은 전달하지 마세요. 본 인터페이스는 완전한 JSON을 한 번만 반환합니다.
Response
응답 본문은 업스트림 원본 JSON이며, 본 API에서는 수정하지 않습니다. 판단 결과는result.result.answers에 있습니다.
boolean
이번 요청의 성공 여부
array
오류 목록입니다. 성공 시 빈 배열입니다
array
추가 안내 메시지입니다. 메시지가 없을 경우 빈 배열입니다
object
업스트림 실행 결과
표시 필드 설명
표시 필드 설명
string
실행 상태입니다.
Completed는 완료되었음을 나타냅니다object
모델 응답
표시 필드 설명
표시 필드 설명
string
업스트림에서 실제로 사용된 버전 번호입니다 (예:
jev-1.14.0)object
각 문항의 결과입니다. 키 이름은 요청 내 문항 이름과 일치합니다.
noul:{ "type": "noul", "noul": 0.49 }.0.8이상은 ‘예’,0.2이하는 ‘아니오’로 볼 수 있으며,0.5에 가까우면 불확실함을 의미합니다.choice:choice는 선택된 옵션명,probabilities는 각 옵션의 확률,confidence는 신뢰도입니다.score:score는 점수이며,legend는 등급 인덱스를 제출한 문구로 다시 매핑합니다.box:box는{ "top", "bottom", "left", "right" }4개의 변으로, 값은 0에서 1 사이이며 이미지의 높이와 너비에 대한 상대적 비율입니다 (원점은 좌측 상단).confidence는 신뢰도입니다. 박스를 그릴 때는 각 변에 이미지의 픽셀 너비와 높이를 곱합니다.
使用示例
curl https://aireiter.com/api/v1/systemone \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "jev",
"input": {
"state": "The payment API timed out.",
"questions": {
"is_urgent": {
"type": "noul",
"instructions": "Does this need a person right now?"
}
}
}
}'
import os
import requests
response = requests.post(
"https://aireiter.com/api/v1/systemone",
headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
json={
"model": "jev",
"input": {
"state": "The payment API timed out.",
"questions": {
"is_urgent": {
"type": "noul",
"instructions": "Does this need a person right now?",
}
},
},
},
)
print(response.json()["result"]["result"]["answers"])
const response = await fetch("https://aireiter.com/api/v1/systemone", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "jev",
input: {
state: "The payment API timed out.",
questions: {
is_urgent: {
type: "noul",
instructions: "Does this need a person right now?",
},
},
},
}),
});
const data = await response.json();
console.log(data.result.result.answers);
{
"result": {
"state": "Completed",
"result": {
"model": "jev-1.14.0",
"answers": {
"is_urgent": {
"type": "noul",
"noul": 0.49
}
},
"usage": {
"input_tokens": 280,
"output_tokens": 23
}
}
},
"success": true,
"errors": [],
"messages": []
}
다중 질문 예시
choice와 score는 noul과 함께 동일한 요청에 포함할 수 있습니다.
{
"model": "jev",
"input": {
"state": {
"ticket": "결제 인터페이스 간헐적 타임아웃 발생, 데이터베이스 커넥션 풀 거의 고갈."
},
"questions": {
"next_action": {
"type": "choice",
"instructions": "가장 안전한 다음 조치 선택",
"criteria": {
"rollback": "최근 변경 사항 롤백",
"observe": "지속적인 관찰 및 로그 샘플링"
}
},
"risk": {
"type": "score",
"instructions": "이번 장애의 위험도 평가",
"criteria": ["낮음", "중간", "높음", "매우 높음"]
},
"escalate": {
"type": "noul",
"instructions": "수동 에스컬레이션 필요 여부"
}
}
}
}
图片与 Box 示例（Beta）
이미지는assets에 배치하고, state는 참조 이름으로 이를 가리킵니다. 질문에서는 `photo`로 이 이미지를 지칭합니다. 아래 예시는 ‘이미지에 차가 있는지’와 ‘차가 어디에 있는지’를 동시에 질문합니다.
{
"model": "jev",
"input": {
"state": { "photo": "img-7f3a91" },
"assets": {
"img-7f3a91": {
"type": "image",
"format": "jpg",
"data_base64": "/9j/4AAQSkZJRg..."
}
},
"questions": {
"has_car": {
"type": "noul",
"instructions": "Is there a car in `photo`?"
},
"car": {
"type": "box",
"instructions": "the car in `photo`"
}
}
}
}
answers:
{
"has_car": { "type": "noul", "noul": 0.97 },
"car": {
"type": "box",
"box": { "top": 0.24, "bottom": 0.81, "left": 0.15, "right": 0.74 },
"confidence": 0.74
}
}
noul을 하나 추가하고 noul이 매우 낮으면 이 박스를 무시하세요.
이미지 요구사항
| 항목 | 제한사항 |
|---|---|
| 형식 | PNG 또는 JPEG 정적 이미지, 애니메이션 이미지는 지원하지 않음. WebP, GIF, HEIC 등은 먼저 PNG 또는 JPEG로 변환해야 함 |
| 단일 이미지 크기 | 디코딩 후 16 MiB 이하 |
| 너비, 높이 | 각 변 280~1568 픽셀, 범위를 벗어나면 즉시 오류가 발생하며 자동으로 크기가 조절되지 않음 |
| 요청 본문 | JSON 및 base64 포함 32 MiB 이하 |
- 전송 전에 긴 변을 1568 픽셀 이하로 줄이세요. 업스트림에서 EXIF를 제거하며 EXIF 방향에 따라 회전하지 않으므로, 휴대폰 사진은 먼저 픽셀 자체의 방향을 바로잡아 주세요.
- 이미지는 입력 토큰으로 환산되어
usage.input_tokens에 합산되며, 컨텍스트 창도 차지합니다. 약 800 픽셀의 이미지는 약 1500 tokens입니다. - 요청 중 유효하지 않은 이미지가 하나라도 있으면 전체 요청이 실패하며, 부분적인 결과는 반환되지 않습니다.
注意事项
- 본 인터페이스는 채팅 인터페이스가 아니므로
messages를 전달할 수 없으며,stream도 전달할 수 없습니다. - 이미지 입력과 Box 문제는 현재 Beta이며, 요청 형식, 결과 및 제한 사항은 버전에 따라 변경될 수 있어 프로덕션 의사결정에 직접 사용하는 것은 권장하지 않습니다.
- 컨텍스트 창은 32000 tokens입니다.
- 비즈니스 실패 시 HTTP 상태 코드가 여전히 200일 수 있으므로
success와errors를 함께 확인해 주세요. 인증 실패 시401을 반환하고,model누락 또는 유효하지 않은 JSON의 경우400을 반환하며, 모델이 존재하지 않을 경우404를 반환합니다.