빠른 시작

새 계정을 만들어 실행을 끝내고, 직접 운영하는 서버에서 API를 호출하기까지 약 5분이 걸립니다.

1. 계정 만들기와 크레딧 충전

   계정을 만듭니다. 새 조직의 소유자가 됩니다. 실행은 선불이므로 결제를 열어 크레딧을 충전하세요. 시작하기에는 $10이면 충분합니다.

   크레딧은 Stripe가 결제를 확인하는 즉시 반영되며, 보통 몇 초 안에 나타납니다.

2. 플레이그라운드에서 실행 시작

   대시보드에서 플레이그라운드를 열고 실행 페이지의 예시 사용해 보기를 선택하거나 직접 프롬프트를 작성합니다. ⌘↵를 누르면 시작됩니다. 출력은 오른쪽에 스트리밍되며, 워커가 거치는 모든 단계가 함께 표시됩니다.

   모든 실행에는 출력, 이벤트 타임라인, 비용을 보여 주는 페이지가 있습니다.

3. API 키 만들기

   API 키를 열고 멤버 키를 만듭니다. 키는 한 번만 표시되며, 환경 변수에 바로 붙여 넣을 수 있는 스니펫이 함께 제공됩니다. 키는 서버에만 보관하세요.

   터미널

   export EPHEMERAL_URL=https://app.ephemer.al
   export EPHEMERAL_API_KEY=eak_…

4. 같은 실행을 코드에서 시작

   cURLNode.jsCLI

   curl $EPHEMERAL_URL/v1/runs \
     -H "Authorization: Bearer $EPHEMERAL_API_KEY" \
     -H "Content-Type: application/json" \
     -H "Idempotency-Key: $(uuidgen)" \
     -d '{
       "prompt": "Summarize the input in one sentence",
       "input": { "text": "The export finished but two invoices are missing." },
       "max_cost_micros": 500000
     }'

   응답은 실행의 id가 담긴 202 Accepted입니다. 실행은 대기열에 들어가고, 사용 가능한 워커가 생기는 즉시 시작됩니다.

5. 결과 받기

   상태가 최종 상태(succeeded, failed, cancelled, timed_out, interrupted)가 될 때까지 GET /v1/runs/{id}를 폴링합니다. 그런 다음 비용이 정산되도록 billing_pending이 false가 될 때까지 기다립니다. 성공한 실행의 답은 output에 들어 있고, 그 밖의 최종 상태에서는 이유가 error에 들어 있습니다.

   cURLNode.jsCLI

   RUN_ID=run_4abb0f420c6623a12d2889610eb67284   # 이전 단계에서 받은 id
   
   while true; do
     RUN=$(curl -sf "$EPHEMERAL_URL/v1/runs/$RUN_ID" \
       -H "Authorization: Bearer $EPHEMERAL_API_KEY") || exit 1
     case $(jq -r .status <<<"$RUN") in
       succeeded|failed|cancelled|timed_out|interrupted)
         [ "$(jq -r .billing_pending <<<"$RUN")" = false ] && break ;;
     esac
     sleep 2
   done
   
   jq '{status, output, error, cost_micros}' <<<"$RUN"

   cost_micros가 없으면 0을 뜻합니다. CLI의 --wait는 상태가 최종 상태가 되는 즉시 돌아오므로, 정산된 비용이 필요하면 ephemeral runs get으로 다시 조회하세요. GET /v1/runs/{id}/events에서 이벤트를 스트리밍할 수도 있습니다. 오래 걸리는 실행에는 요청에 콜백을 지정하면 끝났을 때 Ephemeral이 호출하므로 폴링할 필요가 없습니다.

   완료된 실행의 응답은 다음과 같습니다.

   GET /v1/runs/run_…

   {
     "id": "run_4abb0f420c6623a12d2889610eb67284",
     "status": "succeeded",
     "output": "Two invoices are missing from an otherwise complete export.",
     "cost_micros": 3120,
     "max_cost_micros": 500000,
     "billing_pending": false
   }

다음 단계

• 파일, 연결, 웹 액세스를 사용해 실제 조사를 실행합니다.
• 프롬프트를 워크플로로 저장하고 이름으로 시작합니다.
• 실행에 읽을 파일과 호출할 연결을 제공합니다.
• 예산으로 모든 실행을 한도 안에서 유지하는 방법을 알아봅니다.