开放 API
一个端点、一个 Key,调用本站的视频解析、提示词反推、语音合成、企业查询。
接口未开放
站点暂未开放第三方调用。如果你是站长:后台 → 插件 → 创业者 API 工具箱 → 设置 → 打开「开放 API」。
快速开始
所有能力共用同一个地址,用 action 区分;请求头带 X-API-Key。参数支持 JSON 或表单。
接口地址
https://ai.zhongxintang.cn/aitoolsapi.htm请求方式
POST内容类型
application/json 或 application/x-www-form-urlencoded(上传视频用 multipart/form-data)鉴权
X-API-Key: cyzk_xxxxxxxx地址随站点伪静态设置自动变化;以后台「设置 → 开放 API → 接口地址」显示的为准(未开伪静态时形如
/index.php?aitoolsapi.htm)。curl -X POST 'https://ai.zhongxintang.cn/aitoolsapi.htm' \
-H 'X-API-Key: cyzk_你的密钥' \
-H 'Content-Type: application/json' \
-d '{"action":"tts","text":"你好,世界","voice_type":"female_zhubo"}'
返回:
{
"code": 0,
"message": "合成成功",
"data": {
"audio_url": "upload/cyz_aitools/tts/202611/xxxx.mp3",
"voice_name": "女声主播",
"text_length": 5,
"size_kb": 42.6,
"engine": "core",
"provider": "openai",
"model": "tts-1"
}
}
鉴权与额度
- Key 由站长在后台签发,格式
cyzk_+ 40 位十六进制;数据库只存 sha256 摘要,丢失只能重新签发。 - 把 Key 放在请求头
X-API-Key(推荐),或参数api_key。 - 每个 Key 可单独设置每日上限、总量上限;单 Key 限流 30 次/分钟。
- 返回里的
data.quota会告诉你该 Key 今日剩余次数。
接口一览
| action | 用途 | 必填参数 | 状态 |
|---|---|---|---|
prompt_image |
图片反推提示词 | image |
可用 |
tts |
文字转语音 | text |
可用 |
video_parse |
抖音/快手等视频直链解析 | url |
可用 |
prompt_video |
视频反推提示词(异步) | video(文件) |
可用 |
prompt_status |
查询视频反推结果 | task_id |
可用 |
company |
企业工商信息 | name |
可用 |
图片反推提示词 prompt_image
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
image | string | 是 | 图片 http(s) 地址,或 data:image/jpeg;base64,... |
data 字段:
prompt 提示词、engine(core=本站内置模型,remote=4dj)、provider、model、cost 扣点。curl -X POST 'https://ai.zhongxintang.cn/aitoolsapi.htm' \
-H 'X-API-Key: cyzk_你的密钥' \
-H 'Content-Type: application/json' \
-d '{"action":"prompt_image","image":"https://example.com/demo.jpg"}'
语音合成 tts
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
text | string | 是 | 合成文字,最多 500 字 |
voice_type | string | 否 | 音色,默认 female_zhubo,见下表 |
| voice_type | 音色 | 适合 |
|---|---|---|
female_zhubo |
女声主播 | 新闻播报 / 有声书,清晰自然 |
male_zhubo |
男声主播 | 广告 / 解说,沉稳有力 |
male_rap |
男声说唱 | 短视频 / 潮流,节奏感强 |
female_sichuan |
女声四川话 | 方言 / 趣味,地方特色 |
male_db |
男声低沉 | 故事 / 旁白,低沉磁性 |
视频解析 video_parse
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
url | string | 是 | 平台分享页链接(含口令文案也可以) |
data 字段:
video_url 直链、title、cover_url、author、platform、watermark、cost。curl -X POST 'https://ai.zhongxintang.cn/aitoolsapi.htm' \
-H 'X-API-Key: cyzk_你的密钥' \
-H 'Content-Type: application/json' \
-d '{"action":"video_parse","url":"https://v.douyin.com/xxxxxxx/"}'
视频反推提示词 prompt_video
异步任务:先提交视频拿 task_id,再轮询 prompt_status。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
video | file | 是 | multipart 文件,mp4/mov/webm/m4v/avi/mkv |
duration | int | 否 | 视频时长(秒),不传按 1 秒估算上限 |
curl -X POST 'https://ai.zhongxintang.cn/aitoolsapi.htm' \
-H 'X-API-Key: cyzk_你的密钥' \
-F 'action=prompt_video' \
-F 'duration=8' \
-F 'video=@demo.mp4'
# 拿到 task_id 后轮询
curl -X POST 'https://ai.zhongxintang.cn/aitoolsapi.htm' \
-H 'X-API-Key: cyzk_你的密钥' \
-H 'Content-Type: application/json' \
-d '{"action":"prompt_status","task_id":"xxxx"}'
status:
pending / processing / completed / failed;完成时 data.prompt 有内容。 企业查询 company
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
name | string | 是 | 企业名称关键词,2-60 字 |
data.list[] 含:
name、legal_person、reg_capital、reg_status、establish_time、credit_code、reg_location、business_scope。curl -X POST 'https://ai.zhongxintang.cn/aitoolsapi.htm' \
-H 'X-API-Key: cyzk_你的密钥' \
-H 'Content-Type: application/json' \
-d '{"action":"company","name":"腾讯科技"}'
JavaScript 调用示例
const res = await fetch('https://ai.zhongxintang.cn/aitoolsapi.htm', {
method: 'POST',
headers: {
'X-API-Key': 'cyzk_你的密钥',
'Content-Type': 'application/json'
},
body: JSON.stringify({ action: 'prompt_image', image: imageUrl })
});
const json = await res.json();
if (json.code === 0) {
console.log(json.data.prompt);
} else {
console.error(json.code, json.message);
}
浏览器直接调用会暴露 Key,请只在服务端或小程序云函数里使用。
错误码
| code | 含义 | 处理建议 |
|---|---|---|
0 | 成功 | — |
400 | 参数缺失或格式错误 | 检查 action 与必填参数 |
401 | Key 缺失/不存在 | 检查 X-API-Key |
402 | Key 额度用完 | 联系站长提额或换 Key |
403 | Key 已停用或功能未开启 | 联系站长 |
404 | 任务不存在 / 没有结果 | 确认 task_id、换关键词 |
429 | 超过 30 次/分钟 | 降低频率或加重试退避 |
-1 | 服务端或上游异常 | 稍后重试 |
业务错误统一返回 HTTP 200,请以响应体里的
code 判断成败。