提交影片生成任務
採用 OpenRouter 風格的平鋪影片輸入。Felo 的模型 ID、頻道、任務 ID 與回應格式維持不變。舊的 input 包裝與供應商原生欄位會被拒絕。不支援回呼、續接生成、供應商選項與影片超解析度。模型與頻道的能力可能會進一步限制這些參數。回傳 HTTP 202 與 Felo 的 task_id。輪詢 GET /api/v1/videos/generations/{task_id}。不支援的欄位回傳 HTTP 400。
- 類型: stringX
- Request - Id 選用的呼叫方請求 ID,會回傳以供診斷使用。
- 類型: stringX
- Felo - Channel 依序排列、以逗號分隔的公開頻道代碼。省略此標頭即使用 default;default 必須單獨使用。在錢包模式下,default 會反向掃描模型實際生效的公開頻道順序,略過未發布或不可用的頻道,並選用第一個可用頻道所屬的供應商。它會納入該供應商底下具有相同上游模型 ID 與服務層級的可用端點。明確指定的頻道會依用戶端指定的順序驗證;只會提交第一個頻道所屬的供應商群組。不會自動回退至其他供應商。舊版的供應商標頭無法覆寫頻道路由。
採用 OpenRouter 風格的平鋪影片輸入。Felo 的模型 ID、頻道、任務 ID 與回應格式維持不變。舊的 input 包裝與供應商原生欄位會被拒絕。不支援回呼、續接生成、供應商選項與影片超解析度。模型與頻道的能力可能會進一步限制這些參數。
- 類型: stringmodel最小長度:1必填
- 類型: string 列舉aspect
_ratio 值- 16:9
- 9:16
- 1:1
- 4:3
- 3:4
- 3:2
- 2:3
- 21:9
- 9:21
- 類型: string 列舉character
_orientation Required by supported Kling motion-control models: orientation source.
值- image
- video
- 類型: integerduration最小值:1
Integer numbers.
- 類型: array object[]frame
_images - frame類型: string 列舉
_type 必填值- first
_frame - last
_frame
- image
_url 必填- url類型: string最小長度:1必填
- 類型: string
- file類型: string
_id 最大長度:80Uploaded Felo file owned by the authenticated user.
- type列舉常數:image_url必填值
- image
_url
- 類型: booleangenerate
_audio - 類型: arrayinput
_references - image
_url 必填- url類型: string最小長度:1必填
- 類型: string
- file類型: string
_id 最大長度:80Uploaded Felo file owned by the authenticated user.
- type列舉常數:image_url必填值
- image
_url
- 類型: stringprompt
- 類型: objectprovider
- options類型: object必填
Options keyed by the slug published in the model catalog provider_options.
- property類型: object
Name
- 類型: string 列舉resolution值
- 360p
- 480p
- 720p
- 768p
- 1080p
- 1
K - 2
K - 4
K
- 類型: integerseed
Integer numbers.
- 類型: stringsession
_id 最大長度:256
- 類型: stringsize
- 類型: objecttrace
- generation類型: string
_name - parent類型: string
_span _id - span類型: string
_name - trace類型: string
_id - trace類型: string
_name - property類型: anything
Name
- 類型: stringuser最大長度:256
- 類型: object · VideoGenerationAccepted202
已接受任務
- 列舉kind常數:video必填值
- video
- 類型: array string[]outputs必填
在任務成功前為空。
- 列舉status常數:queued必填值
- queued
- 類型: stringtask
_id 必填用於輪詢的任務 ID。
application/json - 類型: object · GenerationError400
請求無效(未知模型、混用輸入模式、欄位無效)
相容於 OpenAI 的錯誤封裝。
- 類型: objecterror
- message類型: string必填
- type類型: string 列舉必填值
- invalid
_request _error - server
_error
- code類型: string
- param類型: string 可為 null
application/json - 類型: object · GenerationError401
Felo API 金鑰無效或未提供
相容於 OpenAI 的錯誤封裝。
- 類型: objecterror
- message類型: string必填
- type類型: string 列舉必填值
- invalid
_request _error - server
_error
- code類型: string
- param類型: string 可為 null
application/json - 類型: object · GenerationError402
餘額不足/未符合計費要求
相容於 OpenAI 的錯誤封裝。
- 類型: objecterror
- message類型: string必填
- type類型: string 列舉必填值
- invalid
_request _error - server
_error
- code類型: string
- param類型: string 可為 null
application/json - 類型: object · GenerationError403
此帳戶無使用權限(需要訂閱,或使用者已遭停權)。已停用的模型同樣會在上游呼叫前遭到拒絕。已受理的請求與任務將繼續執行。
相容於 OpenAI 的錯誤封裝。
- 類型: objecterror
- message類型: string必填
- type類型: string 列舉必填值
- invalid
_request _error - server
_error
- code類型: string
- param類型: string 可為 null
application/json - 類型: object · GenerationError429
已達請求或消費上限
相容於 OpenAI 的錯誤封裝。
- 類型: objecterror
- message類型: string必填
- type類型: string 列舉必填值
- invalid
_request _error - server
_error
- code類型: string
- param類型: string 可為 null
application/json - 類型: object · GenerationError502
上游供應商失敗
相容於 OpenAI 的錯誤封裝。
- 類型: objecterror
- message類型: string必填
- type類型: string 列舉必填值
- invalid
_request _error - server
_error
- code類型: string
- param類型: string 可為 null
application/json - 類型: object · GenerationError503
生成服務或計費服務暫時無法使用
相容於 OpenAI 的錯誤封裝。
- 類型: objecterror
- message類型: string必填
- type類型: string 列舉必填值
- invalid
_request _error - server
_error
- code類型: string
- param類型: string 可為 null
application/json
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"
]
}