青云TOP API使用教程&开发文档小白用户&专业开发者快速使用指南
控制台
返回模型调用 API 参考
GET/fal-ai/veo3/requests/{request_id}

/fal-ai/veo3/requests/{request_id}

查询 Fal.ai 视频任务状态和结果。创建请求后保存 request_id，再按本页路径查询，只有成功终态才读取产物。

API Key none

查询 Fal.ai 视频任务状态和结果。创建请求后保存 request_id，再按本页路径查询，只有成功终态才读取产物。

功能与适用场景

本页用于查询已提交任务。它不创建新任务，也不接受 prompt、图片或视频生成字段。

支持模型与组合

路径模型：veo3。调用前用 GET /v1/models 检查完整模型 ID、分组权限和当前渠道；Fal.ai 官方模型页的更新不会自动改变本站 allowlist。
视频的时长、比例、分辨率、首帧图片和音频开关必须按本页 schema 组合，不能把其他视频模型的字段直接复制过来。

第一步：设置鉴权

请求头使用 Authorization: Bearer YOUR_API_KEY 和 Content-Type: application/json。不要发送 Fal Token，也不要把真实 API Key 写入前端、日志或仓库。

第二步：调用模型

请求地址：GET https://top.qingyuntop.ai/fal-ai/veo3/requests/{request_id}。将 model_name 和 request_id 原样替换为创建响应中的值。

Fal.ai 异步协议

调用与返回说明

查询 Fal.ai 视频任务。本站公开流程是提交/查询/读取结果；模型和参数是否对当前 API Key 开放，以 GET /v1/models、分组权限和实际响应为准。

请求时注意

  • 使用 `Authorization: Bearer YOUR_API_KEY`；这是青云TOP API Key，不是 Fal.ai Token。
  • 创建前调用 `GET /v1/models`，确认完整模型 ID、渠道和分组权限。官方模型页可用于能力参考，不能作为本站已开放承诺。
  • 查询请求只带路径参数，不要把创建任务的 prompt、图片或视频 Body 复制过来。
  • Fal.ai 官方还支持 queue、streaming 和 webhook；本站页面未声明的字段不能自行推断为可用。

返回时注意

  • HTTP 2xx 只表示请求被接受；业务结果以 status 和 output/result 字段为准。
  • 只有 completed/succeeded 才读取产物；failed、cancelled、超时或网络断开时保留 error 并停止下载。
  • 结果 URL 可能过期，成功后立即下载到自己的存储；不要把临时 URL 当作永久公共资源。
Request

请求

/fal-ai/veo3/requests/{request_id}

Body

可选

GET 请求无需 JSON 请求体，只需发送页面列出的请求头和路径、查询参数。

路径、查询与 Header 参数

参数位置类型必填说明示例
request_idPathstring是创建响应中的请求 ID。；原样保存，不拼接前缀。`REQUEST_ID`
model_namePathstring是Fal 模型路径。；使用当前页面对应的完整路径。`MODEL_NAME`
Response

返回响应 200

HTTP 响应
响应 200json
响应 200object
statusstring

任务状态。常见阶段为 queued、in_progress/processing、completed/succeeded、failed、cancelled；以实际响应为准。

示例queued
request_idstring

创建请求返回的公开请求 ID，后续查询时原样使用。

示例REQUEST_ID
response_urlstring

任务完成后读取结果的 URL；地址可能过期，应立即下载。

示例https://example.com/result.json
status_urlstring

查询状态的 URL。

示例https://top.qingyuntop.ai/fal-ai/model/requests/REQUEST_ID
cancel_urlstring

可取消任务的 URL，仅在当前任务状态允许时有效。

示例https://top.qingyuntop.ai/fal-ai/model/requests/REQUEST_ID/cancel
queue_positioninteger

排队位置，任务运行后可能缺省。

示例1
outputstring | array<string> | object

成功结果。图片、视频或文件可能以 URL、URL 数组或对象返回，按 schema 分支读取。

errorobject

失败详情；记录 code/message，不要把失败响应当作可下载结果。

Fal.ai 异步协议

调用与返回说明

查询 Fal.ai 视频任务。本站公开流程是提交/查询/读取结果；模型和参数是否对当前 API Key 开放，以 GET /v1/models、分组权限和实际响应为准。

请求时注意

  • 使用 `Authorization: Bearer YOUR_API_KEY`；这是青云TOP API Key，不是 Fal.ai Token。
  • 创建前调用 `GET /v1/models`，确认完整模型 ID、渠道和分组权限。官方模型页可用于能力参考，不能作为本站已开放承诺。
  • 查询请求只带路径参数，不要把创建任务的 prompt、图片或视频 Body 复制过来。
  • Fal.ai 官方还支持 queue、streaming 和 webhook；本站页面未声明的字段不能自行推断为可用。

返回时注意

  • HTTP 2xx 只表示请求被接受；业务结果以 status 和 output/result 字段为准。
  • 只有 completed/succeeded 才读取产物；failed、cancelled、超时或网络断开时保留 error 并停止下载。
  • 结果 URL 可能过期，成功后立即下载到自己的存储；不要把临时 URL 当作永久公共资源。

异步任务、查询与下载

查询到 completed 或 succeeded 后再读取 output、response_url 或媒体对象；failed、cancelled 和仍在排队的任务都不能当作成功。结果 URL 可能过期，建议成功后立即下载。

常见错误、限制与迁移

  • 401/403：API Key、分组权限或模型未开放；重新请求 GET /v1/models，不要改用 Fal Token。
  • 400/422：Body 字段、类型、媒体 URL、数组顺序或模型组合不符合本页 schema；先缩小到最小请求再逐项加入可选字段。
  • 429/5xx 或网络中断：按退避重试提交/查询；提交可能已经成功时不要盲目重复创建，先用已保存的 request ID 查询。
  • 页面中的 Apifox 快照用于结构化展示，模型是否最新以官方资料、本站当前模型目录和实际响应共同核对。

官方参考