> ## Documentation Index
> Fetch the complete documentation index at: https://dev-docs.trychainshift.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 프롬프트 실행 개요

> 프롬프트 실행의 비동기 동작 규칙, 제출 파라미터, 상태와 과금

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

## 제출 규칙

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

## 상태

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

## 과금

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

## 자주 묻는 질문

**답변 본문은 어디서 받나요?**
실행 상태 조회의 `answers`는 진행 상태만 담습니다. 본문·출처는 [답변 목록](/api-reference/answers/list-answers)을 `runID` 필터로 조회하세요.

**실행 목록은 왜 10개씩만 조회되나요?**
`GET /runs`의 `limit`은 최대 10입니다(다른 목록은 100). 대량 조회가 필요하면 cursor로 순회하세요.

전체 흐름과 폴링 코드는 [프롬프트 실행하기](/guides/submitting-runs) 가이드를 참고하세요.