API Documentation

XIVIX Automation System REST API

GET/api/health

서비스 상태 확인

Response:
{
  "status": "ok",
  "service": "XIVIX Automation System",
  "version": "1.0.0",
  "timestamp": "2024-01-01T00:00:00.000Z"
}
POST/api/v1/analyze-vibe

인플루언서 스타일 분석 (Gemini Vision)

Request Body:
{
  "source_url": "https://... 또는 data:image/...",
  "media_type": "image" | "video",
  "analysis_depth": "high",
  "target_platform": "instagram_reels" | "youtube_shorts" | "web_16_9",
  "api_key": "Gemini API Key"
}
POST/api/v1/build-sparkpage

Sparkpage HTML 생성

Request Body:
{
  "project_id": "XIVIX_PROJECT_ID",
  "style_metadata": { "colors": ["#HEX"], ... },
  "content": { "headline": "...", "sub_headline": "...", "cta_button_text": "..." },
  "export_settings": { "responsive_type": "mobile_first", "framework": "TailwindCSS" }
}
POST/api/v1/capture-media

4K 미디어 캡처 스크립트 생성

Request Body:
{
  "target_url": "https://...",
  "viewport": { "width": 3840, "height": 2160, "deviceScaleFactor": 2 },
  "output_format": "png" | "mp4",
  "record_duration": "15s",
  "wait_until": "networkidle"
}
GET/api/v1/export/txt/:type

TXT 파일 내보내기

Types: projects, analysis, api-spec

GET/api/docs

OpenAPI 3.0 JSON 스펙

JSON 보기 →

Base URL: https://xivix-automation.pages.dev