API 엔드포인트 URL
API Base URL과 Jev /v1/decisions, /v1/systemone 요청 형식, 채팅 API 비호환 및 convert_request_failed 해결 방법.
이 페이지에서는 지역별 접속 주소와 계정 및 잔액 관련 진입점을 한곳에 정리합니다.
1. 지역별 접속 주소
| 사용 지역 | 권장 Base URL | 설명 |
|---|---|---|
| 전 지역(중국 대륙 포함) | https://api.llm-token.cn/v1 | 글로벌 라우팅: 화둥·화난·홍콩·싱가포르·미국·독일 노드가 가장 빠른 경로를 자동 선택합니다. |
2. 계정 및 잔액 진입점
Jev 네이티브 결정 API: 채팅과 URL이 다릅니다
jev-latest는 일반 채팅이 아닌 네이티브 결정 프로토콜을 사용합니다. 게이트웨이와 TypeSafe 직접 연결은 URL과 API 키가 다릅니다.
| 연결 방식 | 전체 POST URL | API 키 |
|---|---|---|
| 권장 게이트웨이 | https://api.llm-token.cn/v1/decisions | LLM API Gateway 키 |
| 호환 게이트웨이 | https://api.llm-token.cn/v1/systemone | LLM API Gateway 키 |
| TypeSafe 직접 연결 | https://api.typesafe.ai/v1/systemone | TypeSafe 키 |
Base URL이 https://api.llm-token.cn/v1이면 /decisions 또는 /systemone만 추가하세요. /v1/v1/decisions로 만들지 마세요.
model, state, questions를 포함하세요. questions는 질문 ID를 키로 하는 객체이며, 각 질문에 type과 instructions가 필요합니다. choice의 criteria는 선택지 객체, score는 순서 있는 배열입니다. noul은 예/아니요 확률을 평가합니다. 채팅용 messages나 스트리밍을 사용하지 마세요.
최소 요청 예제
게이트웨이 API 키를 환경 변수 LLM_API_KEY에 설정하세요. 실제 호출이므로 실행 전에 잔액과 과금을 확인하세요. choices[0].message.content가 아닌 answers.is_urgent.noul과 usage를 읽습니다.
curl -sS -X POST https://api.llm-token.cn/v1/decisions \
-H "Authorization: Bearer $LLM_API_KEY" \
-H "Content-Type: application/json" \
-d @- <<'JSON'
{
"model": "jev-latest",
"state": "The order is due today and the payment has failed.",
"questions": {
"is_urgent": {
"type": "noul",
"instructions": "Does this require urgent attention?"
}
}
}
JSON500 / convert_request_failed에 this channel only supports native decisions requests가 포함되면 실제 요청이 여전히 /v1/chat/completions 또는 /v1/messages로 전송되는지 확인하세요. 이는 잔액 부족이 아닌 프로토콜 불일치입니다. 충전하거나 종량제로 바꿔도 해결되지 않습니다. URL과 요청 본문을 먼저 수정하고 기존 채팅 요청을 반복하지 마세요.