Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

Video oluşturma görevi gönderin

Felo API Support
MIT
Sunucu:https://openapi.felo.ai
İstemci Kitaplıkları
Shell Curl

Video oluşturma görevi gönderin

​

Eşzamansız bir video oluşturma görevi başlatır ve hemen bir task_id döndürür (HTTP 202). Başarılı olana kadar GET /api/v1/videos/generations/{task_id} adresini yoklayın. İstek gövdesi düzleştirilmiş ({model, prompt, ...}) ya da iç içe ({model, input: {prompt, ...}}) biçimde verilebilir; input nesnesi mevcutsa öncelik kazanır. callback alanları (callBackUrl / callback_url / callbackUrl) yok sayılır.

Birbirini dışlayan üç giriş modu:

  • metinden videoya: yalnızca prompt;
  • görselden videoya (ilk/son kare): first_frame_url (+ isteğe bağlı last_frame_url);
  • çoklu referans: reference_image_urls / reference_video_urls / reference_audio_urls. İlk/son kareyi herhangi bir çok modlu referans girdisiyle karıştırmak 400 invalid_request_error döndürür.
Başlıklar
  • X-Request-Id
    Tür: string

    Tanılama için geri yansıtılan isteğe bağlı çağıran istek kimliği.

  • X-Felo-Channel
    Tür: string

    Virgülle ayrılmış sıralı genel kanal kodları. Varsayılanı kullanmak için bu başlığı atlayın; default tek başına kullanılmalıdır. Cüzdan modunda default, modelin geçerli genel kanal sırasını tersten tarar, yayımlanmamış veya kullanılamayan kanalları atlar ve ilk kullanılabilir kanalın sağlayıcısını seçer. Aynı üst kaynak model kimliğine ve hizmet katmanına sahip, o sağlayıcıya ait kullanılabilir uç noktaları içerir. Açıkça belirtilen kanallar istemcinin belirttiği sırayla doğrulanır; yalnızca ilk kanalın sağlayıcı grubu gönderilir. Diğer sağlayıcılara otomatik geçiş yapılmaz. Eski sağlayıcı başlıkları kanal yönlendirmesini geçersiz kılamaz.

Gövde·VideoGenerationRequest
gerekli
application/json

Video oluşturma girdisi. Düzleştirilmiş ({model, prompt, ...}) veya iç içe ({model, input: {...}}) olabilir. input öncelik kazanır. Tam olarak bir giriş modu kullanılmalıdır; ilk/son karenin çok modlu referans girdileriyle karıştırılması reddedilir.

  • model
    Tür: string
    gerekli

    Felo tarafında görünen model adı, ör. seedance-2.0-mini.

  • aspect_ratio
    Tür: string enum
    değerler
    • 16:9
    • 9:16
    • 1:1
    • 4:3
    • 3:4
    • 21:9
    • adaptive
  • duration
    Tür: integer
    min:  
    4
    maks:  
    15

    Integer numbers.

  • first_frame_url
    Tür: string Biçim: uri
  • generate_audio
    Tür: boolean
  • input
    Tür: object

    İsteğe bağlı iç içe input nesnesi; mevcut olduğunda alanları kardeş alanlara göre öncelik kazanır.

    • aspect_ratio
      Tür: string enum

      Çıktı en-boy oranı; adaptive, girdi görselinin oranını izler.

      değerler
      • 16:9
      • 9:16
      • 1:1
      • 4:3
      • 3:4
      • 21:9
      • adaptive
    • duration
      Tür: integer
      min:  
      4
      maks:  
      15

      Çıktı süresi, saniye cinsinden.

    • first_frame_url
      Tür: string Biçim: uri

      İlk kare görsel URL'si (görselden videoya modu).

    • generate_audio
      Tür: boolean

      Eşzamanlı bir ses parçası oluşturulup oluşturulmayacağı.

    • last_frame_url
      Tür: string Biçim: uri

      Son kare görsel URL'si; first_frame_url ile birlikte kullanılmalıdır.

    • prompt
      Tür: string
      maksimum uzunluk:  
      2000

      İstem. Metinden videoya ve çoklu referans modlarında gereklidir.

    • reference_audio_urls
      Tür: array string[] …3Biçim: uri

      Çoklu referans ses klipleri.

    • reference_image_urls
      Tür: array string[] …9Biçim: uri

      Çoklu referans görselleri. İlk/son kareyle birlikte kullanılamaz.

    • reference_video_urls
      Tür: array string[] …3Biçim: uri

      Çoklu referans videoları. İlk/son kareyle birlikte kullanılamaz. Video sağlamak faturalandırma birim fiyatını değiştirir ve token sayısına girdi süresini ekler.

    • resolution
      Tür: string enum

      Çıktı çözünürlüğü. Daha yüksek çözünürlük daha fazla token tüketir ve daha pahalıdır.

      değerler
      • 480p
      • 720p
      • 1080p
      • 4k
    • service_tier
      Tür: string | null

      Şu anda yalnızca default (standart) desteklenir. Atlanan, null, takma adlar ve desteklenmeyen dizeler default değerine döner; diğer türler HTTP 400 döndürür. Yapılandırılmış kanallar ve fiyatlar değişmez. Metin API'leri sağlayıcının standart değerini gönderir; Decisions ve oluşturma API'leri üst kaynak alanını atlar.

  • last_frame_url
    Tür: string Biçim: uri
  • prompt
    Tür: string
    maksimum uzunluk:  
    2000
  • reference_audio_urls
    Tür: array string[] …3Biçim: uri
  • reference_image_urls
    Tür: array string[] …9Biçim: uri
  • reference_video_urls
    Tür: array string[] …3Biçim: uri
  • resolution
    Tür: string enum
    değerler
    • 480p
    • 720p
    • 1080p
    • 4k
  • service_tier
    Tür: string | null

    Şu anda yalnızca default (standart) desteklenir. Atlanan, null, takma adlar ve desteklenmeyen dizeler default değerine döner; diğer türler HTTP 400 döndürür. Yapılandırılmış kanallar ve fiyatlar değişmez. Metin API'leri sağlayıcının standart değerini gönderir; Decisions ve oluşturma API'leri üst kaynak alanını atlar.

Yanıtlar
  • 202
    Tür: object · VideoGenerationAccepted

    Görev kabul edildi

    • kind
      enum
      sabit:  
      video
      gerekli
      değerler
      • video
    • outputs
      Tür: array string[]
      gerekli

      Görev başarılı olana kadar boş.

    • status
      enum
      sabit:  
      queued
      gerekli
      değerler
      • queued
    • task_id
      Tür: string
      gerekli

      Yoklama için kullanılacak görev kimliği.

    application/json
  • 400
    Tür: object · GenerationError

    Geçersiz istek (bilinmeyen model, karışık giriş modları, geçersiz alanlar)

    OpenAI uyumlu hata zarfı.

    • error
      Tür: object
      • message
        Tür: string
        gerekli
      • type
        Tür: string enum
        gerekli
        değerler
        • invalid_request_error
        • server_error
      • code
        Tür: string
      • param
        Tür: string null olabilir
    application/json
  • 401
    Tür: object · GenerationError

    Geçersiz veya eksik Felo API anahtarı

    OpenAI uyumlu hata zarfı.

    • error
      Tür: object
      • message
        Tür: string
        gerekli
      • type
        Tür: string enum
        gerekli
        değerler
        • invalid_request_error
        • server_error
      • code
        Tür: string
      • param
        Tür: string null olabilir
    application/json
  • 402
    Tür: object · GenerationError

    Yetersiz bakiye / faturalandırma koşulu karşılanmadı

    OpenAI uyumlu hata zarfı.

    • error
      Tür: object
      • message
        Tür: string
        gerekli
      • type
        Tür: string enum
        gerekli
        değerler
        • invalid_request_error
        • server_error
      • code
        Tür: string
      • param
        Tür: string null olabilir
    application/json
  • 403
    Tür: object · GenerationError

    Hesabın izni yok (abonelik gerekli veya kullanıcı yasaklanmış). Devre dışı modeller de üst kaynak çağrılarından önce reddedilir. Mevcut kabul edilmiş istekler ve görevler devam eder.

    OpenAI uyumlu hata zarfı.

    • error
      Tür: object
      • message
        Tür: string
        gerekli
      • type
        Tür: string enum
        gerekli
        değerler
        • invalid_request_error
        • server_error
      • code
        Tür: string
      • param
        Tür: string null olabilir
    application/json
  • 429
    Tür: object · GenerationError

    İstek veya harcama sınırına ulaşıldı

    OpenAI uyumlu hata zarfı.

    • error
      Tür: object
      • message
        Tür: string
        gerekli
      • type
        Tür: string enum
        gerekli
        değerler
        • invalid_request_error
        • server_error
      • code
        Tür: string
      • param
        Tür: string null olabilir
    application/json
  • 502
    Tür: object · GenerationError

    Üst kaynak sağlayıcı başarısız oldu

    OpenAI uyumlu hata zarfı.

    • error
      Tür: object
      • message
        Tür: string
        gerekli
      • type
        Tür: string enum
        gerekli
        değerler
        • invalid_request_error
        • server_error
      • code
        Tür: string
      • param
        Tür: string null olabilir
    application/json
  • 503
    Tür: object · GenerationError

    Oluşturma hizmeti veya faturalandırma hizmeti geçici olarak kullanılamıyor

    OpenAI uyumlu hata zarfı.

    • error
      Tür: object
      • message
        Tür: string
        gerekli
      • type
        Tür: string enum
        gerekli
        değerler
        • invalid_request_error
        • server_error
      • code
        Tür: string
      • param
        Tür: string null olabilir
    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": "seedance-2.0-mini",
  "prompt": "a cinematic trailer shot, 720p",
  "resolution": "720p",
  "duration": 5,
  "generate_audio": true
}'

{
  "task_id": "string",
  "status": "queued",
  "kind": "video",
  "outputs": [
    "string"
  ]
}

Görev kabul edildi

Submit a video generation task