Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

提交影片生成任務

伺服器:https://openapi.felo.ai
用戶端程式庫

提交影片生成任務

​

採用 OpenRouter 風格的平鋪影片輸入。Felo 的模型 ID、頻道、任務 ID 與回應格式維持不變。舊的 input 包裝與供應商原生欄位會被拒絕。不支援回呼、續接生成、供應商選項與影片超解析度。模型與頻道的能力可能會進一步限制這些參數。回傳 HTTP 202 與 Felo 的 task_id。輪詢 GET /api/v1/videos/generations/{task_id}。不支援的欄位回傳 HTTP 400。

請求標頭
  • X-Request-Id
    類型: string

    選用的呼叫方請求 ID,會回傳以供診斷使用。

  • X-Felo-Channel
    類型: string

    依序排列、以逗號分隔的公開頻道代碼。省略此標頭即使用 default;default 必須單獨使用。在錢包模式下,default 會反向掃描模型實際生效的公開頻道順序,略過未發布或不可用的頻道,並選用第一個可用頻道所屬的供應商。它會納入該供應商底下具有相同上游模型 ID 與服務層級的可用端點。明確指定的頻道會依用戶端指定的順序驗證;只會提交第一個頻道所屬的供應商群組。不會自動回退至其他供應商。舊版的供應商標頭無法覆寫頻道路由。

請求本文·VideoGenerationRequest
必填
application/json

採用 OpenRouter 風格的平鋪影片輸入。Felo 的模型 ID、頻道、任務 ID 與回應格式維持不變。舊的 input 包裝與供應商原生欄位會被拒絕。不支援回呼、續接生成、供應商選項與影片超解析度。模型與頻道的能力可能會進一步限制這些參數。

  • model
    類型: string
    最小長度:  
    1
    必填
  • aspect_ratio
    類型: string 列舉
    值
    • 16:9
    • 9:16
    • 1:1
    • 4:3
    • 3:4
    • 3:2
    • 2:3
    • 21:9
    • 9:21
  • character_orientation
    類型: string 列舉

    Required by supported Kling motion-control models: orientation source.

    值
    • image
    • video
  • duration
    類型: integer
    最小值:  
    1

    Integer numbers.

  • frame_images
    類型: array object[]
    • frame_type
      類型: string 列舉
      必填
      值
      • first_frame
      • last_frame
    • image_url
      必填
      • url
        類型: string
        最小長度:  
        1
        必填
        • 類型: string
      • file_id
        類型: string
        最大長度:  
        80

        Uploaded Felo file owned by the authenticated user.

    • type
      列舉
      常數:  
      image_url
      必填
      值
      • image_url
  • generate_audio
    類型: boolean
  • input_references
    類型: array
      • image_url
        必填
        • url
          類型: string
          最小長度:  
          1
          必填
          • 類型: string
        • file_id
          類型: string
          最大長度:  
          80

          Uploaded Felo file owned by the authenticated user.

      • type
        列舉
        常數:  
        image_url
        必填
        值
        • image_url
  • prompt
    類型: string
  • provider
    類型: object
    • options
      類型: object
      必填

      Options keyed by the slug published in the model catalog provider_options.

      • propertyName
        類型: object
  • resolution
    類型: string 列舉
    值
    • 360p
    • 480p
    • 720p
    • 768p
    • 1080p
    • 1K
    • 2K
    • 4K
  • seed
    類型: integer

    Integer numbers.

  • session_id
    類型: string
    最大長度:  
    256
  • size
    類型: string
  • trace
    類型: object
    • generation_name
      類型: string
    • parent_span_id
      類型: string
    • span_name
      類型: string
    • trace_id
      類型: string
    • trace_name
      類型: string
    • propertyName
      類型: anything
  • user
    類型: string
    最大長度:  
    256
回應
  • 202
    類型: object · VideoGenerationAccepted

    已接受任務

    • kind
      列舉
      常數:  
      video
      必填
      值
      • video
    • outputs
      類型: array string[]
      必填

      在任務成功前為空。

    • status
      列舉
      常數:  
      queued
      必填
      值
      • queued
    • task_id
      類型: string
      必填

      用於輪詢的任務 ID。

    application/json
  • 400
    類型: object · GenerationError

    請求無效(未知模型、混用輸入模式、欄位無效)

    相容於 OpenAI 的錯誤封裝。

    • error
      類型: object
      • message
        類型: string
        必填
      • type
        類型: string 列舉
        必填
        值
        • invalid_request_error
        • server_error
      • code
        類型: string
      • param
        類型: string 可為 null
    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
  • 402
    類型: object · GenerationError

    餘額不足/未符合計費要求

    相容於 OpenAI 的錯誤封裝。

    • error
      類型: object
      • message
        類型: string
        必填
      • type
        類型: string 列舉
        必填
        值
        • invalid_request_error
        • server_error
      • code
        類型: string
      • param
        類型: string 可為 null
    application/json
  • 403
    類型: object · GenerationError

    此帳戶無使用權限(需要訂閱,或使用者已遭停權)。已停用的模型同樣會在上游呼叫前遭到拒絕。已受理的請求與任務將繼續執行。

    相容於 OpenAI 的錯誤封裝。

    • error
      類型: object
      • message
        類型: string
        必填
      • type
        類型: string 列舉
        必填
        值
        • invalid_request_error
        • server_error
      • code
        類型: string
      • param
        類型: string 可為 null
    application/json
  • 429
    類型: object · GenerationError

    已達請求或消費上限

    相容於 OpenAI 的錯誤封裝。

    • error
      類型: object
      • message
        類型: string
        必填
      • type
        類型: string 列舉
        必填
        值
        • invalid_request_error
        • server_error
      • code
        類型: string
      • param
        類型: string 可為 null
    application/json
  • 502
    類型: 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 post/api/v1/videos/generations
curl https://openapi.felo.ai/api/v1/videos/generations \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "model": "veo-3.1-lite",
  "prompt": "A cinematic camera move",
  "duration": 4,
  "resolution": "720p",
  "generate_audio": false,
  "frame_images": [
    {
      "type": "image_url",
      "frame_type": "first_frame",
      "image_url": {
        "url": "https://example.com/first.png"
      }
    }
  ]
}'
{
  "task_id": "string",
  "status": "queued",
  "kind": "video",
  "outputs": [
    "string"
  ]
}
Submit a video generation task

需要協助嗎?