위젯

위젯은 스크립트 태그 하나로 내 웹사이트에 화이트라벨 AI 인터페이스를 넣어 줍니다. 채팅, 이미지, 음성, 음악, 동영상을 지원하며 카탈로그의 모든 모델을 사용할 수 있습니다. 방문자는 API 키가 필요 없습니다. 요청은 해당 모델의 정상 가격으로 USD 잔액에서 차감됩니다.

위젯 만들기

1. 위젯을 열고 새 위젯을 선택하세요(또는 계정 없이 위젯 페이지에서 먼저 디자인할 수 있습니다).
2. 유형과 모델을 고른 뒤 제목, 색상, 테마, 모서리 둥글기, 문구, 배치를 설정하세요. 채팅 위젯은 비공개 지침과 응답 길이 상한도 설정할 수 있습니다.
3. 미리보기는 저장하지 않은 설정을 실제로 실행하므로, 저장 전에 모델이나 지침을 테스트할 수 있습니다. 미리보기 요청도 잔액에서 차감됩니다.
4. 저장한 뒤 임베드 코드를 복사하세요.

임베드 코드

<script src="https://api14.com/widget.js" data-widget="YOUR_WIDGET_ID" async></script>

위젯이 나타나야 할 위치의 <body> 안에 태그를 넣으세요. 옵션은 다음과 같습니다.

위젯은 격리된 Shadow DOM에 렌더링되므로 페이지 스타일이 위젯에 영향을 주지 않고 위젯도 페이지를 바꾸지 않습니다. 플로팅 버튼 배치를 선택하면 대신 하단 모서리의 버튼에서 열립니다.

허용 사이트

위젯은 설정, 위젯 사이트에 등록한 사이트의 요청에만 응답합니다. 한 줄에 도메인 하나씩 적으며, 도메인은 하위 도메인도 포함합니다(example.com은 www.example.com도 포함). 포트를 붙이면 해당 포트만 허용됩니다. 예를 들어 로컬 테스트에는 localhost:3000을 사용하세요. 대시보드 미리보기는 항상 동작합니다.

그 밖의 사이트의 페이지는 403 site_not_allowed를 받고 위젯이 렌더링되지 않습니다(브라우저 콘솔에 이유를 설명하는 한 줄이 표시됩니다).

이 검사는 브라우저의 Origin 헤더를 사용합니다. 브라우저는 이를 바꿀 수 없지만 브라우저 밖의 도구는 바꿀 수 있으므로, 사이트 목록은 비밀이 아니라 제한 수단으로 취급하세요. 비용의 상한은 아래의 지출 제어가 정합니다.

지출 제어

위젯은 공개되어 있으므로 비용은 본인만 바꿀 수 있는 한도로 제한됩니다.

최종 한도는 잔액입니다. $0이 되면 자금을 추가할 때까지 모든 위젯이 402 insufficient_balance를 반환합니다.

상태와 알림

위젯 목록에는 각 위젯의 마지막 사용 시점, 오늘의 지출과 요청 수, 그리고 해결할 수 있는 원인으로 위젯이 실패 중일 때의 마지막 오류가 표시됩니다. 원인은 잔액 부족, 제거된 모델, 도달한 지출 한도, 목록에 없는 사이트 등입니다. 위젯이 실패하면 이메일 받기를 켜면(설정, 위젯 제어) 위젯당 하루 최대 한 통의 이메일을 받습니다.

사용량은 위젯 요청을 위젯 이름과 요청이 발생한 사이트와 함께 보여 줍니다. 위젯별 또는 사이트별로 그룹화해 비교할 수 있습니다.

방문자에게 보이는 화면

• 채팅 답변은 스트리밍으로 표시되며 기본 서식(문단, 목록, 굵게, 기울임, 코드, 링크)을 지원합니다. 방문자가 같은 탭에서 페이지를 이동해도 대화가 유지됩니다.
• 중지 버튼으로 긴 답변을 끝낼 수 있으며, 오류가 나면 다시 시도 링크로 메시지를 다시 보냅니다.
• 이미지, 오디오, 동영상에는 다운로드 링크가 제공됩니다. 동영상은 백그라운드 작업으로 생성되며 준비되면 표시됩니다. 보통 몇 분 안에 완료됩니다.
• 방문자는 지침, 잔액, 모델의 원본 오류를 볼 수 없습니다. 본인이 설정한 오류 메시지(또는 중립적인 기본 메시지)가 보이고, 원인은 대시보드에서 본인에게만 표시됩니다.
• 비워 둔 문구는 계정 언어의 기본값을 사용합니다.