跳转到主要内容
POST
/
api
/
v1
/
veo
/
get-4k-video
获取4K视频
curl --request POST \
  --url https://api.kie.ai/api/v1/veo/get-4k-video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "taskId": "veo_task_abcdef123456",
  "index": 0,
  "callBackUrl": "http://your-callback-url.com/4k-callback"
}
'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "veo_task_abcdef123456"
  }
}
获取 Veo3.1 视频生成任务的超高清 4K 版本。

​
使用说明

  • 视频生成任务成功后，系统会自动开始生成 4K 超高清版本
  • 4K 视频生成需要大量额外处理时间，建议在原视频生成完成后等待较长时间再调用本接口
  • 如果 4K 视频尚未准备好，接口可能返回错误信息
  • 4K 视频提供卓越的画质但需要更多处理资源和时间
对于生产环境，我们建议使用 callBackUrl 参数来接收生成完成时的自动通知，而不是轮询状态端点。

​
重要说明

  • 只有成功生成的视频任务才能获取 4K 的版本
  • 建议在收到视频生成成功回调后等待 5-10 分钟再调用本接口
  • 4K 视频文件较大，下载可能需要更长时间

​
回调通知

提交 4K 视频生成任务后，使用统一的回调机制来接收生成完成通知：

4K 视频生成回调

了解如何配置和处理 4K 视频生成回调通知

授权

​
Authorization
string
header
必填

所有 API 都需要通过 Bearer Token 进行认证。

获取 API Key：

  1. 访问 API Key 管理页面 获取您的 API Key

使用方法： 添加到请求头： Authorization: Bearer YOUR_API_KEY

注意：

  • 请妥善保管您的 API Key，不要与他人分享
  • 如果您怀疑 API Key 已泄露，请立即在管理页面重置

请求体

application/json
​
taskId
string
必填

任务ID

示例:

"veo_task_abcdef123456"

​
index
integer
默认值:0

视频索引

示例:

0

​
callBackUrl
string<uri>

用于接收4K视频生成任务完成更新的URL地址。可选但推荐在生产环境中使用。

  • 系统将在4K视频生成完成时向此URL发送POST请求，包含任务状态和结果
  • 回调包含生成的视频URL、媒体ID等内容
  • 您的回调端点应能接受包含结果的JSON载荷的POST请求
  • 或者，您也可以使用获取视频详情接口来轮询任务状态
示例:

"http://your-callback-url.com/4k-callback"

响应

请求成功

​
code
enum<integer>

响应状态码

  • 200: 成功 - 请求已成功处理
  • 401: 未授权 - 认证凭据缺失或无效
  • 404: 未找到 - 请求的资源或端点不存在
  • 422: 验证错误 - 请求参数验证失败。 记录为空。 暂时支持14天内的记录。 记录结果数据为空。 记录状态不是成功。 记录结果数据不存在。 记录结果数据为空。
  • 429: 请求限制 - 已超过该资源的请求限制
  • 451: 无法获取图片。请验证您或您的服务提供商设置的任何访问限制。
  • 455: 服务不可用 - 系统正在进行维护
  • 500: 服务器错误 - 处理请求时发生意外错误
可用选项:
200,
401,
404,
422,
429,
451,
455,
500
​
msg
string

响应消息

示例:

"success"

​
data
object