프롬프트 실행 개요 - Chainshift

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

제출 규칙

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

상태

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

과금

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

자주 묻는 질문

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