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

需要帮助?