# 随机诗词 > 随机返回一首古诗词，支持按 10 种主题筛选（抒情/四季/山水/天气/人物/生活/节日/动物/植物/食物）。 ## 1. 基本信息 | 字段 | 值 | | --- | --- | | 接口标识 | `shici` | | 接口名称 | 随机诗词 | | 接口地址 | `https://v1.apizero.cn/api/shici` | | 请求方法 | `POST` | | 分类 | content | | 提供方 | 极数本源 · ApiZero | | 计费模式 | 免费试用 | | 单次消耗 | 0 积分 | | 起步价 | — | | QPS 限制 | 5 req/s | | 每日免费额度 | 50 次（已认证用户） | | 匿名每日额度 | 30 次（无 API Key） | | VIP 免费 | 否 | | 调用总次数 | undefined | ## 2. 认证 携带 X-Api-Key 请求头可获得更高调用频度和更快速率 获取 API Key：登录 `https://apizero.cn/account/keys` 申请。 ## 3. 请求参数 | 参数 | 类型 | 必填 | 说明 | 示例 | | --- | --- | --- | --- | --- | | `type` | `string` | 否 | shuqing/siji/shanshui/tianqi/renwu/shenghuo/jieri/dongwu/zhiwu/shiwu | — | | `action` | `string` | 否 | 'types' 返回类型列表（不消耗调用额度） | — | ## 5. 请求示例 > AI 提示：以下 5 种语言示例都是可运行的，只需把 `YOUR_API_KEY` 替换为用户申请的实际 Key（https://apizero.cn/account/keys）。 > 优先选择用户问题中提到的语言；未指定时默认使用 Python。 ### cURL ```bash curl -X POST "https://v1.apizero.cn/api/shici" \ -H "X-Api-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "type": "", "action": "" }' ``` ### Python ```python import requests resp = requests.request( "POST", "https://v1.apizero.cn/api/shici", headers={"X-Api-Key": "YOUR_API_KEY", "Content-Type": "application/json"}, json={ "type": "", "action": "", }, timeout=15, ) resp.raise_for_status() print(resp.json()) ``` ### JavaScript (Node.js) ```javascript // Node.js 18+ / 浏览器原生 fetch const res = await fetch("https://v1.apizero.cn/api/shici", { method: "POST", headers: { "X-Api-Key": "YOUR_API_KEY", "Content-Type": "application/json", }, body: JSON.stringify({ "type": "", "action": "" }), }); if (!res.ok) throw new Error(`HTTP ${res.status}`); const data = await res.json(); console.log(data); ``` ### Go ```go package main import ( "bytes" "fmt" "io" "net/http" ) func main() { body := []byte(`{"type":"","action":""}`) req, _ := http.NewRequest("POST", "https://v1.apizero.cn/api/shici", bytes.NewBuffer(body)) req.Header.Set("X-Api-Key", "YOUR_API_KEY") req.Header.Set("Content-Type", "application/json") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() out, _ := io.ReadAll(resp.Body) fmt.Println(string(out)) } ``` ### PHP ```php "", "action" => "", ], JSON_UNESCAPED_UNICODE); $ch = curl_init("https://v1.apizero.cn/api/shici"); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => "POST", CURLOPT_POSTFIELDS => $payload, CURLOPT_HTTPHEADER => [ "X-Api-Key: YOUR_API_KEY", "Content-Type: application/json", ], CURLOPT_TIMEOUT => 15, ]); $body = curl_exec($ch); curl_close($ch); $data = json_decode($body, true); print_r($data); ``` ## 7. 响应示例 ```json { "code": 200, "message": "success", "data": {} } ``` --- **极数本源** · 全部 API: `https://apizero.cn/aidocs` · 人类版本：`https://apizero.cn/marketplace/shici` Source: `https://apizero.cn/aidocs/shici/raw.md` Last updated: 2026-05-29T19:14:08+08:00