개발자 v1.0

마스터 API 볼트

Swashi의 AI Agents에 프로그래밍 방식으로 접근하여 콘텐츠 생성, 제품 인텔리전스, 분석을 애플리케이션에서 직접 자동화하세요.

소개

Master API Vault는 개발자, 창업가, 자동화 팀을 위해 설계된 REST 기반 API입니다. 예측 가능한 JSON 출력, 빠른 응답 시간, 실제 프로덕션 워크로드를 위한 확장 가능한 인프라를 제공합니다. 전체 기능 세트를 확인하거나 이용 가능한 플랜을 검토하세요.

인증

요청은x-api-key헤더를 사용하여 인증합니다.

BASH
curl -X POST https://api.swashi.io/v1/generate \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"scaling strategy"}'

요청 제한

플랫폼 안정성을 위해 요청에는 제한이 있습니다.

  • 분당 60회 요청
  • 일일 1,000회 요청 (무료 플랜)
  • 유료 플랜에서 더 높은 제한 이용 가능

응답 객체

모든 응답은 표준 JSON 형식으로 반환됩니다.

JSON
{
  "status": "success",
  "data": {
    "id": "gen_839201",
    "content": "Dropshipping automation...",
    "usage": {
      "tokens": 150,
      "model": "swashi-core"
    }
  }
}

오류 처리

오류 발생 시 200이 아닌 HTTP 코드와 구조화된 메시지가 반환됩니다.

JSON
{
  "status": "error",
  "code": 401,
  "message": "Unauthorized request"
}