首页 > 开发者 API

开发者 API

ipshequ.com 开放对外 API，开发者与 AI 智能体可用密钥直接调用「上传素材 / 文字转语音 / 创建对口型视频 / 查询任务」，无需网页操作。所有接口返回的文件地址均为完整 URL，可直接下载。

🎁 免费试用 无需注册

每个设备/IP 限领一次，赠送 1200 算力（约 3 条测试视频），试用密钥 72 小时有效，试用文案限 50 字。用完或过期后到官网注册购买算力，申请正式密钥即可无限调用。

curl -X POST https://www.ipshequ.com/api/open/trial -H 'Content-Type: application/json' -d '{}'

🔑 鉴权

所有开放接口需在请求头携带密钥：

Authorization: Bearer sk-你的密钥
# 也可使用 x-api-key: sk-你的密钥

正式密钥：注册登录后进入「我的 → API 开放服务」创建，每账户最多 5 个，完整密钥仅创建时返回一次，请妥善保存。

📡 接口详情

POST 上传素材

https://www.ipshequ.com/api/open/upload
上传视频或音频文件，返回可访问的完整 URL，供后续接口引用。
参数：file：视频或音频文件（multipart/form-data，单文件 ≤200MB）
返回：{ success, url }
计费：免费

POST 文字转语音

https://www.ipshequ.com/api/open/audio/tts
将文字合成为语音，可上传声音样本克隆音色；不传样本则用系统默认声音。
参数：text：必填，要合成的文字｜speed：可选，语速 0.5~1.8，默认 1｜reference_audio：可选，声音样本音频文件
返回：{ success, audio_url, duration, cost, voice_id, balance }
计费：60 算力 / 30秒（按文字预估时长，合成失败全额退还）

POST 创建对口型视频

https://www.ipshequ.com/api/open/video/create
上传形象视频，用文字或驱动音频生成对口型视频（异步任务，返回 task_id）。
参数：avatar_video：必填，形象视频｜text：文字模式必填｜speed：可选语速｜reference_audio：可选声音样本，不传则自动用形象视频原声｜audio：可选驱动音频，优先级高于 text｜callback_url：可选，完成后回调
返回：{ success, task_id, status, cost }
计费：300 算力 / 30秒（按音频时长）

GET 查询视频任务

https://www.ipshequ.com/api/open/video/task/:id
轮询任务状态，完成后返回成片下载地址与缩略图（均为完整域名 URL，可直接下载）。
参数：id：路径参数，任务号
返回：{ success, task_id, status, queue_no, result_url, thumbnail_url, audio_duration, cost, error }
计费：免费

💻 完整调用示例

# 1) 领取免费试用密钥（返回 api_key）
curl -X POST https://www.ipshequ.com/api/open/trial -H 'Content-Type: application/json' -d '{}'

# 2) 用返回的 api_key 创建对口型视频（文字模式）
curl -X POST https://www.ipshequ.com/api/open/video/create -H 'Authorization: Bearer sk-trial-xxx' -F 'avatar_video=@/path/to/avatar.mp4' -F 'text=你好，这是一条测试视频'

# 3) 轮询任务，status=done 后下载 result_url
curl https://www.ipshequ.com/api/open/video/task/612 -H 'Authorization: Bearer sk-trial-xxx'

# 4) 下载成片（result_url 为完整域名地址，可直接下载）
curl -o output.mp4 '<result_url>'

任务状态 status：init(语音合成中) / ready(排队中) / processing(合成中) / done(完成) / failed(失败)。

💰 计费

按算力计费，与网页端一致：文字转语音 60 算力 / 30秒，对口型视频 300 算力 / 30秒，上传与查询免费；合成失败全额退还。注册即送体验算力，试用用完可到 官网 购买。