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

需要協助嗎?