메인 콘텐츠로 건너뛰기
POST
프롬프트 실행 요청
전체 흐름(프롬프트 준비 → 제출 → 폴링 → 답변 조회)과 폴링 루프 코드는 프롬프트 실행하기 가이드를 참고하세요.

자주 묻는 질문

제출 후 결과는 어디서 받나요? 반환된 runID로 실행 상태 조회를 폴링하고, FINISHED가 되면 답변 목록을 runID 필터로 조회합니다.

인증

API-Key
string
header
필수

"조직 API 키를 입력하세요. 예: 'cs_live_xxxx'"

본문

application/json

프롬프트 실행 요청

models
enum<string>[]
필수

실행할 모델 목록. GET /models 로 조회 가능한 값만 허용. 서비스 중단 모델은 검증 전에 400 MODEL_DISCONTINUED 로 거부되므로 oneof 목록에 두지 않는다(현재 없음)

Required array length: 1 - 13 elements
사용 가능한 옵션:
CHATGPT,
GOOGLE_OVERVIEW,
GOOGLE_AI,
PERPLEXITY,
GEMINI,
NAVER_AI_BRIEFING,
NAVER_AI_TAB,
CLAUDE,
META_MUSE,
BAIDU_AI_SEARCH,
GROK,
BAIDU_AI_TAB,
DEEPSEEK
예시:
location
string

실행 위치(국가 하위 도시). 생략 시 region(국가) 단위로 실행합니다. GET /locations 로 조회 가능한 코드만 허용하며, region 을 함께 지정하면 그 region 에 속한 위치여야 합니다. region 을 생략하면 위치의 region 으로 실행합니다. 요청한 모든 모델이 이 위치를 지원해야 합니다.(GET /locations?model= 로 확인)

예시:

"US-NEW_YORK"

promptIDs
string[]

실행할 프롬프트 ID 목록 (1~500개, 중복은 1회로 처리). promptSetID 와 정확히 하나만 지정합니다

Required array length: 1 - 500 elements
예시:
promptSetID
string

실행할 프롬프트 세트 ID — 세트 소속 프롬프트 전체를 실행합니다. promptIDs 와 정확히 하나만 지정합니다. 세트 프롬프트 수에 500개 제한은 없으며 총 실행 수 상한(10,000)만 적용

예시:

"IkVMHhjFWcBXcJ41-h9yBQ"

region
string

실행 지역(ISO 3166-1 alpha-2). 생략 시 KR. 지원하지 않는 코드는 400. 모델마다 지원 지역이 다를 수 있습니다.(GET /regions?model= 로 확인)

예시:

"KR"

repeatCount
integer

각 프롬프트(question)별 반복 실행 횟수 (기본 1, 최대 100).

필수 범위: 1 <= x <= 100
예시:

1

응답

OK

id
string

생성된 프롬프트 실행의 ID. 이 값을 프롬프트 실행 상태 조회(GET /v1/platform/runs/{runID})의 runID 로 그대로 넣습니다

예시:

"S8cqDSjSot67bCK6YtmvHw"