Current Location: Home> Latest Articles> PHP Dynamic Sentence Display: Fetching Random Quotes Using Baidu Wenxin Yiyan API

PHP Dynamic Sentence Display: Fetching Random Quotes Using Baidu Wenxin Yiyan API

gitbox 2025-06-12

1. Overview

In website development, dynamic sentence displays are a common feature. For example, daily quotes or inspirational sayings on the homepage. Such sentences not only enhance interactivity but also improve user engagement. Baidu's Wenxin Yiyan API provides a rich set of random quotes, covering various fields like anime, games, novels, and more, allowing users to choose the type of quote they need.

2. API Introduction

The interface URL for the Baidu Wenxin Yiyan API is: https://v1.hitokoto.cn/. This API supports several parameters, making it flexible for users to fetch various types of sentences.

2.1 c Parameter

The c parameter specifies the type of sentence. Below are the available options:

  • ac: Anime
  • bg: Manga
  • bl: Novels
  • ct: Internet Slang
  • dy: Games
  • hw: Movies
  • kg: Original
  • lj: Quotes
  • mn: Celebrities
  • music: Music
  • my: Philosophy
  • novel: Ancient Texts
  • poetry: Poems
  • qb: Fun
  • sh: Poems
  • xs: Web Novels

For example, if you want to fetch sentences related to anime, you should set the c parameter to "ac".

2.2 encode Parameter

This parameter specifies the encoding format of the returned sentence. The default value is UTF-8.

2.3 charset Parameter

It specifies the character set for the returned sentences, such as UTF-8, GBK, GB2312, GB18030, etc.

2.4 length Parameter

This parameter specifies the maximum length of the sentence to return. For instance, length=5 will return a sentence with no more than 5 characters.

2.5 sign Parameter

This ensures the integrity of the API's response, preventing data tampering.

2.6 Acknowledgement

The API service provider includes an acknowledgment message in the response. Free users can make up to 1000 requests per day, and anything beyond that will require payment.

3. PHP Implementation of Dynamic Sentence Display

Here is a simple PHP implementation that shows a random quote on your webpage:


// Specify the sentence type as anime
$type = 'ac'; // Anime type
// Send HTTP request to fetch the quote
$api_url = 'https://v1.hitokoto.cn/?c=' . $type;
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);
// Process the result
$data = json_decode($result, true);
$text = $data['hitokoto'];

In the above code, we first set the sentence type to "anime". Then, we use the curl function to send an HTTP request to get the API response, and we decode the response into an array format. Finally, we output the random sentence on the webpage.

4. Using JavaScript for Dynamic Sentence Display

Besides PHP, JavaScript can also be used to implement random sentence display. Here is a simple JavaScript example:


// Specify the sentence type as internet slang
var type = 'ct'; // Internet slang type
// Send HTTP request to fetch the quote
var api_url = 'https://v1.hitokoto.cn/?c=' + type;
fetch(api_url)
  .then(response => response.json())
  .then(function(data) {
    // Process the result
    var text = data.hitokoto;
    var element = document.getElementById('quote');
    element.innerHTML = text;
  });

In this example, we specify the sentence type as "internet slang". Then we use the fetch method to send a request to the API, retrieve the JSON data, and fill the random sentence into a specified HTML element.

5. Conclusion

This article introduced how to implement dynamic sentence display on your webpage using Baidu's Wenxin Yiyan API. Whether using PHP or JavaScript, the API allows easy integration for displaying random quotes from various fields. By adjusting API parameters, you can customize the sentence types, enhancing website content and interactivity.

Related