v0.4.0

OpenAPI 3.1.0

Odeslat úlohu generování videa

Felo API Support

MIT

Server

https://openapi.felo.ai

Klientské knihovny

Shell Curl

Odeslat úlohu generování videa

Vytvoří asynchronní úlohu generování videa a okamžitě vrátí task_id (HTTP 202). Opakovaně dotazujte GET /api/v1/videos/generations/{task_id}, dokud úloha neuspěje. Tělo požadavku lze zadat buď ploše ({model, prompt, ...}), nebo vnořeně ({model, input: {prompt, ...}}); pokud je objekt input přítomen, má přednost. Pole pro zpětné volání (callBackUrl / callback_url / callbackUrl) se ignorují.

Tři vzájemně výlučné režimy vstupu:

text-to-video: pouze prompt;
image-to-video (první/poslední snímek): first_frame_url (+ volitelný last_frame_url);
omni-reference: reference_image_urls / reference_video_urls / reference_audio_urls. Kombinace režimu prvního/posledního snímku s jakýmkoli multimodálním referenčním vstupem vrací 400 invalid_request_error.

Hlavičky

X-Request-Id
Typ: string

Volitelné ID požadavku volajícího, které se vrací pro diagnostiku.
X-Felo-Channel
Typ: string

Seřazené kódy veřejných kanálů oddělené čárkami. Pokud tuto hlavičku vynecháte, použije se default; default lze použít pouze samostatně. V režimu peněženky prochází default efektivní pořadí veřejných kanálů modelu v opačném směru, přeskakuje nepublikované nebo nedostupné kanály a vybere poskytovatele prvního dostupného kanálu. Zahrnuje dostupné endpointy tohoto poskytovatele se stejným ID modelu v upstreamu a stejnou úrovní služby. Explicitní kanály se ověřují v pořadí zadaném klientem; odešle se pouze skupina poskytovatele prvního kanálu. K automatickému přepnutí na jiné poskytovatele nedochází. Starší hlavičky poskytovatele nemohou přepsat směrování kanálů.

Tělo·VideoGenerationRequest

povinné

application/json

Vstup pro generování videa. Buď plochý ({model, prompt, ...}), nebo vnořený ({model, input: {...}}). Přednost má input. Musí se použít právě jeden režim vstupu; kombinace prvního/posledního snímku s multimodálními referenčními vstupy se odmítá.

model
Typ: string
povinné

Název modelu vystavený přes Felo, např. seedance-2.0-mini.
aspect_ratio
Typ: string enum
hodnoty
- 16:9
- 9:16
- 1:1
- 4:3
- 3:4
- 21:9
- adaptive
duration
Typ: integer
min:
4
max:
15

Integer numbers.
first_frame_url
Typ: string Formát: uri
generate_audio
Typ: boolean
input
Typ: object

Volitelný vnořený objekt vstupu; pokud je přítomen, mají jeho pole přednost před sourozeneckými poli.
- aspect_ratio
  Typ: string enum
  
  Poměr stran výstupu; adaptive sleduje poměr vstupního obrázku.
  
  hodnoty
  16:9
  9:16
  1:1
  4:3
  3:4
  21:9
  adaptive
- duration
  Typ: integer
  min:
  4
  max:
  15
  
  Délka výstupu v sekundách.
- first_frame_url
  Typ: string Formát: uri
  
  URL obrázku prvního snímku (režim image-to-video).
- generate_audio
  Typ: boolean
  
  Zda generovat synchronizovanou zvukovou stopu.
- last_frame_url
  Typ: string Formát: uri
  
  URL obrázku posledního snímku; musí se použít společně s first_frame_url.
- prompt
  Typ: string
  maximální délka:
  2000
  
  Prompt. Povinný pro režimy text-to-video a omni-reference.
- reference_audio_urls
  Typ: array string[] …3Formát: uri
  
  Zvukové klipy pro omni-reference.
- reference_image_urls
  Typ: array string[] …9Formát: uri
  
  Obrázky pro omni-reference. Vzájemně se vylučují s režimem prvního/posledního snímku.
- reference_video_urls
  Typ: array string[] …3Formát: uri
  
  Videa pro omni-reference. Vzájemně se vylučují s režimem prvního/posledního snímku. Uvedení videa mění jednotkovou cenu fakturace a připočítává délku vstupu k počtu tokenů.
- resolution
  Typ: string enum
  
  Rozlišení výstupu. Vyšší rozlišení spotřebovává více tokenů a je dražší.
  
  hodnoty
  480p
  720p
  1080p
  4k
- service_tier
  Typ: string | null
  
  V současnosti je podporována pouze hodnota default (standard). Vynechaná hodnota, null, aliasy a nepodporované řetězce se převedou na default; jiné typy vrací HTTP 400. Nakonfigurované kanály a ceny zůstávají beze změny. Textová API odesílají standardní hodnotu poskytovatele; rozhraní Decisions a rozhraní generování pole upstreamu vynechávají.
last_frame_url
Typ: string Formát: uri
prompt
Typ: string
maximální délka:
2000
reference_audio_urls
Typ: array string[] …3Formát: uri
reference_image_urls
Typ: array string[] …9Formát: uri
reference_video_urls
Typ: array string[] …3Formát: uri
resolution
Typ: string enum
hodnoty
- 480p
- 720p
- 1080p
- 4k

service_tier
Typ: string | null

V současnosti je podporována pouze hodnota default (standard). Vynechaná hodnota, null, aliasy a nepodporované řetězce se převedou na default; jiné typy vrací HTTP 400. Nakonfigurované kanály a ceny zůstávají beze změny. Textová API odesílají standardní hodnotu poskytovatele; rozhraní Decisions a rozhraní generování pole upstreamu vynechávají.

Odpovědi

202
Typ: object · VideoGenerationAccepted

Úloha přijata
kind
enum
const:
video
povinné
hodnoty
video
outputs
Typ: array string[]
povinné

Prázdné, dokud úloha neuspěje.

status
enum
const:
queued
povinné
hodnoty
queued
task_id
Typ: string
povinné

ID úlohy pro dotazování stavu.
application/json
400
Typ: object · GenerationError

Neplatný požadavek (neznámý model, smíšené režimy vstupu, neplatná pole)

Obálka chyb kompatibilní s OpenAI.
error
Typ: object
message
Typ: string
povinné
type
Typ: string enum
povinné
hodnoty
invalid_request_error
server_error
code
Typ: string
param
Typ: string může být null
application/json
401
Typ: object · GenerationError

Neplatný nebo chybějící API klíč Felo

Obálka chyb kompatibilní s OpenAI.
error
Typ: object
message
Typ: string
povinné
type
Typ: string enum
povinné
hodnoty
invalid_request_error
server_error
code
Typ: string
param
Typ: string může být null
application/json
402
Typ: object · GenerationError

Nedostatečný zůstatek / nesplněná podmínka fakturace

Obálka chyb kompatibilní s OpenAI.
error
Typ: object
message
Typ: string
povinné
type
Typ: string enum
povinné
hodnoty
invalid_request_error
server_error
code
Typ: string
param
Typ: string může být null
application/json
403
Typ: object · GenerationError

Účet nemá oprávnění (vyžadováno předplatné nebo je uživatel zablokován). Zakázané modely se odmítají ještě před voláním upstreamu. Již přijaté požadavky a úlohy pokračují.

Obálka chyb kompatibilní s OpenAI.
error
Typ: object
message
Typ: string
povinné
type
Typ: string enum
povinné
hodnoty
invalid_request_error
server_error
code
Typ: string
param
Typ: string může být null
application/json
429
Typ: object · GenerationError

Dosažen limit požadavků nebo utrácení

Obálka chyb kompatibilní s OpenAI.
error
Typ: object
message
Typ: string
povinné
type
Typ: string enum
povinné
hodnoty
invalid_request_error
server_error
code
Typ: string
param
Typ: string může být null
application/json
502
Typ: object · GenerationError

Selhání poskytovatele upstream

Obálka chyb kompatibilní s OpenAI.
error
Typ: object
message
Typ: string
povinné
type
Typ: string enum
povinné
hodnoty
invalid_request_error
server_error
code
Typ: string
param
Typ: string může být null
application/json
503
Typ: object · GenerationError

Služba generování nebo fakturační služba je dočasně nedostupná

Obálka chyb kompatibilní s OpenAI.
error
Typ: object
message
Typ: string
povinné
type
Typ: string enum
povinné
hodnoty
invalid_request_error
server_error
code
Typ: string
param
Typ: string může být null
application/json

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
}'

Zobrazit schéma

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

Úloha přijata

Odeslat úlohu generování videa

OvěřováníRequired

Odeslat úlohu generování videa