Hướng Dẫn Sử Dụng API Viết Bài Kèm Hình Ảnh của Laho AI

Contents

1 1. Giới Thiệu Tổng Quan
2 2. Thông Số Endpoint
3 3. Cấu Trúc Yêu Cầu (Request Payload)
4 4. Ví Dụ Cách Gửi Yêu Cầu
- 4.1 a. Sử dụng cURL
- 4.2 b. Sử dụng JavaScript (Fetch API)
5 5. Cấu Trúc Phản Hồi (Response)
- 5.1 Giải Thích Chi Tiết:
6 6. Lưu Ý Khi Sử Dụng API
7 7. Kết Luận

1. Giới Thiệu Tổng Quan

API Generate Article được thiết kế nhằm tự động tạo ra bài viết hoàn chỉnh với nội dung được định dạng theo Markdown. Bạn chỉ cần gửi một chuỗi nội dung ban đầu, ví dụ như tiêu đề hoặc chủ đề chính, và API sẽ xử lý, mở rộng thành một bài viết có cấu trúc rõ ràng với các phần như giới thiệu, phân tích, so sánh và kết luận.

Trong ví dụ này, payload gửi đi là:

{ 
  "contents": "Pi Network Vs Bitcoin: So Sánh Hai Hệ Thống Tiền Điện Tử Hàng Đầu"
}

API sẽ trả về một đối tượng JSON chứa nội dung bài viết đã được tạo, đường dẫn hình ảnh liên quan và số lượng từ/ ký tự còn lại trong tài khoản của bạn.

2. Thông Số Endpoint

URL: https://api.laho.vn/api/generate-article
Phương thức: POST

Để sử dụng API này, bạn gửi một yêu cầu POST với payload dạng JSON chứa thông tin nội dung cần phát triển.

3. Cấu Trúc Yêu Cầu (Request Payload)

Payload của yêu cầu cần có ít nhất trường:

contents: Chuỗi văn bản chứa tiêu đề hoặc chủ đề chính mà bạn muốn bài viết hướng tới.

Ví dụ về payload:

{ 
  "contents": "Pi Network Vs Bitcoin: So Sánh Hai Hệ Thống Tiền Điện Tử Hàng Đầu"
}

Trong trường hợp này, API sẽ sử dụng nội dung chủ đề để xây dựng một bài viết so sánh chi tiết giữa hai hệ thống tiền điện tử hàng đầu.

4. Ví Dụ Cách Gửi Yêu Cầu

a. Sử dụng cURL

Bạn có thể gửi yêu cầu thông qua cURL trên terminal với đoạn mã sau:

curl -X POST https://api.laho.vn/api/generate-article \
     -H "Content-Type: application/json" \
     -d '{ 
           "contents": "Pi Network Vs Bitcoin: So Sánh Hai Hệ Thống Tiền Điện Tử Hàng Đầu"
         }'

b. Sử dụng JavaScript (Fetch API)

Dưới đây là ví dụ sử dụng Fetch API trong JavaScript:

fetch('https://api.laho.vn/api/generate-article', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    contents: "Pi Network Vs Bitcoin: So Sánh Hai Hệ Thống Tiền Điện Tử Hàng Đầu"
  })
})
.then(response => response.json())
.then(data => {
  console.log('Bài viết đã được tạo:', data.generated_content);
  console.log('Đường dẫn hình ảnh:', data.image_url);
  console.log('Số từ/ ký tự còn lại:', data.remaining_words);
})
.catch(error => {
  console.error('Có lỗi xảy ra:', error);
});

5. Cấu Trúc Phản Hồi (Response)

Khi gửi yêu cầu thành công, API sẽ trả về một đối tượng JSON với các trường chính:

generated_content: Đây là nội dung bài viết đã được tạo ra, định dạng theo Markdown. Nội dung này bao gồm các phần như giới thiệu, phân tích chi tiết, hình ảnh minh họa và kết luận.
image_url: Đường dẫn URL của hình ảnh minh họa đi kèm với bài viết.
remaining_words: Số lượng từ (hoặc ký tự) còn lại trong tài khoản của bạn (trong trường hợp có giới hạn).

Ví dụ về phản hồi mẫu:

{
  "generated_content": "## Giới thiệu về Tiền Điện Tử\n\nTrong thời đại công nghệ 4.0, tiền điện tử đã và đang trở thành một phần thiết yếu trong nền kinh tế số. ...\n\n![So sánh Pi Network với Bitcoin](https://cloudfront.goonus.io/wp-content/uploads/2024/04/12184923/so-sanh-pi-network-voi-bitcoin-2.png)\n\n## Các Nguyên Tắc Cơ Bản của Hai Đồng Tiền\n\n### Bitcoin\n\nBitcoin, ra đời vào năm 2009, ...\n\n### Pi Network\n\nRa mắt vào năm 2019, ...\n\n...",
  "image_url": "https://cloudfront.goonus.io/wp-content/uploads/2024/04/12184923/so-sanh-pi-network-voi-bitcoin-2.png",
  "remaining_words": 183774
}

Giải Thích Chi Tiết:

generated_content:
Bài viết được tạo ra sẽ bao gồm các mục như:
- Giới thiệu: Trình bày tổng quan về tiền điện tử và bối cảnh của chủ đề.
- Các nguyên tắc cơ bản: Phân tích các đặc điểm nổi bật của Bitcoin và Pi Network.
- So sánh: Cung cấp những hình ảnh, số liệu và nhận định giúp so sánh hiệu quả, công nghệ và tính khả dụng của hai đồng tiền.
- Triển vọng tương lai và kết luận: Đưa ra đánh giá tổng quát về tương lai của từng đồng tiền.
image_url:
Đường dẫn đến hình ảnh minh họa chủ đề được lựa chọn trong bài viết. Điều này giúp bài viết thêm phần trực quan và sinh động.
remaining_words:
Giá trị này cho biết số từ hoặc ký tự còn lại trong tài khoản của bạn (nếu API được giới hạn theo số lượng từ hoặc ký tự sử dụng).

6. Lưu Ý Khi Sử Dụng API

Định dạng Payload:
Đảm bảo payload gửi đi đúng định dạng JSON và chứa trường cần thiết. Bất kỳ sai sót nào có thể dẫn đến lỗi 400 (Bad Request).
Xử Lý Phản Hồi:
Nội dung được trả về ở dạng Markdown, bạn có thể sử dụng các thư viện hỗ trợ Markdown để hiển thị nội dung một cách đẹp mắt trên website hoặc ứng dụng của mình.
Giới Hạn Tài Nguyên:
Trường remaining_words cho biết hạn mức sử dụng còn lại, hãy theo dõi để tránh vượt quá giới hạn.

7. Kết Luận

API Generate Article của Laho AI là công cụ mạnh mẽ giúp bạn tự động tạo ra các bài viết chất lượng chỉ với một vài thao tác đơn giản. Với khả năng chuyển nội dung ban đầu thành bài viết có cấu trúc, hình ảnh minh họa và định dạng Markdown, API này rất hữu ích cho các nhà quản lý nội dung, chuyên gia SEO và các trang web cần làm mới nội dung thường xuyên.

Nếu bạn có bất kỳ thắc mắc hoặc cần hỗ trợ thêm, hãy liên hệ với đội ngũ kỹ thuật của Laho để được trợ giúp.