Use Runway Aleph pela Rivya Public API v1 com o ID de modelo runway-aleph, entradas compatíveis, parâmetros, regras da Files API, créditos e exemplos de resposta.

Disponível via APIProntidãoVídeo

ID do modelo da API

runway-aleph

Entradas

file

Files API

Obrigatório para modos com referência

Créditos base

per_video · default=90 · ⌈total⌉

Capacidade

Vídeo

Cobrança

FIXED

Limite de prompt

5000 caracteres

Contrato da requisição

Envie o ID do modelo no nível superior. Controles específicos do modelo ficam em params.

Chave	Tipo	Obrigatório	Padrão	Descrição
model	string	Sim	runway-aleph	Use runway-aleph como ID do modelo da API.
prompt	string	Sim	-	Máximo de 5000 caracteres para este modelo.
params	object	Não	-	Objeto de parâmetros específico do modelo. Use as linhas abaixo para ver as chaves permitidas.
client_request_id	string	Não	-	ID opcional do cliente para rastrear requisições no seu sistema.

Parâmetros do modelo

Chave	Tipo	Obrigatório	Padrão	Intervalo	Opções	Descrição
aspectRatio	select	Não	16:9	-	16:9, 9:16, 4:3, 3:4, 1:1, 21:9	Proporção
waterMark	text	Não	-	-	-	Watermark
seed	number	Não	-	-	-	Deixe vazio para obter um novo resultado aleatório a cada vez. Reutilizar o mesmo inteiro facilita reproduzir ou ajustar um resultado anterior. Ele só fica mais próximo quando o prompt e outras configurações principais também permanecem semelhantes, e não garante uma correspondência 1:1.

Política de upload

Faça upload dos arquivos de referência primeiro; depois coloque a URL retornada e o durationToken dentro de params.referenceMediaItems.

Regra de referência

Mídia de entrada: Envie o clipe-fonte que você quer que o Aleph transforme. Adicione uma imagem estática opcional apenas quando precisar de orientação extra de estilo ou sujeito.

Máx. de arquivos

Tipos de arquivo aceitos

video, image

Duration token

Referências de vídeo e áudio devem carregar durationToken de /api/v1/files quando a verificação de duração for exigida.

kind	Tamanho máximo	Tipos MIME
video	95 MB	video/mp4, video/quicktime
image	10 MB	image/jpeg, image/png, image/webp

Requisição mínima

{
  "model": "runway-aleph",
  "params": {
    "aspectRatio": "16:9",
    "waterMark": "Deixe vazio para desativar a watermark",
    "seed": 1
  }
}

Requisição com arquivo de referência

{
  "model": "runway-aleph",
  "params": {
    "aspectRatio": "16:9",
    "waterMark": "Deixe vazio para desativar a watermark",
    "seed": 1,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-video.mp4",
        "kind": "video",
        "name": "reference-video.mp4",
        "mimeType": "video/mp4",
        "durationSeconds": 8,
        "durationToken": "video_duration_token_from_files_api"
      }
    ]
  }
}

Resposta de criação

O endpoint de criação retorna um ID público de tarefa. Consulte o endpoint de status até a tarefa ser concluída ou falhar.

{
  "id": "task_runway_aleph_example",
  "status": "queued",
  "model": "runway-aleph",
  "reserved_credits": 90,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Alguns modos exigem uploads de referência pela Files API.

Integração da API de Runway Aleph