SUPER TERMINAL API · v1

제품에서 프롬프트 실행하기

중앙 관제센터에서 발급한 제품별 API 키로 Prompt Keeper의 승인된 프롬프트를 실행합니다.

인증

서버 환경변수에 키를 보관하고 Bearer 헤더로 전달합니다. 브라우저 코드에는 키를 넣지 마세요.

Authorization: Bearer st_live_key_...

응답 생성

POST/v1/prompts/{name}/responses
curl https://api.super-terminal.win/v1/prompts/customer-bot/responses \
  -H "Authorization: Bearer $SUPER_TERMINAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-8472" \
  -d '{
    "release": "production",
    "input": "배송은 언제 시작되나요?",
    "variables": { "customer_name": "민지" }
  }'

응답

{
  "id": "resp_01J...",
  "status": "completed",
  "output_text": "안녕하세요, 민지님...",
  "prompt": {
    "name": "customer-bot",
    "version": "v3",
    "release": "production"
  },
  "request_id": "req_01J..."
}

공통 오류

401은 키 오류, 403은 권한 부족, 429는 호출량 초과를 의미합니다. 문의 시 request_id를 사용하세요.