빠른 시작

아직 코드를 작성할 준비가 되지 않았나요? Playground을 사용해 보세요 — 브라우저에서 직접 어떤 모델이든 테스트할 수 있으며, API 키가 필요하지 않습니다.

1. 계정 생성

Google 또는 이메일로 runbase.net에 가입하세요. 신용카드는 필요하지 않습니다 — 새 계정에는 시작할 수 있도록 무료 잔액이 제공됩니다.

2. API 키 받기

Settings → API Keys로 이동해 새 키를 생성하세요. 안전한 곳에 복사해 두세요 — 키는 sk-로 시작하며 다시는 표시되지 않습니다.

export RUNBASE_API_KEY="sk-your-key-here"

3. run 생성

모델 ID와 입력 파라미터를 포함하여 /api/v1/runs로 POST를 보내세요:

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-2",
    "input": {
      "prompt": "A cozy bookshop interior with warm lighting, watercolor style",
      "aspect_ratio": "1:1"
    }
  }'

응답:

{
  "id": "run_2abc...",
  "model": "google/nano-banana-2",
  "status": "pending",
  "costUsd": 40000
}

costUsd는 마이크로 USD 단위입니다(1 USD = 1,000,000). 40,000의 비용은 $0.04를 의미합니다.

4. 결과를 폴링하기

run ID를 사용해 상태를 확인하세요:

curl -s https://runbase.net/api/v1/runs/run_2abc... \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

status가 "succeeded"이면, output 필드에 결과가 포함됩니다:

{
  "id": "run_2abc...",
  "status": "succeeded",
  "model": "google/nano-banana-2",
  "costUsd": 40000,
  "output": {
    "urls": [
      "https://runbase.net/files/generated/abc123.png"
    ]
  },
  "createdAt": "2026-06-01T12:00:00.000Z",
  "completedAt": "2026-06-01T12:00:04.200Z"
}

run이 실패하면 status는 "failed"가 되며, 비용은 자동으로 잔액에 환불됩니다.

5. 이미지 다운로드

출력에 있는 URL은 생성된 이미지 또는 비디오로 직접 연결되는 링크입니다. 전 세계 CDN에서 제공되며 즉시 이용할 수 있습니다.

다음 단계

• Core Concepts — run 수명 주기, 비동기 모델, 비용 메커니즘 이해하기
• Authentication — 프로덕션용 IP 화이트리스트와 지출 한도 설정하기
• Models — 사용 가능한 모든 모델을 살펴보고 Playground에서 시도해 보기
• Billing — 잔액을 충전하고 관리하기