开放 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

参数类型必填说明
imagestring是图片 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

参数类型必填说明
textstring是合成文字,最多 500 字
voice_typestring否音色,默认 female_zhubo,见下表
voice_type音色适合
female_zhubo 女声主播 新闻播报 / 有声书,清晰自然
male_zhubo 男声主播 广告 / 解说,沉稳有力
male_rap 男声说唱 短视频 / 潮流,节奏感强
female_sichuan 女声四川话 方言 / 趣味,地方特色
male_db 男声低沉 故事 / 旁白,低沉磁性

视频解析 video_parse

参数类型必填说明
urlstring是平台分享页链接(含口令文案也可以)
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。

参数类型必填说明
videofile是multipart 文件,mp4/mov/webm/m4v/avi/mkv
durationint否视频时长(秒),不传按 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

参数类型必填说明
namestring是企业名称关键词,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 与必填参数
401Key 缺失/不存在检查 X-API-Key
402Key 额度用完联系站长提额或换 Key
403Key 已停用或功能未开启联系站长
404任务不存在 / 没有结果确认 task_id、换关键词
429超过 30 次/分钟降低频率或加重试退避
-1服务端或上游异常稍后重试
业务错误统一返回 HTTP 200,请以响应体里的 code 判断成败。

申请 Key

Key 由站长签发,可单独设置每日与总量上限。

需要接入请联系站长申请。

当前引擎

提示词反推:qwen / qwen-vl-max

视频解析、企业查询走 4dj.net 数据接口。