Documentação da Rivya AI
Páginas de API por modelo

Integração da API de Wan 2.6

Use Wan 2.6 pela Rivya Public API v1 com o ID de modelo wan-2-6, entradas compatíveis, parâmetros, regras da Files API, créditos e exemplos de resposta.

Disponível via APITexto ou URL prontos; modos de referência usam Files APIVídeo
ID do modelo da API

wan-2-6

Entradas

text, file

Files API

Obrigatório para modos com referência

Créditos base

per_video · 720p_5=70 · 720p_10=140 · 720p_15=210 · 1080p_5=104.5 · 1080p_10=209.5 · 1080p_15=315 · ⌈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.

ChaveTipoObrigatórioPadrãoDescrição
modelstringSimwan-2-6Use wan-2-6 como ID do modelo da API.
promptstringSim-Máximo de 5000 caracteres para este modelo.
paramsobjectNão-Objeto de parâmetros específico do modelo. Use as linhas abaixo para ver as chaves permitidas.
client_request_idstringNão-ID opcional do cliente para rastrear requisições no seu sistema.

Parâmetros do modelo

ChaveTipoObrigatórioPadrãoIntervaloOpçõesDescrição
resolutionselectNão1080p-720p, 1080pResolução
durationselectNão5-5, 10, 15Duração
multi_shotsselectNãofalse-false, trueModo de tomadas
nsfw_checkerselectNãotrue-false, trueFiltro de conteúdo

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 referência: Use exatamente 1 imagem JPG/PNG/WebP (mínimo 256×256, até 10 MB) ou 1–3 vídeos MP4/MOV (até 10 MB por arquivo).

Máx. de arquivos

3

Tipos de arquivo aceitos

image, video

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.

kindTamanho máximoTipos MIME
image10 MBimage/jpeg, image/png, image/webp
video10 MBvideo/mp4, video/quicktime

Requisição mínima

{
  "model": "wan-2-6",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "1080p",
    "duration": "5",
    "multi_shots": "false",
    "nsfw_checker": "true"
  }
}

Requisição com arquivo de referência

{
  "model": "wan-2-6",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "1080p",
    "duration": "5",
    "multi_shots": "false",
    "nsfw_checker": "true",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-video-1.mp4",
        "kind": "video",
        "name": "reference-video-1.mp4",
        "mimeType": "video/mp4",
        "durationSeconds": 8,
        "durationToken": "video_duration_token_1_from_files_api",
        "width": 1280,
        "height": 720,
        "sizeBytes": 8388608,
        "framesPerSecond": 30,
        "videoBitrateMbps": 8,
        "videoMetadataToken": "video_metadata_token_1_from_files_api"
      },
      {
        "url": "https://cdn.example.com/reference-video-2.mp4",
        "kind": "video",
        "name": "reference-video-2.mp4",
        "mimeType": "video/mp4",
        "durationSeconds": 8,
        "durationToken": "video_duration_token_2_from_files_api",
        "width": 1280,
        "height": 720,
        "sizeBytes": 8388608,
        "framesPerSecond": 30,
        "videoBitrateMbps": 8,
        "videoMetadataToken": "video_metadata_token_2_from_files_api"
      },
      {
        "url": "https://cdn.example.com/reference-video-3.mp4",
        "kind": "video",
        "name": "reference-video-3.mp4",
        "mimeType": "video/mp4",
        "durationSeconds": 8,
        "durationToken": "video_duration_token_3_from_files_api",
        "width": 1280,
        "height": 720,
        "sizeBytes": 8388608,
        "framesPerSecond": 30,
        "videoBitrateMbps": 8,
        "videoMetadataToken": "video_metadata_token_3_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_wan_2_6_example",
  "status": "queued",
  "model": "wan-2-6",
  "reserved_credits": 105,
  "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.