BuildShip

Tích hợp CometAPI với các workflow BuildShip bằng node CometAPI Text Generator, trigger REST API và tích hợp dựa trên key để tạo văn bản.

BuildShip là một công cụ xây dựng backend trực quan low-code. Sử dụng node cộng đồng CometAPI Text Generator để thêm khả năng tạo văn bản bằng AI vào bất kỳ workflow nào.

​

Điều kiện tiên quyết

• Một tài khoản CometAPI có API key đang hoạt động — lấy tại đây
• Một tài khoản BuildShip — đăng nhập tại đây

1. Lấy API key CometAPI của bạn

   Đăng nhập vào bảng điều khiển CometAPI. Nhấp vào Add API Key và sao chép key sk-xxxxx của bạn.

   

   
2. Tạo một workflow với REST API trigger

   1. Trong bảng điều khiển BuildShip, nhấp vào Create a new workflow → From Scratch.
   2. Trên canvas, nhấp vào Add Trigger và chọn REST API. Thao tác này sẽ tạo một endpoint có thể gọi được cho workflow.
3. Thêm node CometAPI Text Generator

   1. Bên dưới REST API trigger, nhấp vào + Add a new step.
   2. Trong ô tìm kiếm của thư viện node, nhập cometapi.
   3. Từ danh sách Community, chọn CometAPI Text Generator.

   

   
4. Liên kết integration CometAPI

   Bước này cho node biết cần sử dụng hệ thống quản lý key nào.

   1. Nhấp vào node để mở Node Editor ở bên phải.
   2. Chuyển sang tab Settings.
   3. Trong Key-based Integration, mở danh sách thả xuống và chọn CometAPI.
   4. Nhấp vào nút Save màu xanh ở góc trên bên phải.

   
5. Thêm API key của bạn vào node

   1. Trong Node Editor, chuyển sang tab Inputs (hoặc nhấp trực tiếp vào node).
   2. Nhấp vào biểu tượng key 🔑 ở góc trên bên phải của node để mở danh sách key.
   3. Chọn + Bring your own Key.
   4. Nhập Key ID (ví dụ: cometapi-key-1) và dán key sk-xxxxx của bạn vào Value.
   5. Nhấp vào Save.

   

   
6. Cấu hình các tham số đầu vào

   Trong tab Inputs của node:

   • Instructions (tùy chọn): đặt vai trò hệ thống, ví dụ: You are a productivity assistant.
   • Prompt: nhấp vào biểu tượng </>, sau đó chọn Trigger → Body → prompt để ánh xạ phần thân request gửi vào.
   • Advanced → Model: nhập model ID hiện tại mà bạn muốn sử dụng.

   
7. Thêm node Return Response và kiểm tra

   1. Bên dưới node CometAPI, nhấp vào + Add a new step và chọn Return Response.
   2. Trong trường Body, nhấp vào </> và chọn biến response từ node CometAPI Text Generator.
   3. Nhấp vào Test ở góc trên bên phải, chọn định dạng đầu vào JSON, rồi gửi:

   {
     "prompt": "hi"
   }
   

   4. Phản hồi thành công trong bảng Result xác nhận rằng workflow đang hoạt động.

   

   Nếu lệnh gọi thất bại, hãy kiểm tra lại API key của bạn và đảm bảo rằng Key-based Integration được đặt thành CometAPI, hoặc liên hệ bộ phận hỗ trợ CometAPI.

Bước Key-based Integration (liên kết node với CometAPI) là bắt buộc — nếu bỏ qua bước này, sẽ xảy ra lỗi xác thực ngay cả khi API key của bạn là chính xác.