Skip to main content
POST
Run 제출
전체 흐름(프롬프트 준비 → 제출 → 폴링 → 답변 수집)과 폴링 루프 코드는 프롬프트 실행하기 가이드를 참고하세요.

자주 묻는 질문

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

Authorizations

API-Key
string
header
required

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

Body

application/json

Run 제출 요청

models
enum<string>[]
required

실행 모델 목록 (1~20개, 중복은 1회로 처리, 예: CHATGPT). 목록에 없는 값은 400 으로 거부된다 — GET /models 로 조회 가능

Required array length: 1 - 20 elements
Available options:
CHATGPT,
GOOGLE_OVERVIEW,
GOOGLE_AI,
PERPLEXITY,
GEMINI,
NAVER_AI_BRIEFING,
NAVER_AI_TAB,
CLAUDE
promptIDs
string[]
required

실행할 프롬프트(question) ID 목록 (1~500개, 중복은 1회로 처리)

Required array length: 1 - 500 elements
promptSetID
string

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

region
string

실행 지역(ISO 3166-1 alpha-2, 예: KR·US·JP). 생략 시 KR. 지원하지 않는 코드는 400. 모델마다 지원 지역이 다를 수 있으며(GET /regions?model= 로 확인), 지원하지 않는 조합은 400

repeatCount
integer

각 프롬프트(question)별 반복 실행 횟수 (기본 1, 최대 100). 총 실행 수(프롬프트 수 × 모델 수 × 반복 횟수)가 10,000을 초과하면 400 (RUN_TOO_MANY_TASKS)

Required range: 1 <= x <= 100

Response

OK

runID
string

이번 제출의 실행 단위(TaskGenerationRun) ID. 외부엔 Run ID 로 노출한다.