Bắt đầu

Felo API Platform cung cấp cho bạn một khóa duy nhất cho các công cụ agent, giao thức mô hình, Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page và các API SuperAgent. Hãy bắt đầu tại đây, chọn công cụ bạn dùng, rồi làm theo hướng dẫn thiết lập riêng của công cụ đó.

Mới sử dụng? Đọc Tổng quan nền tảng để hiểu Model API, Data API và Felo API kết hợp với nhau như thế nào, hoặc đi thẳng đến Giao thức và SDK và Kênh và định tuyến nhà cung cấp.

Cấu hình Codex hoặc Claude Code bằng CLI

Khi đã có Node.js 22+ và công cụ AI của bạn, hãy chạy:

npx feloapi-cli setup

Làm theo hướng dẫn để dán khóa API Felo đầy đủ của bạn và chọn mô hình, Skills hoặc cả hai. Sau đó khởi chạy công cụ bằng npx feloapi-cli run codex hoặc npx feloapi-cli run claude-code.

Cài đặt và sử dụng CLI

Quy trình bắt đầu nhanh

1. Lấy khóa Felo API Platform và mua tín dụng dịch vụ khi cần; không bắt buộc phải có gói đăng ký.
2. Chọn công cụ AI hoặc nền tảng của bạn từ bảng bên dưới.
3. Mở hướng dẫn thiết lập tương ứng và dán base URL cùng khóa API của Felo.
4. Chạy một tác vụ nhỏ trong công cụ đó để xác nhận kết nối.
5. Thêm các API quy trình làm việc khi agent của bạn cần tìm kiếm, đầu ra văn phòng, trích xuất web, quy trình hình ảnh, LiveDocs hoặc SuperAgent.

Bước 1: Lấy khóa API của bạn

Felo API Platform dùng một khóa API chung cho các lệnh gọi API trực tiếp và các công cụ AI được hỗ trợ.

1. Mở trang API Keys của Felo API Platform.
2. Đăng nhập bằng tài khoản Felo nếu được yêu cầu.
3. Nhập tên khóa và nhấp Create Key.
4. Sao chép khóa đầy đủ khi nó xuất hiện. Khóa chỉ được hiển thị một lần.
5. Lưu khóa an toàn và dùng nó làm FELO_API_KEY.

Nạp tiền theo nhu cầu trong Console Billing từ $1. Bạn mua tín dụng dịch vụ định giá bằng USD cho mức sử dụng API thực tế. Không bắt buộc phải có gói đăng ký.

Đặt khóa làm biến môi trường:

export FELO_API_KEY="YOUR_API_KEY"

Windows PowerShell:

$env:FELO_API_KEY="YOUR_API_KEY"

Bước 2: Chọn công cụ AI của bạn

Nhấp vào công cụ bạn muốn dùng. Mỗi liên kết mở một hướng dẫn thiết lập riêng với base URL, biến môi trường và bước xác minh phù hợp.

Bước 3: Dùng đúng base URL

Hầu hết công cụ yêu cầu ba giá trị: khóa API, base URL và tên mô hình. Chọn base URL dựa trên giao thức mà công cụ hỗ trợ.

Nếu bạn không chắc máy khách của mình hỗ trợ chế độ nào, hãy bắt đầu với base URL tương thích OpenAI. Dùng base URL tương thích Anthropic cho Claude Code hoặc các máy khách yêu cầu rõ ràng endpoint Anthropic Messages.

Bước 4: Xác minh bằng một lệnh gọi API trực tiếp

Nếu bạn chỉ muốn xác nhận khóa của mình hoạt động, hãy gọi trực tiếp Chat API.

curl -X POST https://openapi.felo.ai/v2/chat \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Research the latest AI agent product trends"
  }'

Phản hồi thành công bao gồm câu trả lời, phân tích truy vấn và tài nguyên web.

{
  "status": "ok",
  "data": {
    "id": "HabCj883yHLSXc8mWqu4Eq",
    "message_id": "18ea8517-5559-4f48-a355-1f8a79e73b71",
    "answer": "...",
    "query_analysis": {
      "queries": ["AI agent product trends"]
    },
    "resources": [
      {
        "link": "https://example.com/report",
        "title": "AI Agent Market Report",
        "snippet": "..."
      }
    ]
  }
}

Bước 5: Thêm các API quy trình làm việc

Sau khi công cụ hoặc lệnh gọi API đầu tiên của bạn hoạt động, hãy kết nối các API phù hợp với tình huống của bạn.

Ví dụ API trực tiếp

Nếu bạn xây dựng trực tiếp trên API thay vì cấu hình công cụ AI, hãy bắt đầu với một trong các lệnh gọi tối giản sau.

Tạo tác vụ PPT

Dùng PPT Task API khi bạn muốn tạo bộ slide một cách bất đồng bộ. Phản hồi trả về task_id để bạn có thể thăm dò.

curl -X POST https://openapi.felo.ai/v2/ppts \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Create a 5-slide strategy deck about AI agents for office productivity"
  }'

Ví dụ phản hồi:

{
  "status": "ok",
  "message": null,
  "data": {
    "task_id": "019cad6d-e874-55ef-d577-686344b5a7e9",
    "livedoc_short_id": "PvyKouzJirXjFdst4uKRK3",
    "ppt_business_id": "BfLPuQKmChk9SPmyQawxgr"
  }
}

Thăm dò trạng thái tác vụ:

curl -X GET https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/status \
  -H "Authorization: Bearer $FELO_API_KEY"

Tạo tác vụ Landing Page

Dùng Landing Page Task API khi bạn muốn Felo tạo một landing page từ câu lệnh.

curl -X POST https://openapi.felo.ai/v2/landing_page \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Generate a launch landing page for an AI research assistant"
  }'

Ví dụ phản hồi:

{
  "status": "ok",
  "message": null,
  "data": {
    "task_id": "019cad6d-e874-55ef-d577-686344b5a7e9",
    "thread_short_id": "9qiLTmT77fA3aVurrMHvRJ"
  }
}

Thăm dò cùng endpoint trạng thái tác vụ mà tác vụ PPT sử dụng:

curl -X GET https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/status \
  -H "Authorization: Bearer $FELO_API_KEY"

Python

import os
import requests

api_key = os.environ["FELO_API_KEY"]

response = requests.post(
    "https://openapi.felo.ai/v2/chat",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    json={"query": "What are the latest AI agent product trends?"},
    timeout=60,
)

response.raise_for_status()
print(response.json()["data"]["answer"])

JavaScript (Node.js)

const response = await fetch("https://openapi.felo.ai/v2/chat", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.FELO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    query: "What are the latest AI agent product trends?",
  }),
});

if (!response.ok) {
  throw new Error(`Felo API request failed: ${response.status}`);
}

const result = await response.json();
console.log(result.data.answer);

Sự cố thiết lập thường gặp

Các bước tiếp theo

• Thiết lập Codex
• Thiết lập Claude Code
• Hướng dẫn xác thực
• Tham chiếu LLM API
• Tham chiếu Chat API
• Tham chiếu SuperAgent API