Hooked Video API

以编程方式创建专业AI视频。支持TikTok、Instagram、YouTube等平台。

身份验证

所有请求都需要在请求头中包含x-api-key字段，并填入你的Hooked API密钥。

bash

在 https://hooked.so/settings/api 获取你的API密钥

export HOOKEDAPIKEY=yourapikey_here

基础URL

https://api.hooked.so

核心接口

创建脚本转视频

通过脚本和AI虚拟形象创建视频，虚拟形象会进行口型同步。

bash
POST /v1/project/create/script-to-video

{
script: 大家好！今天我要向大家展示...,
avatarId: avatarsophiacasual,
voiceId: voiceensarah, # 可选
musicId: musicupbeat01, # 可选
captionStyle: karaoke, # 可选：karaoke, word-by-word, none
webhook: https://your.webhook/url # 可选
}

响应

{ videoId: vid_abc123, status: processing, estimatedSeconds: 45 }

创建提示词转视频

让AI根据简单的提示词自动生成脚本、画面和旁白。

bash
POST /v1/project/create/prompt-to-video

{
prompt: 为面向年轻专业人士的健身应用创建一个30秒的产品视频,
avatarId: avatarmarcusprofessional, # 可选，未指定则由AI选择
voiceId: voiceenjames, # 可选
webhook: https://your.webhook/url # 可选
}

创建TikTok幻灯片

创建病毒式传播的TikTok风格幻灯片内容。

bash
POST /v1/project/create/tiktok-slideshow

{
title: 远程工作者的5个效率技巧,
slides: [
{ text: 技巧1：从深度工作开始你的一天, imageUrl: https://... },
{ text: 技巧2：批量安排会议, imageUrl: https://... },
{ text: 技巧3：散步休息, imageUrl: https://... }
],
voiceId: voiceensarah, # 可选
musicId: musicchill01, # 可选
webhook: https://... # 可选
}

创建UGC广告

创建真实的UGC风格产品广告。

bash
POST /v1/project/create/ugc-ads

{
script: 好吧，我已经使用这个应用两周了...,
avatarId: avataremmacasual,
productUrl: https://mystore.com/product, # 可选，提取视觉元素
hook: 别划走了！你一定要看看这个, # 可选
cta: 链接在个人简介中, # 可选
webhook: https://... # 可选
}

资源接口

列出虚拟形象

浏览可用的AI虚拟形象。

bash
GET /v1/avatar/list

响应

{ avatars: [ { id: avatarsophiacasual, name: Sophia, gender: female, style: casual, previewUrl: https://..., tags: [young, energetic, lifestyle] }, ... ] }

列出语音

浏览可用的AI语音。

bash
GET /v1/voice/list

响应

{ voices: [ { id: voiceensarah, name: Sarah, language: en, accent: american, style: conversational, previewUrl: https://... }, ... ] }

列出音乐

浏览背景音乐曲目。

bash
GET /v1/music/list

响应

{ tracks: [ { id: musicupbeat01, name: Upbeat Energy, mood: energetic, duration: 60, previewUrl: https://... }, ... ] }

视频管理

获取视频状态

检查视频渲染进度并获取下载链接。

bash
GET /v1/video/{videoId}

响应

{ videoId: vid_abc123, status: completed, # processing, completed, failed progress: 100, downloadUrl: https://..., duration: 32, createdAt: 2024-01-15T10:30:00Z }

列出视频

列出你的团队最近创建的视频。

bash
GET /v1/video/list?limit=20

响应

{ videos: [ { videoId: vid_abc123, status: completed, title: Product Demo, duration: 32, createdAt: 2024-01-15T10:30:00Z }, ... ] }

趋势发现

获取热门视频

发现热门内容以获取灵感。

bash
GET /v1/trends/videos?platform=tiktok&niche=fitness

响应

{ trends: [ { title: 30天腹肌挑战, platform: tiktok, views: 2300000, engagement: high, hook: 第1天对比第30天的结果..., tags: [fitness, transformation, challenge] }, ... ] }

查询参数：

• - platform: tiktok, youtube, instagram（可选）
• niche: fitness, tech, beauty, food等（可选）

Webhooks

所有创建接口都接受一个webhookURL。当视频准备就绪时，我们会发送POST请求：

json
{
event: video.completed,
videoId: vid_abc123,
status: completed,
downloadUrl: https://...,
duration: 32
}

错误处理

json
{
error: {
code: INVALID_AVATAR,
message: 未找到虚拟形象avatar_xyz。请使用GET /v1/avatar/list查看可用的虚拟形象。
}
}

常见错误代码：

• - INVALIDAPIKEY：检查你的x-api-key请求头
• INVALIDAVATAR：未找到虚拟形象ID
• INVALIDVOICE：未找到语音ID
• SCRIPTTOOLONG：脚本超过最大长度（5000字符）
• RATE_LIMITED：请求过多，请等待后重试

定价

• - Pro版：39美元/月 — 150积分（约30个视频）
• 高级版：79美元/月 — 350积分（约70个视频）
• 至尊版：149美元/月 — 750积分（约150个视频）

技能本身是免费且开源的。你只需为视频生成付费。

速率限制

• - 每分钟60次请求

示例：完整工作流程

bash

1. 列出虚拟形象以找到合适的

curl -X GET https://api.hooked.so/v1/avatar/list \
-H x-api-key: $HOOKEDAPIKEY

2. 创建视频

curl -X POST https://api.hooked.so/v1/project/create/script-to-video \ -H x-api-key: $HOOKEDAPIKEY \ -H Content-Type: application/json \ -d { script: 嘿！在这个视频中，我将向你展示3个效率技巧..., avatarId: avatarsophiacasual, captionStyle: karaoke }

3. 检查状态（轮询直到完成）

curl -X GET https://api.hooked.so/v1/video/vid_abc123 \ -H x-api-key: $HOOKEDAPIKEY

4. 准备就绪后下载

使用响应中的downloadUrl

给代理的提示

1. 1. 如果用户未指定虚拟形象，始终先列出虚拟形象
2. 对于模糊的请求，使用提示词转视频 — 它会处理脚本生成
3. 检查视频状态并在渲染完成时通知用户
4. 当用户需要创意时，推荐热门内容