Quick Start

이 문서는 사람이 결제를 끝내고, 코딩 에이전트가 바로 통합을 시작해야 할 때 쓰는 가장 짧은 경로입니다.

필요한 값

• success 페이지에서 받은 API key
• Base URL: https://maas.nunchiai.com/v1
• 대상 환경의 X-Workspace-Id
• checkout 때 선택한 service_source

1. checkout session 생성

curl -X POST https://maas.nunchiai.com/api/v1/billing/maas/checkout-session \
  -H 'Content-Type: application/json' \
  -d '{
    "company_name": "Acme Studio",
    "admin_email": "[email protected]",
    "pricing_model": "enterprise_usage",
    "service_source": "enterprise-tutor"
  }'

{
  "checkout_session_id": "cs_test_123",
  "url": "https://checkout.stripe.com/c/pay/cs_test_123",
  "success_url": "https://maas.nunchiai.com/billing/maas/success?checkout_session_id={CHECKOUT_SESSION_ID}",
  "cancel_url": "https://maas.nunchiai.com/billing/maas/cancel",
  "service_source": "enterprise-tutor",
  "pricing_model": "enterprise_usage",
  "contract_version": "2026-03-01"
}

오류

• 400 Bad Request — company_name, admin_email, pricing_model, service_source가 잘못되었습니다.
• 402 Payment Required — 호스티드 billing이 일시 중지된 상태입니다.
• 500 Internal Server Error — Stripe price 설정이 없습니다.

2. 결제 완료 후 success 페이지로 이동

구매자는 Stripe 결제를 마친 뒤 아래 주소로 돌아옵니다.

https://maas.nunchiai.com/billing/maas/success?checkout_session_id=cs_test_123

success 페이지에서 자동으로 보여주는 값:

• organization slug
• service source 라벨
• workspace id
• 첫 API key
• AHOP handoff block

3. 첫 runtime 호출

curl -X POST https://maas.nunchiai.com/v1/memory/recall \
  -H "Authorization: Bearer mk_maas_example" \
  -H "X-Workspace-Id: acme-prod" \
  -H 'Content-Type: application/json' \
  -d '{
    "anchor_id": "smoke-test",
    "query": "hello"
  }'

{
  "items": [],
  "session_id": "c67d4f42-0b6d-4f94-beb8-22eb24a8a6df",
  "service_source": "enterprise-tutor",
  "workspace_id": "acme-prod"
}

오류

• 400 Bad Request — API key가 잘못되었거나 X-Workspace-Id가 없습니다.
• 402 Payment Required — billing account가 막혀 있습니다.
• 403 Forbidden — access policy가 이 조합을 허용하지 않습니다.
• 429 Too Many Requests — backoff 후 재시도하세요.

다음 문서

• 전체 표면: API Reference
• 캐릭터 메모리: Character Chat
• 엔터프라이즈 메모리: Editorial / Content