메인 콘텐츠로 건너뛰기
BuildShip은 로우코드 비주얼 백엔드 빌더입니다. 커뮤니티 CometAPI Text Generator 노드를 사용해 어떤 워크플로에도 AI 기반 텍스트 생성을 추가할 수 있습니다.

사전 준비 사항

1

CometAPI API 키 가져오기

CometAPI 콘솔에 로그인합니다. Add API Key를 클릭하고 sk-xxxxx 키를 복사합니다.
Add API Key 버튼이 표시된 CometAPI 대시보드
base URL이 포함된 CometAPI API 키 세부 정보
2

REST API 트리거로 워크플로 생성하기

  1. BuildShip 대시보드에서 Create a new workflow → From Scratch를 클릭합니다.
  2. 캔버스에서 Add Trigger를 클릭하고 REST API를 선택합니다. 그러면 워크플로를 호출할 수 있는 엔드포인트가 생성됩니다.
3

CometAPI Text Generator 노드 추가하기

  1. REST API 트리거 아래에서 + Add a new step를 클릭합니다.
  2. 노드 라이브러리 검색창에 cometapi를 입력합니다.
  3. Community 목록에서 CometAPI Text Generator를 선택합니다.
검색 결과에 CometAPI Text Generator가 표시된 BuildShip 노드 라이브러리
캔버스에 추가된 CometAPI Text Generator 노드
4

CometAPI 연동 연결하기

이 단계에서는 노드가 어떤 키 관리 시스템을 사용할지 지정합니다.
  1. 노드를 클릭해 오른쪽의 Node Editor를 엽니다.
  2. Settings 탭으로 전환합니다.
  3. Key-based Integration에서 드롭다운을 열고 CometAPI를 선택합니다.
  4. 오른쪽 상단의 파란색 Save 버튼을 클릭합니다.
Key-based Integration이 CometAPI로 설정된 Node Editor Settings 탭
5

노드에 API 키 추가하기

  1. Node Editor에서 Inputs 탭으로 전환합니다(또는 노드를 직접 클릭합니다).
  2. 노드 오른쪽 상단의 🔑 키 아이콘을 클릭해 키 드롭다운을 엽니다.
  3. + Bring your own Key를 선택합니다.
  4. Key ID(예: cometapi-key-1)를 입력하고 Valuesk-xxxxx 키를 붙여넣습니다.
  5. Save를 클릭합니다.
Key ID와 Value 필드가 채워진 키 관리 대화상자
키가 성공적으로 바인딩된 상태를 보여주는 노드
6

입력 파라미터 구성하기

노드의 Inputs 탭에서 다음을 설정합니다:
  • Instructions (선택 사항): 시스템 역할을 설정합니다. 예: You are a productivity assistant.
  • Prompt: </> 아이콘을 클릭한 다음 Trigger → Body → prompt를 선택해 들어오는 요청 본문을 매핑합니다.
  • Advanced → Model: 사용하려는 현재 model ID를 입력합니다.
Instructions, Prompt, Model이 구성된 CometAPI 노드
7

Return Response 노드 추가 및 테스트

  1. CometAPI 노드 아래에서 + Add a new step를 클릭하고 Return Response를 선택합니다.
  2. Body 필드에서 **</>**를 클릭하고 CometAPI Text Generator 노드의 response 변수를 선택합니다.
  3. 오른쪽 상단의 Test를 클릭하고 JSON 입력 형식을 선택한 다음, 다음을 전송합니다:
{
  "prompt": "hi"
}
  1. Result 패널에서 성공 응답이 표시되면 워크플로가 정상적으로 작동하는 것입니다.
성공적인 CometAPI 응답이 표시된 BuildShip 테스트 패널
호출이 실패하면 API 키와 Key-based Integration이 CometAPI로 설정되어 있는지 확인하거나, CometAPI 지원팀에 문의하세요.
Key-based Integration 단계(노드를 CometAPI에 연결하는 단계)는 필수입니다 — 이 단계를 건너뛰면 API 키가 올바르더라도 인증 오류가 발생합니다.