Skip to main content
POST

Autorização

string
obrigatório
Todos os endpoints da API exigem autenticação via Bearer TokenObtenha sua chave de API:Acesse a página de gerenciamento de chaves de API para obter sua chave de APIAdicione ao cabeçalho da requisição:

Modos de geração

O SkyReels V4 roteia automaticamente para o modo correto com base nos campos da requisição — nenhum campo mode é necessário:
Exclusão mútua estrita: campos I2V (first_frame_image / end_frame_image / mid_frame_images) e campos Omni (ref_images / ref_videos) não podem ser usados juntos, caso contrário retorna 422.
Mecanismo @tag: ao usar mid_frame_images / ref_images / ref_videos, cada elemento deve declarar uma tag começando com @ (por exemplo, @image1, @Actor-1, @video1), e a tag deve aparecer no prompt.Pense no prompt como o “roteiro” e na tag como um “ponteiro de personagem” para ativos específicos (imagens / vídeos). Por exemplo, um prompt como "@Actor-1 walks into the scene of @video1" instrui o sistema a injetar o sujeito da imagem de referência vinculada a @Actor-1 e a referência de movimento vinculada a @video1 no processo de geração.

Parâmetros da requisição

Campos gerais

string
obrigatório
Dois níveis de modelo estão disponíveis:
O campo model deve ser explicitamente fornecido — sem valor padrão.
O preço está fortemente vinculado à resolução e ao uso de ref_videos: 1080p é significativamente mais caro que 480p / 720p; os níveis com ref_videos (entrada de vídeo) custam ~1,5 a 2× em comparação com os que não usam. Saída simultânea de áudio e vídeo ainda não é suportada.
boolean
padrão:"false"
Define se o conteúdo deve ser moderado antes do envio da tarefa de vídeo.
  • true: verificar prompts e imagens de entrada com omni-moderation-latest
  • false ou omitido: não enviar solicitação de moderação, sem custo nem latência adicionais de moderação (padrão)
string
obrigatório
Prompt de texto, máximo de 1280 tokensDescreva cenas, sujeitos, ações e estilos em detalhes para obter melhores resultados de geração.Ao usar ref_images / ref_videos / mid_frame_images, o prompt deve conter a @tag correspondente (por exemplo, @Actor-1, @video1, @image1).Exemplo: "@Actor-1 walks through a neon-lit street at night."
integer
padrão:"5"
Duração do vídeo de saída (segundos)
  • Intervalo: [3, 15]
  • Padrão: 5
Quando ref_videos.type=reference é fornecido, duration é sobrescrito pela duração do vídeo de referência (máximo de 10 segundos).
string
padrão:"1080p"
Resolução do vídeoOpções:
  • 480p
  • 720p
  • 1080p (padrão)
string
padrão:"16:9"
Proporção de telaOpções:
  • 16:9 (padrão)
  • 4:3
  • 1:1
  • 9:16
  • 3:4
aspect_ratio é ignorado no modo I2V (a proporção de saída é determinada pela imagem de entrada); também é ignorado quando Omni é combinado com ref_videos.
boolean
padrão:"true"
Se deve otimizar automaticamente o promptQuando ativado, o sistema otimiza automaticamente seu prompt para obter melhores resultados de geração.

Campos específicos do I2V

string
URL da imagem do primeiro quadro (jpg / jpeg / png / gif / bmp)Quando fornecida, esta imagem é usada como o quadro inicial do vídeo.
string
URL da imagem do último quadro (jpg / jpeg / png / gif / bmp)Quando fornecida, esta imagem é usada como o quadro final do vídeo. Pode ser combinada com first_frame_image para controle do primeiro e do último quadro.
object[]
Lista de quadros-chave intermediários, até 6. Cada elemento tem a seguinte estrutura:

Campos específicos do Omni

object[]
Lista de imagens de referência (todos os elementos devem compartilhar o mesmo type). Cada elemento tem a seguinte estrutura:
object[]
Lista de vídeos de referência, até 1. Cada elemento tem a seguinte estrutura:

Cenários suportados

Os cenários a seguir são suportados por ambos skyreels-v4-fast e skyreels-v4-std:

Restrições de parâmetros

Violar qualquer um dos seguintes fará com que a requisição seja rejeitada com uma resposta 422, sem cobrança:

Resposta

integer
Código de status da resposta, 200 em caso de sucesso
array
Array de dados da resposta

Exemplos de requisição

Caso 1: Texto para vídeo (Mínimo)

Caso 2: Texto para vídeo (Parâmetros completos)

Caso 3: Imagem para vídeo - Primeiro quadro

Caso 4: Imagem para vídeo - Primeiro/Último quadro + quadros-chave intermediários

Caso 5: Omni - Referência de sujeito único

Caso 6: Omni - Múltiplos sujeitos + referência de movimento por vídeo

Este caso usa ref_videos.type=reference, então a duration solicitada será sobrescrita pela duração real do vídeo de referência (máximo de 10 segundos). Mesmo que "duration": 5 seja passado aqui, a duração final do vídeo segue o vídeo de referência.

Caso 7: Omni - Colagem em grade

Caso 8: Omni - Extensão de vídeo (extend)

Caso 9: Omni - Sincronização de áudio (orientada por voz)

Consultar resultados da tarefaA geração de vídeos é uma tarefa assíncrona que retorna um task_id no envio. Use o endpoint Obter status da tarefa para consultar o progresso e os resultados da geração.