介绍

欢迎使用即时写作官方 API 服务。

即时写作是是市场上最强大的一体化人工智能工具，旨在重新定义您的写作、沟通和完成工作的方式。在人工智能的驱动下，我们甚至进一步突破了界限。

使用即时写作提供的 API，可快速接入写作大模型，启动您的人工智能业务，让所有写作自动化，最大限度地提高绩效。

入门

本文档描述了构成官方 即时写作 JSON API 的资源。

如果您有任何问题或请求，请联系我们的 API 团队。

创建帐户

要访问 即时写作 API，请首先注册加入.

指南和条款

要使用 API，您必须遵守隐私政策条款并遵循用户协议。

全局说明

通用请求

请求域名

https://api.jishixiezuo.com/

用户认证

请通过 HTTP 授权标头 HEADER 传递应用程序的访问密钥：Authorization: YOUR_ACCESS_KEY

请务必保存好自己的密钥，你可以通过在后台设置中心设置白名单IP来限制请求服务器来源（默认关闭）。

参数名 必选 类型 说明 示例值
Authorization 是 string 用户密钥 e5ff6cf3a14e1c72deefe8a512469af6

错误码

错误码及描述

错误码 描述 说明
200 Success 成功
100101 InvalidParams 缺少参数或无效的参数
100201 Unauthorized 未授权Authorization错误
100202 IpRestricted 请求 IP 受限，检查白名单
100300 InsufficientFunds 账户余额不足
100500 InternalError 内部错误

计费模式

以下是即时写作目前提供的 API 列表及对应的消耗值：

接口 限制 消耗
全部写作模板 每天限制 500 次 0u/次
按写作模板写作 无限制 2u/字

当接口规则失效或者接口没有内容返回的时候，即使查询也不会消耗u数。

注册成功后可以充值消费，¥1元 = 1000u。

如果需要定制 API 服务，请联系客服。

开放接口

全部榜单列表

描述

获得今日热榜全站全部榜单列表。

地址

https://api.tophubdata.com/nodes

方法

GET

参数

参数名 必选 类型 说明 示例值
p 否 int 翻页页码，每页100条 1

可以递归查询，当返回的条数 <100 的时候中断递归，=100 的时候 p++ 来实现自动翻页获取所有节点。

cURL 请求示例

curl --location 'https://api.tophubdata.com/nodes?p=1' --header 'Authorization: YOUR_ACCESS_KEY'

可以复制上面示例到 Postman 这类型调试工具直接运行。

返回示例

  {
    "error":false,
    "status":200
    "data": [
        {
            "hashid": "KqndgxeLl9",
            "name": "微博",
            "display": "热搜榜",
            "domain": "weibo.com",
            "logo": "********"
        },
        {
            "hashid": "mproPpoq6O",
            "name": "知乎",
            "display": "热榜",
            "domain": "zhihu.com",
            "logo": "********"
        }
        ...
    ]
  }

返回参数说明

参数名 类型 说明 示例值
hashid varchar 榜单hashid mproPpoq6O（注意 hashid 严格区分大小写）
name varchar 网站名称 知乎
display varchar 内容类型 热榜
domain varchar 域名 zhihu.com
logo varchar 图标 **

单个榜单最新详细

描述

获得指定榜单的最新榜单或最新更新的内容列表。数据排序即为最新榜单排序。本接口一次性返回最新榜单全部内容，不用翻页。

地址

https://api.tophubdata.com/nodes/@hashid

@hashid 为全部榜单列表获取到的 hashid，注意 hashid 严格区分大小写。

方法

GET

cURL 请求示例

curl --location 'https://api.tophubdata.com/nodes/mproPpoq6O' --header 'Authorization: YOUR_ACCESS_KEY'

可以复制上面示例到 Postman 这类型调试工具直接运行。

返回示例

  {
    "error":false,
    "status":200
    "data": {
        "hashid": "mproPpoq6O",
        "name": "知乎",
        "display": "热榜",
        "domain": "zhihu.com",
        "logo": "********",
        "items": [
            {
                "extra": "455 万热度",
                "url": "https://www.zhihu.com/question/629047878",
                "thumbnail": "https://pica.zhimg.com/80/v2-00a693d9ac81c601223512d5725cbacd_1440w.png",
                "description": "美联储加息周期终于似要走到尽头了。 ",
                "title": "美元大跳水，10 年期美债收益率大跌，离岸人民币大涨 400 点，美股五连阳，美联储加息周期到头了吗？"
            },
            {
                "extra": "206 万热度",
                "url": "https://www.zhihu.com/question/621684259",
                "thumbnail": "https://pic3.zhimg.com/50/v2-0e599dcb44ad61215462fdfbb58d983e_qhd.jpg",
                "description": "感觉老一辈的亲戚总是不知道一些边界感，每次都无下限的打探我的个人问题和生活，弄得我非常的不适。要怎么样才能有礼貌的进行回应呢？",
                "title": "过节聚餐时总感到亲戚在惯性「侵犯」我的边界，是我太敏感还是「亲戚PTSD」在作祟？"
            }
            ...
        ]
    }
  }

返回参数说明

参数名 类型 说明
hashid varchar 榜单节点 Hashid
name varchar 网站名称
display varchar 内容类型
domain varchar 域名 zhihu.com
logo varchar 图标 **
items/title varchar 标题
items/description varchar 描叙
items/thumbnail varchar 缩略图
items/url varchar 地址
items/extra unknown 附加内容，可能是任意格式内容

单个榜单历史数据集

描述

获得榜单指定日期当天上榜的所有历史数据集，需要指定日期，一次性返回当天所有上榜数据，排序为上榜时间从先到后，本接口仅用来获取今天以前的历史日期数据，不返回当天数据。本接口一次性返回当天所有内容，不用翻页。

地址

https://api.tophubdata.com/nodes/@hashid/historys

@hashid 为全部榜单列表获取到的 hashid，注意 hashid 严格区分大小写。

方法

GET

参数

参数名 必选 类型 说明 示例值
date 是 String 日期Y-m-d 2023-01-01

cURL 请求示例

curl --location 'https://api.tophubdata.com/nodes/mproPpoq6O/historys?date=2023-11-04' --header 'Authorization: YOUR_ACCESS_KEY'

可以复制上面示例到 Postman 这类型调试工具直接运行。

返回示例

  {
    "error":false,
    "status":200
    "data": [
        {
            "extra": "455 万热度",
            "url": "https://www.zhihu.com/question/629047878",
            "thumbnail": "https://pica.zhimg.com/80/v2-00a693d9ac81c601223512d5725cbacd_1440w.png",
            "description": "美联储加息周期终于似要走到尽头了。 ",
            "title": "美元大跳水，10 年期美债收益率大跌，离岸人民币大涨 400 点，美股五连阳，美联储加息周期到头了吗？",
            "time" : 1699095601
        },
        {
            "extra": "206 万热度",
            "url": "https://www.zhihu.com/question/621684259",
            "thumbnail": "https://pic3.zhimg.com/50/v2-0e599dcb44ad61215462fdfbb58d983e_qhd.jpg",
            "description": "感觉老一辈的亲戚总是不知道一些边界感，每次都无下限的打探我的个人问题和生活，弄得我非常的不适。要怎么样才能有礼貌的进行回应呢？",
            "title": "过节聚餐时总感到亲戚在惯性「侵犯」我的边界，是我太敏感还是「亲戚PTSD」在作祟？",
            "time" : 1699095601
        }
        ...
    ]
  }

返回参数说明

参数名 类型 说明
title varchar 标题
description varchar 描叙
thumbnail varchar 缩略图
url varchar 地址
extra unknown 附加内容，可能是任意格式内容
time int 10位时间戳(上榜时间)

SDK 接入

演示 DEMO

注意，请勿在客户端直接调用 API，务必使用自己的服务器嵌套接口使用，同一 ACCESS_KEY 频繁变化请求 IP 会被系统直接禁用。以下是常见后端开发语言演示 Demo：

接口过于简单，大家也可以自己封装。