프롬프트 실행 개요 - Chainshift

프롬프트 실행은 등록한 프롬프트들을 AI 모델에서 실행하는 비동기 수집 작업입니다. 제출하면 runID가 즉시 반환되고 수집은 백그라운드에서 진행됩니다 — 완료는 폴링으로 확인합니다(30초 간격 권장).

제출 규칙

항목	규칙
프롬프트 지정	`promptIDs`(1~500개) 또는 `promptSetID` 중 정확히 하나
`models`	지원 모델 목록의 값만. 최소 1개, 중복은 1회로 처리
`region`	선택. 생략 시 `KR`
`repeatCount`	1~100. 같은 조합 반복 실행 (노출률 측정용)
총 실행 수	프롬프트 × 모델 × 반복 ≤ 10,000 (`RUN_TOO_MANY_TASKS`)

상태

실행 요청: RUNNING → FINISHED 두 가지뿐입니다. 개별 실행이 실패해도 실행 요청은 FINISHED로 끝나며, 실패 수는 failedCount로 확인합니다.
개별 실행: PENDING → SUCCESS 또는 FAILED.

과금

크레딧은 제출 시점이 아니라 수집이 완료된 실행 건마다 모델별 단가로 차감됩니다(후차감). 실패한 실행은 차감되지 않습니다. 크레딧 참고.

자주 묻는 질문

답변 본문은 어디서 받나요? 실행 상태 조회의 answers는 진행 상태만 담습니다. 본문·출처는 답변 목록을 runID 필터로 조회하세요. 실행 목록은 왜 10개씩만 조회되나요? GET /runs의 limit은 최대 10입니다(다른 목록은 100). 대량 조회가 필요하면 cursor로 순회하세요. 전체 흐름과 폴링 코드는 프롬프트 실행하기 가이드를 참고하세요.