Ultineo AI의 API
카탈로그의 애플리케이션을 자체 소프트웨어에서 실행하세요. API는 HTTPS로 JSON을 주고받고, 모든 호출을 프로젝트 키로 인증하며, 모든 호출에 같은 형식으로 응답합니다.
세 가지 리소스를 중심으로 설계
- 카탈로그
게시된 애플리케이션을 많이 쓰는 순서로, 각 애플리케이션이 요구하는 입력 필드와 함께 제공합니다.
- 실행
한 번의 호출로 입력과 함께 애플리케이션을 시작하고, 다른 호출로 실행과 그 응답을 다시 읽어 옵니다.
- 키
권한 범위, 선택적 만료일, 끌 수 있는 상태를 갖춘 프로젝트 키.
인증과 권한 범위
- Bearer 키
모든 호출의 Authorization 헤더에 프로젝트 키를 담아 HTTPS로만 전송하세요.
- 하나의 프로젝트로 한정
키는 하나의 프로젝트에 연결되며, 어떤 요청이든 다른 프로젝트의 데이터를 읽거나 쓸 수 없습니다.
- 해시로 저장
키는 해시값만 보관되므로 전체 키는 한 번만 표시됩니다. 분실한 키는 복구되지 않고 새 키로 교체됩니다.
실행을 시작하고 응답 읽기
- 생성
애플리케이션을 지정하고, 카탈로그가 반환하는 필드 이름을 키로 하여 입력 필드마다 값을 하나씩 넘기세요.
- 추적
실행은 비동기입니다. 상태가 완료 또는 실패가 될 때까지 실행을 다시 읽어 오세요. 두 상태 모두 최종 상태입니다.
- 읽기
완료된 실행에는 응답, 소요 시간, 입력 및 출력 토큰 수가 담겨 있습니다.
모든 응답에 동일한 형식
- 항상 같은 세 개의 필드
모든 응답에는 성공이든 실패든 상태 코드, 짧은 제목, 응답 내용이 담겨 있습니다.
- 일관된 메시지
오류 메시지는 누락된 권한 범위나 거부된 값을 알려 주는 고정된 영어 문자열입니다.
- 명확한 요금제 한도
요금제에 포함되지 않거나 사용 한도를 넘는 호출은 전용 상태 코드와 함께 거부됩니다.
키 발급받기
API 액세스는 Ultineo AI 유료 요금제에 포함됩니다. 아직 셀프 가입은 지원하지 않습니다. 저희 팀이 프로젝트를 열고 첫 번째 키를 전달해 드립니다.
API에 관한 질문
유료 요금제입니다. 무료 요금제는 API 없이 애플리케이션만 이용할 수 있습니다.
아니요. 지침은 애플리케이션 소유자의 것입니다. API는 호출하는 쪽이 채우는 입력 필드를 반환합니다.
실행을 생성하면 새 상태가 즉시 반환됩니다. 응답을 받으려면 실행이 완료될 때까지 다시 읽어 오세요.
네. 각 키에는 권한 범위와 선택적 만료일이 있으며, 키는 자신보다 넓은 권한 범위를 가진 다른 키를 만들 수 없습니다.