Chuyển đến nội dung chính
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

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.
Bảng điều khiển CometAPI hiển thị nút Add API Key
Chi tiết API key CometAPI với base URL
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.
Thư viện node BuildShip hiển thị CometAPI Text Generator trong kết quả tìm kiếm
Node CometAPI Text Generator đã được thêm vào canvas
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.
Tab Settings của Node Editor với Key-based Integration được đặt thành CometAPI
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.
Hộp thoại quản lý key với các trường Key ID và Value đã được điền
Node hiển thị key đã được liên kết thành công
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.
Node CometAPI với Instructions, Prompt và Model đã được cấu hình
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"
}
  1. Phản hồi thành công trong bảng Result xác nhận rằng workflow đang hoạt động.
Bảng kiểm tra BuildShip hiển thị phản hồi CometAPI thành cô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.