Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

轮询视频生成任务

服务器:https://openapi.felo.ai
客户端库

轮询视频生成任务

​

返回当前任务状态。当 status 为 succeeded 时,outputs 中包含可匿名下载的带签名媒体 URL(https://openapi.felo.ai/api/v1/media/{file_id}?exp=...&sig=...)。请每隔 5-10 秒轮询一次;任务本身会在后台继续执行。

路径参数
  • task_id
    类型: string
    必填

    POST /api/v1/videos/generations 返回的任务 ID。

响应
  • 200
    类型: object · VideoGenerationTask

    当前任务状态

    • kind
      枚举
      常量:  
      video
      必填
      值
      • video
    • outputs
      类型: array string[] 格式: uri
      必填
    • status
      类型: string 枚举
      必填
      值
      • queued
      • running
      • succeeded
      • failed
      • interrupted
    • task_id
      类型: string
      必填
    • error
      类型: object

      任务失败时出现。

      • code
        类型: string

        Stable failure code, e.g. file_not_found.

      • message
        类型: string
      • param
        类型: string | null
      • type
        类型: string
    application/json
  • 401
    类型: object · GenerationError

    Felo API 密钥无效或缺失

    兼容 OpenAI 的错误封装。

    • error
      类型: object
      • message
        类型: string
        必填
      • type
        类型: string 枚举
        必填
        值
        • invalid_request_error
        • server_error
      • code
        类型: string
      • param
        类型: string 可为 null
    application/json
  • 404
    类型: object · GenerationError

    未找到该账户下的任务

    兼容 OpenAI 的错误封装。

    • error
      类型: object
      • message
        类型: string
        必填
      • type
        类型: string 枚举
        必填
        值
        • invalid_request_error
        • server_error
      • code
        类型: string
      • param
        类型: string 可为 null
    application/json
  • 503
    类型: object · GenerationError

    生成服务暂时不可用

    兼容 OpenAI 的错误封装。

    • error
      类型: object
      • message
        类型: string
        必填
      • type
        类型: string 枚举
        必填
        值
        • invalid_request_error
        • server_error
      • code
        类型: string
      • param
        类型: string 可为 null
    application/json
Request Example for get/api/v1/videos/generations/{task_id}
curl 'https://openapi.felo.ai/api/v1/videos/generations/{task_id}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "task_id": "string",
  "status": "queued",
  "kind": "video",
  "outputs": [
    "https://example.com"
  ],
  "error": {
    "message": "string",
    "type": "string",
    "code": "string",
    "param": null
  }
}
Poll a video generation task

需要帮助?