EvoWeb Website Builder
text description만으로 AI 기반 생성을 통해 완전한 웹사이트를 만드세요.
개요
EvoWeb은 자연어 프롬프트로부터 현대적이고 반응형인 웹사이트를 자동으로 생성합니다. 원하는 것을 설명하기만 하면 AI가 HTML, CSS, JavaScript 및 콘텐츠를 생성하여 약 4분 만에 완전한 라이브 웹사이트를 제공합니다.
최적 대상: 랜딩 페이지 및 비즈니스 웹사이트
API 기본 URL: https://api.evoweb.ai/openapi/api/v1
인증
API 키는 https://evoweb.ai/?utm_source=claw&utm_medium=skill&utm_campaign=website&utm_content=v1.0 에서 발급받으세요.
중요: 등록 후에는 반드시 이메일 주소를 확인해야 합니다 (필수). 이메일 확인이 완료될 때까지 서비스가 작동하지 않습니다.
아직 API 키가 없으신가요?
사용자에게 API 키가 없는 경우에도 웹사이트를 만들 수 있도록 도와줄 수 있습니다:
- 웹사이트에 대한 간단한 설명(최대 250자)을 요청합니다.
- 1단계에서 받은 프롬프트를 포함한 가입 링크를 생성합니다.
- 사용자는 "Create Website" 버튼을 클릭한 후 계정을 만들 수 있습니다.
자세한 내용은 아래 "Step 0: API 키가 없는 사용자 처리"를 참조하세요.
모든 요청에 다음 헤더를 포함하세요:
Access-Token: your-api-key-here
작동 방식
워크플로는 간단합니다:
- 생성 - 웹사이트를 설명하는 텍스트 프롬프트를 제출합니다.
- 폴링 - 1분마다 생성 상태를 확인합니다.
- 결과 확인 - 준비가 완료되면 라이브 URL과 편집 링크를 받습니다.
일반적인 생성 시간: 4-5분
API 엔드포인트
1. 웹사이트 생성
POST /sites
text description으로부터 새로운 웹사이트 생성 작업을 시작합니다.
요청 본문:
{
"prompt": "A local coffee shop specializing in artisanal coffee and fresh pastries. We source our beans locally and focus on creating a cozy community gathering space for local residents, remote workers, and coffee enthusiasts."
}
응답 (200 OK):
{
"site_id": "abc123xyz",
"status": "queued"
}
상태 값:
queued- 작업이 대기열에 있으며 시작을 기다리는 중입니다.building- 웹사이트가 생성 중입니다.
오류 응답:
401 Unauthorized- API 키가 잘못되었거나 누락되었습니다.402 Payment Required- 계정에 크레딧이 부족합니다.
2. 생성 상태 확인
GET /sites/{site_id}
웹사이트 생성의 현재 상태를 확인합니다.
예시: GET /sites/abc123xyz
빌드 중 응답:
{
"status": "building"
}
준비 완료 응답:
{
"status": "ready",
"url": "https://website.page/my-site",
"editor_url": "https://web.oto.dev/ui/websites/abc123xyz/update/"
}
실패 응답:
{
"status": "failed",
"error": "Generation failed: Invalid prompt structure"
}
상태 값:
queued- 대기열에서 대기 중building- 현재 생성 중 (기다려 주세요!)ready- 완료! URL을 사용할 수 있습니다.failed- 생성 중 오류가 발생했습니다.
오류 응답:
404 Not Found- 사이트 ID가 존재하지 않습니다.
3. 실패한 생성 재시도
POST /sites/{site_id}/remake
실패한 웹사이트의 생성을 다시 시작합니다. failed 상태뿐만 아니라 ready 상태인 사이트에도 작동합니다.
예시: POST /sites/abc123xyz/remake
응답 (200 OK):
{
"status": "queued",
"editor_url": "https://web.oto.dev/ui/websites/abc123xyz/update/"
}
오류 응답:
400 Bad Request- 'failed' 상태인 사이트만 다시 만들 수 있습니다.404 Not Found- 사이트 ID가 존재하지 않습니다.
AI 어시스턴트를 위한 지침
사용자가 웹사이트를 요청하면 다음 워크플로를 따르세요:
Step 0: API 키가 없는 사용자 처리
먼저 확인: 사용자에게 EVOWEB_API_KEY 환경 변수가 설정되어 있습니까?
API 키가 없는 경우:
-
간단한 프롬프트 수집 (최대 250자):
- 비즈니스/프로젝트에 대해 간략히 설명해 달라고 요청합니다.
- 핵심 비즈니스 본질에 집중하여 간결하게 유지합니다.
-
미리 채워진 가입 링크 생성:
- 기본 URL:
https://evoweb.ai/?utm_source=claw&utm_medium=skill&utm_campaign=website&utm_content=v1.0 - 매개변수 추가:
&prompt=[URL_ENCODED_PROMPT] - 예시:
https://evoweb.ai/?utm_source=claw&utm_medium=skill&utm_campaign=website&utm_content=v1.0&prompt=A%20local%20coffee%20shop%20specializing%20in%20artisanal%20coffee
- 기본 URL:
-
사용자에게 링크 제공:
🌐 웹사이트를 만들려면 다음 링크를 방문하세요: [여기에 개인화된 링크] "Create Website" 버튼을 클릭한 후 계정을 만들면 웹사이트가 자동으로 생성됩니다!
중요: 프롬프트를 URL 인코딩으로 올바르게 변환하세요 (공백은 %20 등).
API 키가 있는 경우: 아래 Step 1로 진행합니다.
Step 1: 비즈니스 이해
사용자의 설명에서 비즈니스 본질을 이해하는 데 집중하세요:
- 비즈니스/프로젝트는 무엇에 관한 것입니까?
- 무엇을 하거나 제공합니까?
- 대상 고객은 누구입니까?
- 웹사이트의 주요 목표는 무엇입니까?
중요: 구체적인 디자인 세부 사항, 섹션, 색상 또는 레이아웃을 지정하지 마세요. EvoWeb AI가 모든 디자인과 구조 결정을 자동으로 처리합니다.
예시 변환:
- 사용자: "내 요가 스튜디오 웹사이트를 만들어 주세요"
- 향상된 프롬프트: "다양한 기술 수준을 위한 여러 클래스를 제공하는 요가 스튜디오로, 웰니스와 마음 챙김에 중점을 둡니다. 대상 고객은 피트니스와 정신 건강에 관심이 있는 지역 사회 구성원입니다."
Step 2: 사이트 생성
향상된 프롬프트를 사용하여 POST /sites를 호출합니다.
반환된 site_id를 저장하세요. 상태 확인에 필요합니다.
Step 3: 사용자에게 알림
다음을 알려줍니다:
- 웹사이트 생성이 시작되었습니다.
- 약 4분이 소요됩니다.
- (가능한 경우에만) 자동으로 진행 상태를 확인할 것입니다.
예시: "✨ 지금 웹사이트를 만들고 있습니다! 일반적으로 3~5분 정도 소요됩니다. 상태를 확인하고 준비되면 알려드리겠습니다."
Step 4: 상태 폴링
GET /sites/{site_id}를 호출하여 진행 상태를 확인합니다:
- 폴링 간격: 1분마다
- 최대 시도 횟수: 20번
- 폴링 사이: 사용자에게 진행 상황을 알릴 수 있습니다 ("아직 만들고 있어요...")
다음 중 하나가 될 때까지 폴링을 계속합니다:
- 상태가
ready→ Step 5로 진행 - 상태가
failed→ Step 6으로 진행 - 최대 시도 횟수 도달 → 예상보다 시간이 더 걸린다고 사용자에게 알림
Step 5: 성공 전달
상태가 ready일 때:
-
URL 제공:
url- 라이브 웹사이트editor_url- 사이트를 사용자 정의할 수 있는 링크
-
개선 제안: 사이트를 개선할 수 있는 구체적인 방법 3가지를 제안합니다:
- "온라인 예약 시스템 추가"
- "브랜드에 맞게 색상 사용자 정의"
- "고객 후기 섹션 추가"
-
간결하고 실행 가능하게 유지
예시 응답:
🎉 웹사이트가 준비되었습니다!
🌐 여기에서 보기: https://website.page/yoga-studio-23f4
✏️ 사용자 정의: https://web.evoweb.ai/ui/websites/abc123xyz/update/
원할 수 있는 빠른 개선 사항:
1. 온라인 수업 예약 시스템 추가
2. Instagram 피드 통합
3. 웰니스 팁을 위한 블로그 섹션 추가
이 중 어떤 것에 대해 도움이 필요하신가요?
Step 6: 실패 처리
상태가 failed일 때:
- API 응답의 오류 메시지 표시
- 재시도 제안: 사이트를 다시 만들겠냐고 물어봅니다.
- 동의할 경우:
POST /sites/{site_id}/remake를 호출하고 폴링을 다시 시작합니다.
예시 응답:
❌ 웹사이트 생성 실패: [오류 메시지]
다시 시도해 볼까요? 생성 프로세스를 다시 시작할 수 있습니다.
사용자가 동의하면 remake 엔드포인트를 호출하고 Step 4부터 폴링을 다시 시작합니다.
예시 프롬프트 및 사용 사례
예시: API 키가 없는 사용자
사용자: "요가 스튜디오 웹사이트가 필요해요"
어시스턴트 응답:
"도와드리게 되어 기쁩니다! 빠르게 시작할 수 있도록 맞춤 링크를 생성해 드리겠습니다.
🌐 웹사이트를 만들려면 이 링크를 방문하세요:
https://evoweb.ai/?utm_source=claw&utm_medium=skill&utm_campaign=website&utm_content=v1.0&prompt=A%20yoga%20studio%20offering%20various%20classes%20for%20all%20skill%20levels%2C%20focused%20on%20wellness%20and%20mindfulness
'Create Website'를 클릭한 후 계정을 만들면 약 4분 만에 웹사이트가 자동으로 생성됩니다! ✨"
커피숍 랜딩 페이지
사용자 요청: "내 커피숍 웹사이트를 만들어 주세요"
향상된 프롬프트:
"'Bean & Brew Cafe'라는 지역 커피숍으로, 장인 커피와 신선한 페이스트리를 전문으로 합니다. 원두를 지역에서 공급받고 아늑한 커뮤니티 모임 공간을 만드는 데 중점을 둡니다. 대상 고객은 지역 주민, 원격 근무자, 그리고 품질 좋은 커피와 따뜻한 분위기를 찾는 커피 애호가입니다."
사진작가 포트폴리오
사용자 요청: "포트폴리오 사이트가 필요해요"
향상된 프롬프트:
"진정성 있고 감동적인 순간을 포착하는 것을 전문으로 하는 전문 웨딩 사진작가입니다. 10년의 경험을 바탕으로 이미지를 통한 스토리텔링과 커플을 위한 시대를 초월한 추억 만들기에 중점을 둡니다. 대상 고객은 결혼식을 준비 중인 약혼한 커플로, 특별한 날의 진정한 감정을 포착할 수 있는 사진작가를 찾고 있습니다."
온라인 스토어
사용자 요청: "내 주얼리용 전자상거래 사이트를 만들어 주세요"
향상된 프롬프트:
"독특하고 장인 정신이 깃든 작품을 만드는 수제 주얼리 비즈니스입니다. 각 아이템은 전통적인 기술과 고품질 재료를 사용하여 손으로 제작됩니다. 맞춤 디자인과 고객과의 개인적인 연결에 중점을 둡니다. 대상 고객은 수공예적이고 독특한 액세서리를 감상하고 주얼리 뒤에 숨겨진 이야기를 중요시하는 25-45세 여성입니다."
SaaS 랜딩 페이지
사용자 요청: "내 앱용 랜딩 페이지"
향상된 프롬프트:
"중소 규모 팀을 위해 설계된 프로젝트 관리 SaaS 도구입니다. 이 앱은 팀이 작업을 효과적으로 구성하고, 협업하며, 프로젝트 진행 상황을 실시간으로 추적하는 데 도움을 줍니다. 주요 가치 제안은 복잡한 엔터프라이즈 솔루션에 비해 단순성과 사용 편의성입니다. 대상 고객은 직관적인 프로젝트 관리 솔루션을 찾는 스타트업 창업자, 소기업 소유주 및 팀 리더입니다."
레스토랑 웹사이트
사용자 요청: "이탈리안 레스토랑 웹사이트"
향상된 프롬프트:
"3대째 요리 전통을 이어온 가족이 운영하는 정통 이탈리안 트라토리아입니다. 가족을 통해 전해 내려오는 전통 레시피를 전문으로 하며, 신선한 재료와 오랜 요리 방법을 사용합니다. 이 레스토랑은 따뜻하고 가족 친화적인 분위기를 제공하며 특별 이벤트를 위한 케이터링 서비스도 제공합니다. 대상 고객은 정통 이탈리안 요리와 따뜻한 식사 경험을 찾는 지역 주민과 관광객입니다."
모범 사례
좋은 프롬프트 작성
✅ 권장 사항:
- 비즈니스/프로젝트의 본질을 설명하세요.
- 비즈니스가 무엇을 하거나 제공하는지 설명하세요.
- 대상 고객을 식별하세요.
- 주요 목표/목적을 명확히 하세요.
- 주요 차별화 요소 또는 독특한 가치 제안을 포함하세요.
❌ 하지 말아야 할 것:
- 특정 디자인 요소(색상, 레이아웃, 스타일)를 지정하지 마세요.
- 웹사이트 섹션이나 구조를 지시하지 마세요.
- 외관이나 느낌에 대한 세부 사항을 지정하지 마세요.
- 비즈니스 맥락 없이 너무 모호하게 말하지 마세요 ("웹사이트 만들어 줘").
- API 키를 사용할 수 없는 경우 직접 API 요청을 하지 마세요 (대신 Step 0 방법을 사용하세요).
폴링 전략
- 간격: 1분
- 최대: 총 20회 시도
- 일반 시간: 4 - 5분
- 사용자에게 알림: 진행 상태를 확인 중임을 알리세요.
오류 처리
- 명확한 오류 메시지를 표시하세요.
- 자동 재시도를 제안하세요.
- 여러 번 실패하면 https://evoweb.ai/ 에서 계정을 확인하도록 제안하세요.
사용자 경험
- API 키가 없는 사용자: 미리 채워진 가입 링크를 제공하세요 (간편하고 빠름).
- API 키가 있는 사용자: 기대치를 설정하세요 (4분 대기 시간).
- 보기 및 편집 URL을 모두 제공하세요.
- 구체적인 개선 사항을 제안하세요.
- 응답을 간결하게 유지하세요.
- 항상 다음 단계 옵션으로 마무리하세요.
기술 세부 사항
- 프로토콜: HTTPS REST API
- 형식: JSON
- 인증: 헤더 기반 API 키
- 속도 제한: EvoWeb에 확인 (계정별 제한이 있을 수 있음)
- 생성 시간: 일반적으로 4-5분
- 비용: 생성당 크레딧 (가격은 https://evoweb.ai/ 참조)
지원 및 리소스
- API 키 받기: https://evoweb.ai/?utm_source=claw&utm_medium=skill&utm_campaign=website&utm_content=v1.0
- API 문제: EvoWeb 지원팀에 문의
- 계정/결제: https://evoweb.ai/ 방문
참고 사항
- 각 생성은 EvoWeb 계정의 크레딧을 소모합니다.
- 편집 URL을 통해 생성된 사이트를 사용자 정의할 수 있습니다.
- 생성된 사이트는 EvoWeb 인프라에서 호스팅됩니다.
- 사용자 정의 도메인을 사용할 수 있습니다 (EvoWeb 문서 확인).
- 계정이 활성 상태인 한 사이트는 계속 라이브 상태로 유지됩니다.
텍스트 설명만으로 놀라운 웹사이트를 만들 준비가 되었습니다! 🚀