章鱼哥AI接口文档

文档

POSThttps://zexapi.com/v1/videos
鉴权 Authorization: Bearer YOUR_API_KEY

使用 API Key 进行 Bearer 鉴权。JSON 请求设置 Content-Type: application/json;Multipart 请求由客户端自动生成 boundary。

Veo 视频延长(Remix)接口文档

接口地址

POST /v1/videos

功能说明

支持对已有视频进行延长处理(Remix),基于原视频内容生成续集视频。
模型:veo_3_1-fast-extend

时效性说明

视频延长有效期:视频生成后的 12 小时内可以进行延长处理,超过 12 小时可能失败。
说明:建议在视频生成后尽快进行延长操作,以确保延长功能正常工作。

请求方式

本接口支持两种提交方式:
multipart/form-data(推荐)
application/json

请求头

参数名类型必填说明
Authorizationstring是Bearer YOUR_API_KEY
Content-Typestring否multipart/form-data 或 application/json

请求参数

multipart/form-data 方式

参数名类型必填说明
modelstring是固定值:veo_3_1-fast-extend
remix_idstring是原视频的 video_id(格式:video_xxx)
promptstring是延长视频的提示词描述

remix_id 参数获取方法

remix_id 是原视频的 video_id,格式为 video_xxxx。有以下两种获取方法:
方法 1:从任务提交返回的 JSON 中获取(推荐)
在任务提交成功后,立即从返回的 JSON 中获取 data.remix_id 字段
例如:"remix_id": "video_56c98f84-001b-41ea-9542-5290279f4827"
方法 2:从任务提交返回的 JSON 中获取 data.size
如果返回的 JSON 中没有显示 data.remix_id,可以使用 data.size 字段
在任务提交成功时,data.size 字段的值与 remix_id 相同(格式:video_xxxx)
例如:"size": "video_56c98f84-001b-41ea-9542-5290279f4827"
注意:当任务状态变为处理中或完成时,data.size 可能会自动恢复为视频尺寸(如 "720x720")
注意:建议在任务提交成功后立即获取并保存 remix_id,避免后续状态变化导致字段值改变。

application/json 方式

{
  "model": "veo_3_1-fast-extend",
  "remix_id": "video_xxx",
  "prompt": "延长视频的提示词"
}

请求示例

multipart/form-data 示例

curl -X POST "https://your-gateway.com/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=veo_3_1-fast-extend" \
  -F "remix_id=video_56c98f84-001b-41ea-9542-5290279f4827" \
  -F "prompt=鼠标再次点一下,电脑关机了"

JSON 示例

curl -X POST "https://your-gateway.com/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo_3_1-fast-extend",
    "remix_id": "video_56c98f84-001b-41ea-9542-5290279f4827",
    "prompt": "鼠标再次点一下,电脑关机了"
  }'

响应参数

参数名类型说明
idstring任务ID
task_idstring任务ID(与id相同)
objectstring对象类型,固定值:video
modelstring使用的模型名称
statusstring任务状态:queued(排队中)、processing(处理中)、completed(已完成)、failed(失败)
progressnumber任务进度,0-100
created_atnumber创建时间戳(秒)
sizestring视频尺寸
remixed_from_video_idstring原视频ID

响应示例

任务处理中

{
  "id": "task_pMjFpn4z0keL4KoxrxRnwNAAmRcWSKp4",
  "task_id": "task_pMjFpn4z0keL4KoxrxRnwNAAmRcWSKp4",
  "object": "video",
  "model": "veo_3_1-fast-extend",
  "status": "in_progress",
  "progress": 10,
  "created_at": 1775647662,
  "size": "720x720",
  "remixed_from_video_id": "56c98f84-001b-41ea-9542-5290279f4827"
}

提交成功(排队中)

{
  "id": "task_pMjFpn4z0keL4KoxrxRnwNAAmRcWSKp4",
  "task_id": "task_pMjFpn4z0keL4KoxrxRnwNAAmRcWSKp4",
  "object": "video",
  "model": "veo_3_1-fast-extend",
  "status": "queued",
  "progress": 0,
  "created_at": 1775647662,
  "size": "720x720",
  "remixed_from_video_id": "56c98f84-001b-41ea-9542-5290279f4827"
}

查询任务状态

接口地址

GET /v1/videos/{task_id}

请求示例

curl -X GET "https://your-gateway.com/v1/videos/task_pMjFpn4z0keL4KoxrxRnwNAAmRcWSKp4" \
  -H "Authorization: Bearer YOUR_API_KEY"

任务完成响应示例

{
  "id": 857120,
  "created_at": 1775648631,
  "updated_at": 1775648745,
  "task_id": "task_ijG7C2LGkRMnZK9EvB0orFGe3Few6yFz",
  "platform": "1",
  "user_id": 4,
  "group": "default",
  "channel_id": 6,
  "quota": 30000,
  "action": "textGenerate",
  "status": "SUCCESS",
  "fail_reason": "",
  "result_url": "https://xxxxx.com/v1/videos/task_ijG7C2LGkRMnZK9EvB0orFGe3Few6yFz/content",
  "submit_time": 1775648631,
  "start_time": 0,
  "finish_time": 1775648745,
  "progress": "100%",
  "properties": {
    "input": "",
    "upstream_model_name": "veo_3_1-fast",
    "origin_model_name": "veo_3_1-fast"
  },
  "username": "otuapi",
  "data": {
    "id": "task_ijG7C2LGkRMnZK9EvB0orFGe3Few6yFz",
    "size": "720x1280",
    "model": "veo_3_1-fast",
    "object": "video",
    "status": "completed",
    "seconds": "1",
    "remix_id": "video_002546c9-ec66-405b-89ab-4d50cc59bb45",
    "video_url": "https://videos-us3.ss2.life/ai-sandbox-videofx/video/...",
    "created_at": 1775648631,
    "completed_at": 1775648733
  },
  "timestamp2string": "2026-04-08 19:43:51",
  "key": "857120"
}

注意事项

1.
延长时长:目前仅支持延长至 15 秒。
2.
时效性:视频生成后的 12 小时内可以进行延长处理,超过 12 小时可能失败。
3.
异步模式:提交成功仅返回任务 id,须轮询 GET /v1/videos/{task_id} 获取进度与结果。
4.
视频获取:任务完成后,通过 data.video_url 获取视频地址。