跳转到主要内容
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",
    "resultUrls": null,
    "imageUrls": null
  }
}
获取 Veo 3.1 视频生成任务的超高清 4K 版本。
遗留说明：如果任务是通过已弃用的回退路径生成的，本接口可能不适用。

​
使用说明

  • API 方法差异
    • 1080P 使用 GET: /api/v1/veo/get-1080p-video
    • 4K 使用 POST: /api/v1/veo/get-4k-video
  • 积分消耗
    • 4K 需要 额外积分。
    • 额外费用大约 相当于 2 次“快速模式 (Fast mode)”视频生成（详情请参阅 定价详情 了解最新信息）。
  • 支持的宽高比
    • 16:9 和 9:16 任务均支持升级到 1080P 和 4K。
  • 处理时间
    • 4K 生成需要大量额外处理时间——通常根据负载情况约为 5-10 分钟。
  • 如果 4K 视频尚未准备好，接口可能会返回非 200 状态码。请稍候并重试（建议间隔为 30 秒以上），直到获取到结果。
对于生产环境，我们建议使用 callBackUrl 在 4K 生成完成时接收自动通知，而不是频繁轮询。

​
回调通知

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

4K 视频生成回调

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

​
错误响应

对同一任务 ID 重复提交请求时，系统会返回 422 状态码并提供具体的错误详情： 
{
  "code": 422,
  "msg": "4k is processing. It should be ready in 5-10 minutes. Please check back shortly.",
  "data": {
    "taskId": "veo_task_example123",
    "resultUrls": null,
    "imageUrls": null
  }
}

授权

​
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请求
  • 为确保回调安全性，请参阅 Webhook 校验指南 了解签名验证实现方法
  • 或者，您也可以使用获取视频详情接口来轮询任务状态
示例:

"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