Ultineo Reasoning의 API
카탈로그의 애플리케이션을 자체 소프트웨어에서 실행하세요. API는 HTTPS로 JSON을 주고받고, 모든 호출을 프로젝트 키로 인증하며, 모든 호출에 같은 형식으로 응답합니다.
앱, 실행, 키를 중심으로 설계
- 앱
입력 필드와 지침으로 앱을 만든 다음 앱 목록을 보고, 읽고, 편집하세요.
- Runs and usage
한 번의 호출로 입력과 함께 앱을 시작하고, 다른 호출로 실행과 그 응답을 다시 읽어 옵니다. 요약에는 현재 청구 주에 사용한 토큰과 그 금액이 표시됩니다.
- 키
권한 범위, 선택적 만료일, 끌 수 있는 상태를 갖춘 프로젝트 키.
어디서든 통합하세요
- In your software
Add a reasoning step to an existing screen: a summary, a suggested reply, a classification.
- 자동화에서
A script or an automation tool launches a run at each event: a form received, a file dropped.
- 하나의 답변에서 다음으로
하나의 실행 결과가 다음 실행의 필드가 될 수 있습니다: 코드는 필요에 따라 단계를 연결합니다.
The same run, through the API
Your software sends the application’s identifier and its fields, then reads the run back until it is finished.
보내는 내용
{
"app_id": "mapp_0ceacb46e5b3a99e91b6",
"data": {
"message": "My parcel has not arrived and the tracking has not moved for a week."
}
} 읽은 내용 확인
{
"id": "runi_1b7f4e0c96a2d8531fca",
"object": "reasoning",
"status": "finished",
"response": { "miid_9a4c07e5b312df8641ca": "urgent" },
"tokens": { "input": 412, "output": 3, "total": 415 },
"duration": 1.84
} 인증과 권한 범위
- Bearer 키
모든 호출의 Authorization 헤더에 프로젝트 키를 담아 HTTPS로만 전송하세요.
- 하나의 프로젝트로 한정
키는 하나의 프로젝트에 연결되며, 어떤 요청이든 다른 프로젝트의 데이터를 읽거나 쓸 수 없습니다.
- 해시로 저장
키는 해시값만 보관되므로 전체 키는 한 번만 표시됩니다. 분실한 키는 복구되지 않고 새 키로 교체됩니다.
실행을 시작하고 응답 읽기
- 생성
애플리케이션을 지정하고, 애플리케이션이 반환하는 필드 이름을 키로 하여 입력 필드마다 값을 하나씩 넘기세요.
- 추적
실행은 비동기입니다. 상태가 완료 또는 실패가 될 때까지 실행을 다시 읽어 오세요. 두 상태 모두 최종 상태입니다.
- 읽기
완료된 실행에는 응답, 소요 시간, 입력 및 출력 토큰 수가 담겨 있습니다.
The runs your software started, one by one
Every call made through the API appears in the reasonings list, marked API, with its duration and its tokens. Each application shows the identifier your software calls.
모든 응답에 동일한 형식
- 항상 같은 세 개의 필드
모든 응답에는 성공이든 실패든 상태 코드, 짧은 제목, 응답 내용이 담겨 있습니다.
- 일관된 메시지
오류 메시지는 누락된 권한 범위나 거부된 값을 알려 주는 고정된 영어 문자열입니다.
- Refusals are explicit
A call that cannot be accepted, for example while an invoice is overdue, is refused with its own status code.
키 발급받기
API access is included with Ultineo Reasoning. There is no self-service sign-up: our team opens your project and hands you its first key.
사용 중인 소프트웨어를 Ultineo Reasoning에 연결하세요
자동화하고 싶은 작업을 알려 주시면 프로젝트와 API 키를 열어 드립니다.
API에 관한 질문
Yes. Every project can call the API; a call is billed like any other run, on the tokens it uses.
아니요. 지침은 애플리케이션 소유자의 것입니다. API는 호출하는 쪽이 채우는 입력 필드를 반환합니다.
실행을 생성하면 새 상태가 즉시 반환됩니다. 응답을 받으려면 실행이 완료될 때까지 다시 읽어 오세요.
네. 각 키에는 권한 범위와 선택적 만료일이 있으며, 키는 자신보다 넓은 권한 범위를 가진 다른 키를 만들 수 없습니다.