Hooked

Hooked Video API

创建 professional AI videos programmatically. Works with TikTok, Instagram, YouTube, and more.

Authentication

All 请求s require an x-API-key header with your Hooked API key.

# 获取 your API key at https://hooked.so/设置tings/API 导出 HOOKED_API_KEY="your_API_key_here"

Base URL https://API.hooked.so

Core 端点s 创建 Script-to-Video

创建 a video from a script with an AI avatar that lip-同步s.

POST /v1/project/创建/script-to-video

{ "script": "Hey everyone! Today I'm going to show you...", "avatarId": "avatar_sophia_casual", "voiceId": "voice_en_sarah", # optional "musicId": "music_upbeat_01", # optional "captionStyle": "karaoke", # optional: karaoke, word-by-word, none "网页hook": "https://your.网页hook/url" # optional }

# 响应 { "videoId": "vid_abc123", "状态": "processing", "estimatedSeconds": 45 }

创建 Prompt-to-Video

Let AI 生成 the script, visuals, and narration from a simple prompt.

POST /v1/project/创建/prompt-to-video

{ "prompt": "创建 a 30-second product video for a fitness 应用 tar获取ing young professionals", "avatarId": "avatar_marcus_professional", # optional, AI picks if not specified "voiceId": "voice_en_james", # optional "网页hook": "https://your.网页hook/url" # optional }

创建 TikTok Slideshow

创建 viral TikTok-style slideshow content.

POST /v1/project/创建/tiktok-slideshow

{ "title": "5 Productivity Tips for Remote Workers", "slides": [ { "text": "Tip 1: 启动 your day with deep work", "imageUrl": "https://..." }, { "text": "Tip 2: Batch your meetings", "imageUrl": "https://..." }, { "text": "Tip 3: Take walking breaks", "imageUrl": "https://..." } ], "voiceId": "voice_en_sarah", # optional "musicId": "music_chill_01", # optional "网页hook": "https://..." # optional }

创建 UGC Ad

创建 authentic UGC-style product ads.

POST /v1/project/创建/ugc-ads

{ "script": "Okay so I've been using this 应用 for 2 weeks and...", "avatarId": "avatar_emma_casual", "productUrl": "https://mystore.com/product", # optional, 提取s visuals "hook": "停止 scrolling! You need to see this", # optional "cta": "Link in bio", # optional "网页hook": "https://..." # optional }

Resource 端点s 列出 Avatars

Browse avAIlable AI avatars.

获取 /v1/avatar/列出

# 响应 { "avatars": [ { "id": "avatar_sophia_casual", "name": "Sophia", "gender": "female", "style": "casual", "previewUrl": "https://...", "tags": ["young", "ener获取ic", "lifestyle"] }, ... ] }

列出 Voices

Browse avAIlable AI voices.

获取 /v1/voice/列出

# 响应 { "voices": [ { "id": "voice_en_sarah", "name": "Sarah", "language": "en", "accent": "american", "style": "conversational", "previewUrl": "https://..." }, ... ] }

列出 Music

Browse background music 追踪s.

获取 /v1/music/列出

# 响应 { "追踪s": [ { "id": "music_upbeat_01", "name": "Upbeat Energy", "mood": "ener获取ic", "duration": 60, "previewUrl": "https://..." }, ... ] }

Video Management 获取 Video 状态

检查 video rendering 进度 and 获取 下载 URL.

获取 /v1/video/{videoId}

# 响应 { "videoId": "vid_abc123", "状态": "completed", # processing, completed, fAIled "进度": 100, "下载Url": "https://...", "duration": 32, "创建dAt": "2024-01-15T10:30:00Z" }

列出 Videos

列出 recent videos 创建d by your team.

获取 /v1/video/列出?limit=20

# 响应 { "videos": [ { "videoId": "vid_abc123", "状态": "completed", "title": "Product Demo", "duration": 32, "创建dAt": "2024-01-15T10:30:00Z" }, ... ] }

Trend Discovery 获取 Trending Videos

Discover what's trending for content inspiration.

获取 /v1/trends/videos?平台=tiktok&niche=fitness

# 响应 { "trends": [ { "title": "30-day ab challenge", "平台": "tiktok", "views": 2300000, "engagement": "high", "hook": "Day 1 vs Day 30 结果s...", "tags": ["fitness", "trans格式化ion", "challenge"] }, ... ] }

查询 parameters:

平台: tiktok, youtube, instagram (optional) niche: fitness, tech, beauty, food, etc. (optional) 网页hooks

All creation 端点s accept a 网页hook URL. When the video is ready, we'll POST:

{ "event": "video.completed", "videoId": "vid_abc123", "状态": "completed", "下载Url": "https://...", "duration": 32 }

Error Handling { "error": { "code": "INVALID_AVATAR", "message": "Avatar 'avatar_xyz' not found. Use 获取 /v1/avatar/列出 to see avAIlable avatars." } }

Common error codes:

INVALID_API_KEY: 检查 your x-API-key header INVALID_AVATAR: Avatar ID not found INVALID_VOICE: Voice ID not found SCRIPT_TOO_LONG: Script exceeds maximum length (5000 chars) RATE_LIMITED: Too many 请求s, wAIt