身份验证
使用 API Key 调用接口，在请求中添加以下 HTTP 请求头。
Authorization: Bearer <YOUR_KEY>API 接入需要付费 Workspace；接口按实际使用计费。
POST/api/openapi/v1/videos/detail视频详情
接口价格0.1 积分 / 次成功查询
支持平台Instagram / YouTube / TikTok
快速调用示例 (cURL)
curl -X POST 'https://app.hicreator.ai/api/openapi/v1/videos/detail' \
-H 'Authorization: Bearer <YOUR_KEY>' \
-H 'Content-Type: application/json' \
-d '{
"video_url": "https://www.instagram.com/reel/EXAMPLE123/"
}'请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| video_url | string | 是 | 视频链接。 |
响应字段
| 参数名 | 类型 | 始终返回 | 说明 |
|---|---|---|---|
| requestId | string | 是 | 请求 ID，用于排查问题。 |
| billingRequestId | string | 是 | 计费记录 ID。 |
| data | object | 是 | 查询结果。 |
| data.platform | 'instagram' | 是 | 所属平台。 |
| data.canonicalUrl | string (URL) | 是 | 主页或内容链接。 |
| data.retrievedAt | string (ISO 8601) | 是 | 获取时间。 |
| data.video | object | 是 | 视频资料。 |
| data.video.id | string | 是 | 平台内内容 ID。 |
| data.video.contentType | 'post' | 'reel' | 'video' | 是 | 内容类型。 |
| data.video.title | string | 否 | 视频标题。 |
| data.video.description | string | 否 | 视频描述或帖子正文。 |
| data.video.thumbnailUrl | string (URL) | 否 | 封面链接。 |
| data.video.author | object | 否 | 作者资料。 |
| data.video.author.id | string | 否 | 平台内达人 ID。 |
| data.video.author.username | string | 否 | 账号名。 |
| data.video.author.displayName | string | 否 | 显示名称。 |
| data.video.author.avatarUrl | string (URL) | 否 | 作者头像链接。 |
| data.video.author.profileUrl | string (URL) | 否 | 作者主页链接。 |
| data.video.durationSeconds | number | 否 | 时长，单位：秒。 |
| data.video.publishedAt | string (ISO 8601) | 否 | 发布时间。 |
| data.video.metrics | object | 是 | 互动数据。 |
| data.video.metrics.viewCount | integer | 否 | 播放或观看次数。 |
| data.video.metrics.likeCount | integer | 否 | 点赞数。 |
| data.video.metrics.commentCount | integer | 否 | 评论数。 |
| data.video.metrics.shareCount | integer | 否 | 分享次数。 |
| data.video.platformDetails | object | 是 | 平台专属资料。 |
响应示例 (JSON)
{
"requestId": "<request-id>",
"billingRequestId": "<billing-request-id>",
"data": {
"platform": "instagram",
"canonicalUrl": "https://www.instagram.com/reel/EXAMPLE123/",
"retrievedAt": "2026-09-28T01:02:03.000Z",
"video": {
"id": "EXAMPLE123",
"contentType": "reel",
"description": "A day in Tokyo",
"thumbnailUrl": "https://example.com/cover.jpg",
"author": {
"id": "<creator-id>",
"username": "example_creator",
"displayName": "Example Creator",
"profileUrl": "https://www.instagram.com/example_creator/"
},
"durationSeconds": 30,
"publishedAt": "2026-09-01T12:00:00.000Z",
"metrics": {
"viewCount": 12000,
"likeCount": 500,
"commentCount": 30,
"shareCount": 12
},
"platformDetails": {}
}
}
}错误与重试
查看 error.message；排查时提供 requestId。结果不确定时请勿自动重试。
查看错误码
请求：400 参数无效（10001）或数量低于最低值（70004）；401 Key 无效（20001）；403 API 仅向付费 Workspace 开放（60006）；413 请求过大（10005）；415 格式不支持（10006）；429 请求过于频繁（10007）。
执行：404 Twitter 账号不存在或无法公开访问（60008）；422 搜索意图无效（60001）或目标账号无效（60002）；422 邮箱查找未完成（60009）：达到查找上限，全额退款，不代表无邮箱，请勿自动重试；502 邮箱查询失败（60003）或执行失败（60004）；504 请求超时（60005）。网关错误页转换为 API_UPSTREAM_ERROR JSON；不要自动重试付费请求。
积分：402 余额不足（70001）或超过每日限额（70006）；409 当前功能不可用（70002）或积分记录冲突（70003）。API 错误包含 error.code、error.message 和 error.requestId；业务错误在扣费开始后包含 error.billingRequestId，网关兜底可能缺少此字段，也不能据此确认退款状态。