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와 서비스 티어를 가진 해당 공급자의 사용 가능한 엔드포인트도 포함합니다. 명시적 채널은 클라이언트가 지정한 순서로 검증되며, 첫 번째 채널의 공급자 그룹만 제출됩니다. 다른 공급자로의 자동 fallback은 없습니다. 레거시 공급자 헤더로는 채널 라우팅을 재정의할 수 없습니다.

본문·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

도움이 필요하신가요?

  • API, 결제, 계정 관련 문의는 지원에서 안내해 드립니다.
  • Discord에서 Felo 개발자와 대화해 보세요.
  • 변경 내역을 확인해 보세요.
  • 대량 구매 가격이나 구매 관련 도움이 필요하신가요? 영업팀 문의.
  • LLM으로 구축 중이신가요? llms.txt를 읽어 보세요.