오류와 크레딧

생성 엔드포인트는 Sume 웹 앱과 같은 billing 경로를 통해 크레딧을 예약하거나 사용할 수 있습니다.

크레딧 확인

sume credits
curl https://www.sume.so/api/v1/credits \
  -H "Authorization: Bearer $SUME_API_KEY"

응답에는 가능한 경우 플랜, 사용 가능한 크레딧, 활성 동시 실행 정보가 포함됩니다.

오류 envelope

{
  "error": {
    "code": "insufficient_credits",
    "message": "Not enough credits for this request.",
    "details": {}
  },
  "request_id": "req_..."
}

지원 요청을 위해 request_id는 기록하되 API 키, signed URL, 원본 비공개 미디어 URL은 로그에 남기지 마세요.

자동화 기준

읽기 전용 명령은 먼저 실행해도 안전합니다.
생성, 분석, 업로드 finalize는 사용자 의도를 확인한 뒤 실행합니다.
비용이 발생할 수 있는 도구는 에이전트 UI에서 명확하게 구분합니다.
실패 응답은 요약하고 민감한 원문 payload는 공유하지 않습니다.