BuildShip

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

​

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

• Một tài khoản CometAPI với 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 CometAPI API key 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 khóa <COMETAPI_KEY> 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 tạo ra 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 tích hợp CometAPI

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

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 khóa 🔑 ở góc trên bên phải của node để mở danh sách key thả xuống.
3. Chọn + Bring your own Key.
4. Nhập Key ID (ví dụ: cometapi-key-1) và dán khóa <COMETAPI_KEY> của bạn vào Value.
5. Nhấp 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 body của request đến.
• 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 workflow đang hoạt động.

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