Consulte IDs de modelos da Rivya API, disponibilidade, modos suportados, tabelas de parâmetros, limites de prompt, regras de mídia de referência e links de detalhes dos modelos.

Esta página é a referência de API em nível de modelo para a Rivya API v1.

A tabela abaixo é gerada a partir do mesmo catálogo de modelos e public serializer usados por /api/v1/models. Ela não é uma contagem fixa de modelos escrita manualmente.

Como Ler Esta Referência

Use o id do modelo como model em POST /api/v1/generations para modelos assíncronos de imagem, vídeo e áudio.
Use IDs de modelos de chat em POST /api/v1/chat/completions.
Use prompt no nível superior para o texto do prompt de geração.
Use message no nível superior para turnos da Chat API.
Coloque campos específicos de modelos assíncronos dentro de params.
Leia api_input_status antes de criar uma integração. available_text e available_url_input podem ser testados sem upload de arquivo; partial_requires_files significa que apenas alguns modos precisam da Files API; requires_files_api significa enviar mídia de referência pela Files API antes de chamar o modelo.
Para modelos de chat, leia chat_capabilities para suporte a modo sem streaming, streaming SSE, anexos de imagem por file_id, web search, thoughts e reasoning effort.
Páginas de detalhes de modelos dão orientações e exemplos em nível de produto.

Referência Dinâmica de Modelos

Use esta referência com o depurador

Comece pelo início rápido, confirme aqui os campos do modelo e depois execute uma requisição mock ou ao vivo autenticada no depurador de Developers.

Início rápido da API Depurador online

Z-Image

z-imageDisponível via APIInput de texto pronto

Imagem · Modelo leve de texto para imagem da Alibaba. Geração rápida de imagem única com 5 proporções, ideal para rascunhos rápidos de conceito e visuais de mídia social por apenas 1 crédito.

Guia da API Página do modelo

Créditos base

Modos

text-to-image

Input da API

Input de texto pronto

Entradas

text

Limite de prompt

1000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "z-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1"
  }
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
aspect_ratio	select	Não	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16

Nano Banana 2

nano-banana-2Disponível via APIParcial: Files API necessária

Imagem · Modelo de imagem de nova geração do Google com resolução 4K, 15 proporções de tela (incluindo 8:1 extremo), grounding com Google Search e até 14 imagens de referência — o gerador de imagens mais flexível na Rivya.

Guia da API Página do modelo

Créditos base

Modos

text-to-image, image-to-image

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

20000 caracteres

Mídia de referência

image · 14 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "nano-banana-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "auto",
    "resolution": "1K",
    "output_format": "jpg",
    "google_search": "false"
  }
}

Regra de referência

Imagem de referência: Envie até 14 arquivos de imagem para projetos de imagem.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
aspect_ratio	select	Não	auto	-	auto, 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 21:9, 4:1, 1:4, 8:1, 1:8
resolution	select	Não	1K	-	1K, 2K, 4K
output_format	select	Não	jpg	-	jpg, png
google_search	select	Não	false	-	false, true

Nano Banana Pro

nano-banana-proDisponível via APIParcial: Files API necessária

Imagem · Modelo de imagem premium do Google com saída 4K, 11 proporções de tela e até 8 imagens de referência. Otimizado para visuais de marca e campanha de alta fidelidade, com mais detalhe e precisão de cor.

Guia da API Página do modelo

Créditos base

Modos

text-to-image, image-to-image

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

10000 caracteres

Mídia de referência

image · 8 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "nano-banana-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "output_format": "png"
  }
}

Regra de referência

Imagem de referência: Envie até 8 arquivos de imagem para projetos de imagem.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
aspect_ratio	select	Não	1:1	-	1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, auto
resolution	select	Não	1K	-	1K, 2K, 4K
output_format	select	Não	png	-	png, jpg

Nano Banana

nano-bananaDisponível via APIParcial: Files API necessária

Imagem · Modelo de imagem flexível do Google para texto para imagem e imagem para imagem, com 11 proporções de tela, até 10 imagens de referência e saída PNG/JPEG. Uma opção forte para retratos, composições de produto e visuais mais largos de landing page.

Guia da API Página do modelo

Créditos base

Modos

text-to-image, image-to-image

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

5000 caracteres

Mídia de referência

image · 10 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "nano-banana",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "imageSize": "1:1",
    "output_format": "png"
  }
}

Regra de referência

Imagem de referência: Envie até 10 arquivos de imagem para projetos de imagem.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
imageSize	select	Não	1:1	-	1:1, 9:16, 16:9, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9, auto
output_format	select	Não	png	-	png, jpeg

GPT Image 2

gpt-image-2Disponível via APIParcial: Files API necessária

Imagem · O modelo GPT Image mais novo da OpenAI na Rivya, com texto para imagem, imagem para imagem, até 16 imagens de referência e níveis claros de créditos para 1K / 2K / 4K.

Guia da API Página do modelo

Créditos base

Modos

text-to-image, image-to-image

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

20000 caracteres

Mídia de referência

image · 16 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "gpt-image-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "1K"
  }
}

Regra de referência

Imagens de referência: Envie até 16 referências de imagem para tarefas imagem para imagem do GPT Image 2.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
aspect_ratio	select	Não	1:1	-	auto, 1:1, 9:16, 16:9, 4:3, 3:4
resolution	select	Não	1K	-	1K, 2K, 4K

GPT Image 1.5

gpt-image-1-5Disponível via APIParcial: Files API necessária

Imagem · O modelo de imagem da OpenAI com níveis de qualidade média/alta e até 16 imagens de referência. Ele se destaca em seguir instruções complexas e renderizar cenas coerentes com relações espaciais precisas.

Guia da API Página do modelo

Créditos base

Modos

text-to-image, image-to-image

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

Mídia de referência

image · 16 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "gpt-image-1-5",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "quality": "medium",
    "aspect_ratio": "1:1"
  }
}

Regra de referência

Imagem de referência: Envie até 16 arquivos de imagem para projetos de imagem.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
quality	select	Não	medium	-	medium, high
aspect_ratio	select	Não	1:1	-	1:1, 2:3, 3:2

4o Image

4o-imageDisponível via APIInput de texto pronto

Imagem · O modelo 4o Image da OpenAI agora está disponível como um caminho dedicado de texto para imagem na Rivya. Por enquanto, a configuração da página fica propositalmente estreita: prompt mais 3 proporções suportadas, com custo fixo de 3 créditos por imagem.

Guia da API Página do modelo

Créditos base

Modos

text-to-image

Input da API

Input de texto pronto

Entradas

text

Limite de prompt

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "4o-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "size": "1:1"
  }
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
size	select	Não	1:1	-	1:1, 3:2, 2:3

Seedream 5.0 Lite

seedream-5-liteDisponível via APIParcial: Files API necessária

Imagem · O modelo de imagem Seedream mais leve da ByteDance, com preço compartilhado entre texto para imagem e edição de imagem. Ele oferece suporte a 8 proporções, até 14 imagens de referência e atualmente custa 6 créditos por execução.

Guia da API Página do modelo

Créditos base

Modos

text-to-image, image-to-image

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

3000 caracteres

Mídia de referência

image · 14 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "seedream-5-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "quality": "basic"
  }
}

Regra de referência

Imagem de referência: Envie até 14 arquivos de imagem para projetos de imagem.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
aspectRatio	select	Não	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
quality	select	Não	basic	-	basic, high

Seedream 4.5

seedream-4-5Disponível via APIParcial: Files API necessária

Imagem · O modelo de imagem high-end da ByteDance, com faixas de qualidade 2K/4K, 8 proporções e até 14 imagens de referência. Conhecido por gradação de cor cinematográfica e detalhes ricos de textura em visuais de moda e lifestyle.

Guia da API Página do modelo

Créditos base

Modos

text-to-image, image-to-image

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

3000 caracteres

Mídia de referência

image · 14 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "seedream-4-5",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "quality": "basic"
  }
}

Regra de referência

Imagem de referência: Envie até 14 arquivos de imagem para projetos de imagem.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
aspectRatio	select	Não	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
quality	select	Não	basic	-	basic, high

Seedream 4.0

seedream-4-0Disponível via APIParcial: Files API necessária

Imagem · O Seedream 4.0 é um modelo de imagem equilibrado da ByteDance na Rivya para geração de texto para imagem, edição com imagens de referência e controles explícitos de saída.

Guia da API Página do modelo

Créditos base

Modos

text-to-image, image-to-image

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

5000 caracteres

Mídia de referência

image · 10 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "seedream-4-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "image_resolution": "1K",
    "max_images": 1,
    "seed": 0,
    "nsfw_checker": "false"
  }
}

Regra de referência

Imagens de referência: Envie até 10 imagens para o caminho de edição do Seedream 4.0.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
image_size	select	Não	square_hd	-	square, square_hd, portrait_4_3, portrait_3_2, portrait_16_9, landscape_4_3, landscape_3_2, landscape_16_9, landscape_21_9
image_resolution	select	Não	1K	-	1K, 2K, 4K
max_images	number	Não	1	min 1 / max 6 / step 1	-
seed	number	Não	-	min 0 / max 2147483647 / step 1	-
nsfw_checker	select	Não	false	-	false, true

Seedream 3.0

seedream-3-0Disponível via APIInput de texto pronto

Imagem · O Seedream 3.0 retorna agora como um modelo legado de imagem independente na Rivya. Atualmente, ele mantém apenas o caminho público de texto para imagem e custa 5 créditos por execução.

Guia da API Página do modelo

Créditos base

Modos

text-to-image

Input da API

Input de texto pronto

Entradas

text

Limite de prompt

5000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "seedream-3-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "guidance_scale": 2.5,
    "seed": 0
  }
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
image_size	select	Não	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
guidance_scale	number	Não	2.5	min 1 / max 10 / step 0.1	-
seed	number	Não	-	min 0 / max 2147483647	-

Grok Imagine

grok-imagineDisponível via APIParcial: Files API necessária

Imagem · Modelo de imagem da xAI com forte interpretação criativa e 5 proporções. Geração de imagem única focada em expressão artística e estilos visuais não convencionais.

Guia da API Página do modelo

Créditos base

Modos

text-to-image, image-to-image

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

5000 caracteres

Mídia de referência

image · 1 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "grok-imagine",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "enable_pro": "false"
  }
}

Regra de referência

Imagem de referência: Envie até 1 arquivo de imagem para projetos com imagem.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
aspect_ratio	select	Não	1:1	-	1:1, 2:3, 3:2, 16:9, 9:16
enable_pro	select	Não	false	-	false, true

Flux 2 Pro

flux-2-proDisponível via APIParcial: Files API necessária

Imagem · O modelo principal de 32B parâmetros da Black Forest Labs. Oferece suporte a texto para imagem e imagem para imagem com até 8 imagens de referência, resolução 2K e renderização precisa de texto — criado para fotos de produto e visuais de marca.

Guia da API Página do modelo

Créditos base

Modos

text-to-image, image-to-image

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

5000 caracteres

Mídia de referência

image · 8 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "flux-2-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "resolution": "1K"
  }
}

Regra de referência

Imagem de referência: Envie até 8 arquivos de imagem para projetos de imagem.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
aspectRatio	select	Não	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
resolution	select	Não	1K	-	1K, 2K

Flux 2 Flex

flux-2-flexDisponível via APIParcial: Files API necessária

Imagem · Variante da família Flux 2 focada em edição. Especializa-se em ajustes estruturais e transferência de estilo com até 8 imagens de referência e resolução 2K — ideal para iterar sobre visuais existentes.

Guia da API Página do modelo

Créditos base

Modos

text-to-image, image-to-image

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

5000 caracteres

Mídia de referência

image · 8 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "flux-2-flex",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "resolution": "1K"
  }
}

Regra de referência

Imagem de referência: Envie até 8 arquivos de imagem para projetos de imagem.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
aspectRatio	select	Não	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
resolution	select	Não	1K	-	1K, 2K

Flux Kontext Max

flux-kontext-maxDisponível via APIParcial: Files API necessária

Imagem · O modelo Flux Kontext aprimorado da Black Forest Labs para tarefas mais exigentes de geração guiada por prompt e edição de imagem. A Rivya atualmente mantém texto para imagem e imagem para imagem no mesmo projeto assíncrono e precifica ambos em 8 créditos fixos por geração sob a política atual da plataforma.

Guia da API Página do modelo

Créditos base

Modos

text-to-image, image-to-image

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

Mídia de referência

image · 1 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "flux-kontext-max",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "outputFormat": "jpeg",
    "enableTranslation": "true",
    "promptUpsampling": "false",
    "safetyTolerance": 2,
    "watermark": "Texto opcional de marca-d'água"
  }
}

Regra de referência

Imagem de referência: Envie até 1 arquivo de imagem para projetos de edição de imagem.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
aspectRatio	select	Não	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
outputFormat	select	Não	jpeg	-	jpeg, png
enableTranslation	select	Não	true	-	true, false
promptUpsampling	select	Não	false	-	false, true
safetyTolerance	number	Não	2	min 0 / max 6	-
watermark	text	Não	-	-	-

Flux Kontext Pro

flux-kontext-proDisponível via APIParcial: Files API necessária

Imagem · O projeto Flux Kontext de menor custo da Black Forest Labs para texto para imagem e edição de uma única imagem. A Rivya atualmente expõe texto para imagem e imagem para imagem no mesmo projeto assíncrono de imagem, com preço fixo de 4 créditos para ambos os modos sob a política atual de preços da plataforma.

Guia da API Página do modelo

Créditos base

Modos

text-to-image, image-to-image

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

Mídia de referência

image · 1 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "flux-kontext-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "outputFormat": "jpeg",
    "enableTranslation": "true",
    "promptUpsampling": "false",
    "safetyTolerance": 2,
    "watermark": "Texto opcional de marca-d'água"
  }
}

Regra de referência

Imagem de referência: Envie até 1 arquivo de imagem para projetos de edição de imagem.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
aspectRatio	select	Não	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
outputFormat	select	Não	jpeg	-	jpeg, png
enableTranslation	select	Não	true	-	true, false
promptUpsampling	select	Não	false	-	false, true
safetyTolerance	number	Não	2	min 0 / max 6	-
watermark	text	Não	-	-	-

Qwen2 Image

qwen2-imageDisponível via APIParcial: Files API necessária

Imagem · O modelo de imagem Qwen2 da Alibaba está atualmente integrado na Rivya como um projeto de imagem de preço fixo. Ele cobre com segurança texto para imagem e imagem para imagem com o subconjunto compartilhado de proporções que ambas as documentações públicas expõem, além de saída PNG/JPEG, reutilização de seed e um switch NSFW simples.

Guia da API Página do modelo

Créditos base

Modos

text-to-image, image-to-image

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

800 caracteres

Mídia de referência

image · 1 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "qwen2-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "16:9",
    "output_format": "png",
    "seed": 0,
    "nsfw_checker": "false"
  }
}

Regra de referência

Imagem de referência: Envie até 1 arquivo de imagem para projetos de imagem.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
image_size	select	Não	16:9	-	1:1, 3:4, 4:3, 9:16, 16:9
output_format	select	Não	png	-	png, jpeg
seed	number	Não	-	min 0	-
nsfw_checker	select	Não	false	-	false, true

Qwen Image

qwen-imageDisponível via APIParcial: Files API necessária

Imagem · Modelo de imagem da família Alibaba Qwen com presets HD (Square, Portrait, Landscape) e saída PNG/JPEG. Forte em prompts em chinês e geração visual com nuances culturais.

Guia da API Página do modelo

Créditos base

Modos

text-to-image, image-to-image

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

5000 caracteres

Mídia de referência

image · 1 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "qwen-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "output_format": "png"
  }
}

Regra de referência

Imagem de referência: Envie até 1 arquivo de imagem para projetos de imagem.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
image_size	select	Não	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
output_format	select	Não	png	-	png, jpeg

Midjourney

midjourneyDisponível via APIParcial: Files API necessária

Imagem · Modelo de imagem V7 da Midjourney para texto para imagem e imagem para imagem, com modos anime Niji, 3 níveis de velocidade (Relaxed/Fast/Turbo), referências de estilo e consistência guiada por Omni Reference. Ainda é o benchmark para arte cinematográfica, ilustrações e moodboards.

Guia da API Página do modelo

Créditos base

Modos

text-to-image, image-to-image

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

2000 caracteres

Mídia de referência

image · 4 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "midjourney",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "speed": "relaxed",
    "aspectRatio": "1:1",
    "version": "7"
  }
}

Regra de referência

Imagem de referência: Envie até 4 arquivos de imagem para projetos de imagem.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
speed	select	Não	relaxed	-	relaxed, fast, turbo
aspectRatio	select	Não	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
version	select	Não	7	-	7, 6.1, 6, niji7, niji6

Recraft Remove Background

recraft-remove-backgroundDisponível via APIFiles API necessária

Imagem · Modelo de remoção de fundo da Recraft na Rivya para isolar o sujeito de uma imagem existente. Use quando a próxima etapa precisa de um asset transparente, um recorte limpo ou uma imagem-fonte sem o fundo original.

Guia da API Página do modelo

Créditos base

Modos

image-to-image

Input da API

Files API necessária

Entradas

file

Limite de prompt

Mídia de referência

image · 1 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

Nenhum exemplo executável da Public API é mostrado para este modelo.

Regra de referência

Imagem-fonte: Envie exatamente 1 imagem. Bordas de sujeito mais limpas geralmente produzem recortes mais limpos.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos baseados em arquivo precisam de /api/v1/files antes de aparecerem como exemplos completos prontos para API. Files API

Parâmetros

Nenhum parâmetro adicional do modelo é necessário.

Recraft Crisp Upscale

recraft-crisp-upscaleDisponível via APIFiles API necessária

Imagem · Modelo leve de upscale de imagem da Recraft na Rivya para aumentar nitidez e clareza a baixo custo em uma imagem estática já aprovada. Use quando a imagem escolhida só precisa de uma passada barata de polimento antes da exportação, não de um upscale mais pesado em nível de entrega.

Guia da API Página do modelo

Créditos base

Modos

image-to-image

Input da API

Files API necessária

Entradas

file

Limite de prompt

Mídia de referência

image · 1 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

Nenhum exemplo executável da Public API é mostrado para este modelo.

Regra de referência

Imagem-fonte: Envie exatamente 1 imagem. Esta opção é feita para uma passada rápida de polimento de baixo custo.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos baseados em arquivo precisam de /api/v1/files antes de aparecerem como exemplos completos prontos para API. Files API

Parâmetros

Nenhum parâmetro adicional do modelo é necessário.

Wan 2.7 Image Pro

wan-2-7-image-proDisponível via APIParcial: Files API necessária

Imagem · Modelo de imagem Wan 2.7 mais avançado da Alibaba, atualmente exposto na Rivya como um slot de imagem separado para texto para imagem e edição de imagem. O preço permanece fixo em 12 créditos por execução ao manter explicitamente a geração em uma única imagem de saída.

Guia da API Página do modelo

Créditos base

Modos

text-to-image, image-to-image

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

5000 caracteres

Mídia de referência

image · 9 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "wan-2-7-image-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "2K",
    "watermark": "false",
    "seed": 0
  }
}

Regra de referência

Imagem de referência: Envie até 9 arquivos de imagem para projetos de edição de imagem.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
aspect_ratio	select	Não	1:1	-	1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8
resolution	select	Não	2K	-	1K, 2K
watermark	select	Não	false	-	false, true
seed	number	Não	-	min 0 / max 2147483647 / step 1	-

Wan 2.7 Image

wan-2-7-imageDisponível via APIParcial: Files API necessária

Imagem · O modelo de imagem Wan 2.7 padrão da Alibaba aparece na Rivya como seu próprio slot de imagem para texto para imagem e edição de imagem, e atualmente custa 5 créditos por execução.

Guia da API Página do modelo

Créditos base

Modos

text-to-image, image-to-image

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

5000 caracteres

Mídia de referência

image · 9 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "wan-2-7-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "2K",
    "watermark": "false",
    "seed": 0
  }
}

Regra de referência

Imagem de referência: Envie até 9 arquivos de imagem para projetos de edição de imagem.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
aspect_ratio	select	Não	1:1	-	1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8
resolution	select	Não	2K	-	1K, 2K
watermark	select	Não	false	-	false, true
seed	number	Não	-	min 0 / max 2147483647	-

Google Imagen4 Ultra

google-imagen4-ultraDisponível via APIInput de texto pronto

Imagem · Google Imagen4 Ultra é a camada premium de texto para imagem Imagen da Rivya. Atualmente ele está integrado como um projeto de imagem única, com preço fixo de 12 créditos e controles públicos de prompt, prompt negativo, proporção e semente.

Guia da API Página do modelo

Créditos base

Modos

text-to-image

Input da API

Input de texto pronto

Entradas

text

Limite de prompt

5000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "google-imagen4-ultra",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "negative_prompt": "Itens opcionais a evitar",
    "seed": "Valor de semente opcional"
  }
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
aspect_ratio	select	Não	1:1	-	1:1, 16:9, 9:16, 3:4, 4:3
negative_prompt	text	Não	-	-	-
seed	text	Não	-	-	-

Google Imagen4

google-imagen4Disponível via APIInput de texto pronto

Imagem · Google Imagen4 é a camada padrão de texto para imagem Imagen da Rivya. Atualmente ele está integrado como um projeto de imagem única, com preço fixo de 8 créditos e controles públicos de prompt, prompt negativo, proporção e semente.

Guia da API Página do modelo

Créditos base

Modos

text-to-image

Input da API

Input de texto pronto

Entradas

text

Limite de prompt

5000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "google-imagen4",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "negative_prompt": "Itens opcionais a evitar",
    "seed": "Valor de semente opcional"
  }
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
aspect_ratio	select	Não	1:1	-	1:1, 16:9, 9:16, 3:4, 4:3
negative_prompt	text	Não	-	-	-
seed	text	Não	-	-	-

Google Imagen4 Fast

google-imagen4-fastDisponível via APIInput de texto pronto

Imagem · Google Imagen4 Fast é o nível leve de texto para imagem Imagen da Rivya. Atualmente ele mantém um projeto de imagem única, usa preço fixo de 4 créditos e expõe controles públicos de prompt, prompt negativo, proporção e semente sem abrir saída com múltiplas imagens.

Guia da API Página do modelo

Créditos base

Modos

text-to-image

Input da API

Input de texto pronto

Entradas

text

Limite de prompt

5000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "google-imagen4-fast",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "16:9",
    "negative_prompt": "Itens opcionais a evitar",
    "seed": 0
  }
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
aspect_ratio	select	Não	16:9	-	1:1, 16:9, 9:16, 3:4, 4:3
negative_prompt	text	Não	-	-	-
seed	number	Não	-	min 0	-

Topaz Image Upscaler

topaz-image-upscaleDisponível via APIFiles API necessária

Imagem · O upscaler de imagem em nível de entrega da Topaz na Rivya para imagens estáticas aprovadas que precisam de um salto real de tamanho. Use quando a composição já estiver final e o problema restante for resolução de exportação, tamanho de revisão ou prontidão para impressão.

Guia da API Página do modelo

Créditos base

Modos

image-to-image

Input da API

Files API necessária

Entradas

file

Limite de prompt

Mídia de referência

image · 1 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

Nenhum exemplo executável da Public API é mostrado para este modelo.

Regra de referência

Imagem de origem: Envie 1 imagem aprovada que você quer preservar. Esta opção é para ampliação, não para reedição criativa.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos baseados em arquivo precisam de /api/v1/files antes de aparecerem como exemplos completos prontos para API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
upscale_factor	select	Não	1	-	1, 2, 4, 8

Ideogram V3

ideogram-v3Disponível via APIInput de texto pronto

Imagem · Ideogram V3 é o modelo de texto para imagem da Rivya para renderização de texto, layouts de pôster e prompts de imagem com foco em design. O preço atual é 4 créditos para TURBO, 7 para BALANCED e 10 para QUALITY.

Guia da API Página do modelo

Créditos base

Modos

text-to-image

Input da API

Input de texto pronto

Entradas

text

Limite de prompt

5000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "ideogram-v3",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "seed": 0,
    "negative_prompt": "Itens opcionais a evitar"
  }
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
rendering_speed	select	Não	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	Não	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN
expand_prompt	select	Não	true	-	true, false
image_size	select	Não	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	Não	-	min 0	-
negative_prompt	text	Não	-	-	-

Ideogram V3 Reframe

ideogram-v3-reframeDisponível via APIFiles API necessária

Imagem · Ideogram V3 Reframe está atualmente integrado à Rivya como um projeto de reenquadramento de imagem única com preço por velocidade de renderização. O preço atual é 4 créditos para TURBO, 7 para BALANCED e 10 para QUALITY.

Guia da API Página do modelo

Créditos base

Modos

image-to-image

Input da API

Files API necessária

Entradas

file

Limite de prompt

Mídia de referência

image · 1 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

Nenhum exemplo executável da Public API é mostrado para este modelo.

Regra de referência

Imagem de referência: Envie exatamente 1 arquivo de imagem para este projeto.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos baseados em arquivo precisam de /api/v1/files antes de aparecerem como exemplos completos prontos para API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
rendering_speed	select	Não	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	Não	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN
image_size	select	Não	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	Não	-	min 0	-

Ideogram V3 Remix

ideogram-v3-remixDisponível via APIFiles API necessária

Imagem · Ideogram V3 Remix está atualmente integrado à Rivya como um projeto de remix de imagem única com preço por velocidade de renderização. O preço atual é 4 créditos para TURBO, 7 para BALANCED e 10 para QUALITY.

Guia da API Página do modelo

Créditos base

Modos

image-to-image

Input da API

Files API necessária

Entradas

file

Limite de prompt

5000 caracteres

Mídia de referência

image · 1 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

Nenhum exemplo executável da Public API é mostrado para este modelo.

Regra de referência

Imagem de referência: Envie exatamente 1 arquivo de imagem para este projeto.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos baseados em arquivo precisam de /api/v1/files antes de aparecerem como exemplos completos prontos para API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
rendering_speed	select	Não	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	Não	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN
expand_prompt	select	Não	true	-	true, false
image_size	select	Não	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	Não	-	min 0	-
strength	number	Não	0.8	min 0.01 / max 1	-
negative_prompt	text	Não	-	-	-

Ideogram Character

ideogram-characterDisponível via APIFiles API necessária

Imagem · Opção de consistência de personagem para transformar uma imagem de personagem aprovada em novas cenas, roupas e formatos. Escolha quando a preservação da identidade importa mais do que edição ampla de imagem e você só precisa de uma imagem de saída por vez.

Guia da API Página do modelo

Créditos base

Modos

image-to-image

Input da API

Files API necessária

Entradas

file

Limite de prompt

5000 caracteres

Mídia de referência

image · 1 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

Nenhum exemplo executável da Public API é mostrado para este modelo.

Regra de referência

Imagem de referência do personagem: Envie 1 imagem clara de referência do personagem. Esta opção ignora imagens extras e mantém a saída em um único resultado.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos baseados em arquivo precisam de /api/v1/files antes de aparecerem como exemplos completos prontos para API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
rendering_speed	select	Não	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	Não	AUTO	-	AUTO, REALISTIC, FICTION
expand_prompt	select	Não	true	-	true, false
image_size	select	Não	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	Não	-	min 0	-
negative_prompt	text	Não	-	-	-

Seedance 2.0

seedance-2Disponível via APIInput de texto pronto

Vídeo · O modelo de vídeo Seedance 2.0 completo da ByteDance, com suporte explícito a geração apenas por prompt, animação guiada por quadros e geração com referência multimodal. A Rivya mantém explícita a divisão de papéis documentada para que entradas de quadros e referências multimodais permaneçam mutuamente exclusivas, em vez de virarem um único campo ambíguo de upload.

Guia da API Página do modelo

Créditos base

175

Modos

text-to-video, image-to-video, reference-to-video

Input da API

Input de texto pronto

Entradas

text

Limite de prompt

2500 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "seedance-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "false"
  }
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
seedance_scene	select	Não	text	-	text, frames, reference
resolution	select	Não	720p	-	480p, 720p
aspect_ratio	select	Não	16:9	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
duration	number	Não	5	min 4 / max 15	-
generate_audio	select	Não	true	-	true, false
return_last_frame	select	Não	false	-	false, true
web_search	select	Não	false	-	false, true
nsfw_checker	select	Não	false	-	false, true

Seedance 2.0 Fast

seedance-2-fastDisponível via APIInput de texto pronto

Vídeo · O modelo de vídeo Seedance 2.0 mais rápido da ByteDance, com roteamento completo de cenas para geração apenas por prompt, animação de imagem guiada por quadros e geração de vídeo com referência multimodal. A Rivya mantém explícita a divisão de cenas documentada para que entradas de primeiro/último quadro não entrem em conflito com papéis de imagem, vídeo e áudio de referência.

Guia da API Página do modelo

Créditos base

140

Modos

text-to-video, image-to-video, reference-to-video

Input da API

Input de texto pronto

Entradas

text

Limite de prompt

2500 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "seedance-2-fast",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "false"
  }
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
seedance_scene	select	Não	text	-	text, frames, reference
resolution	select	Não	720p	-	480p, 720p
aspect_ratio	select	Não	16:9	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
duration	number	Não	5	min 4 / max 15	-
generate_audio	select	Não	true	-	true, false
return_last_frame	select	Não	false	-	false, true
web_search	select	Não	false	-	false, true
nsfw_checker	select	Não	false	-	false, true

Seedance 1.5 Pro

seedance-1-5-proDisponível via APIParcial: Files API necessária

Vídeo · O modelo de vídeo flagship da ByteDance para texto para vídeo e imagem para vídeo, com sincronização nativa entre áudio e imagem. Clipes de 480p a 1080p, 4 a 12s, 6 proporções, controle de lente dinâmica ou fixa, geração de áudio opcional e suporte a lip sync.

Guia da API Página do modelo

Créditos base

Modos

text-to-video, image-to-video

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

2500 caracteres

Mídia de referência

image · 2 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "seedance-1-5-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "8",
    "generate_audio": "false",
    "aspectRatio": "1:1",
    "fixed_lens": "false"
  }
}

Regra de referência

Imagem de referência: Envie até 2 arquivos de imagem para projetos com imagem.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
resolution	select	Não	720p	-	480p, 720p, 1080p
duration	select	Não	8	-	4, 8, 12
generate_audio	select	Não	false	-	false, true
aspectRatio	select	Não	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9
fixed_lens	select	Não	false	-	false, true

Seedance 1.0 Pro

seedance-1-0-proDisponível via APIParcial: Files API necessária

Vídeo · O modelo Seedance 1.0 Pro da ByteDance, disponibilizado na Rivya como a opção 1.0 Pro padrão para texto para vídeo e imagem para vídeo. Ele mantém a configuração atual da página alinhada à documentação pública do V1 Pro, com controles de resolução, duração, câmera fixa, seed e verificação de segurança.

Guia da API Página do modelo

Créditos base

Modos

text-to-video, image-to-video

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

10000 caracteres

Mídia de referência

image · 1 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "seedance-1-0-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "camera_fixed": "false",
    "seed": -1,
    "enable_safety_checker": "true"
  }
}

Regra de referência

Imagem de referência: Envie 1 arquivo de imagem para execuções de imagem para vídeo.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
resolution	select	Não	720p	-	480p, 720p, 1080p
duration	select	Não	5	-	5, 10
aspect_ratio	select	Não	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
camera_fixed	select	Não	false	-	false, true
seed	number	Não	-1	min -1 / max 2147483647	-
enable_safety_checker	select	Não	true	-	true, false

Seedance 1.0 Pro Fast

seedance-1-0-pro-fastDisponível via APIFiles API necessária

Vídeo · Modelo rápido de imagem para vídeo da ByteDance. Anima uma única imagem de referência em clipes de 5s ou 10s em 720p/1080p — otimizado para velocidade quando você precisa de vídeo rápido a partir de uma imagem estática.

Guia da API Página do modelo

Créditos base

Modos

image-to-video

Input da API

Files API necessária

Entradas

file

Limite de prompt

10000 caracteres

Mídia de referência

image · 1 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

Nenhum exemplo executável da Public API é mostrado para este modelo.

Regra de referência

Imagem de referência: Envie 1 imagem-fonte para animá-la em vídeo.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos baseados em arquivo precisam de /api/v1/files antes de aparecerem como exemplos completos prontos para API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
resolution	select	Não	720p	-	720p, 1080p
duration	select	Não	5	-	5, 10

Seedance 1.0 Lite

seedance-1-0-liteDisponível via APIParcial: Files API necessária

Vídeo · O modelo Seedance 1.0 Lite da ByteDance é exposto na Rivya como a opção 1.0 mais leve para texto para vídeo e imagem para vídeo. Ele segue o conjunto público de parâmetros V1 Lite e atualmente usa uma escala de preço menor do que Seedance 1.0 Pro.

Guia da API Página do modelo

Créditos base

Modos

text-to-video, image-to-video

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

10000 caracteres

Mídia de referência

image · 2 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "seedance-1-0-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "camera_fixed": "false",
    "seed": -1,
    "enable_safety_checker": "true"
  }
}

Regra de referência

Imagem de referência: Envie 1 imagem-fonte para imagem para vídeo, ou 2 imagens quando também quiser fornecer um frame final opcional.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
resolution	select	Não	720p	-	480p, 720p, 1080p
duration	select	Não	5	-	5, 10
aspect_ratio	select	Não	16:9	-	16:9, 4:3, 1:1, 3:4, 9:16, 9:21
camera_fixed	select	Não	false	-	false, true
seed	number	Não	-1	min -1 / max 2147483647	-
enable_safety_checker	select	Não	true	-	true, false

HappyHorse 1.0

happyhorse-1-0Disponível via APIParcial: Files API necessária

Vídeo · Um modelo flexível de vídeo com IA na Rivya para texto para vídeo, movimento a partir de uma única imagem, vídeo com referência de múltiplas imagens e edição de vídeo em uma página pública de modelo.

Guia da API Página do modelo

Créditos base

Modos

text-to-video, image-to-video, reference-to-video, video-to-video

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

5000 caracteres

Mídia de referência

image, video · 10 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "happyhorse-1-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "audio_setting": "auto",
    "seed": 0
  }
}

Regra de referência

Mídia de referência: Use até 9 imagens sem vídeo, ou 1 vídeo com até 5 referências de imagem para edição de vídeo.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
resolution	select	Não	1080p	-	720p, 1080p
aspect_ratio	select	Não	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4
duration	number	Não	5	min 3 / max 15	-
audio_setting	select	Não	auto	-	auto, origin
seed	number	Não	0	min 0 / max 2147483647	-

Wan 2.7 Video

wan-2-7-videoDisponível via APIParcial: Files API necessária

Vídeo · Linha de vídeo Wan mais nova da Alibaba com preço por resolução e duração. A Rivya expõe texto para vídeo, imagem para vídeo e edição de vídeo em um único slot de modelo, a partir de 80 créditos por geração.

Guia da API Página do modelo

Créditos base

Modos

text-to-video, image-to-video, video-to-video

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

5000 caracteres

Mídia de referência

image, video · 2 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "wan-2-7-video",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Exclusões opcionais ou modos de falha a evitar.",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0
  }
}

Regra de referência

Mídia de referência: Envie até 2 assets. Use até 2 imagens para imagem para vídeo, ou 1 vídeo mais 1 imagem opcional para edição de vídeo.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
resolution	select	Não	720p	-	720p, 1080p
duration	select	Não	5	-	5, 10, 15
aspect_ratio	select	Não	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4
negative_prompt	text	Não	-	-	-
prompt_extend	select	Não	true	-	true, false
watermark	select	Não	false	-	false, true
audio_setting	select	Não	auto	-	auto, origin
seed	number	Não	-	min 0 / max 2147483647	-

Wan 2.6

wan-2-6Disponível via APIParcial: Files API necessária

Vídeo · Opção Wan de três modos da Alibaba na Rivya: texto para vídeo, imagem para vídeo e edição de vídeo de origem em um único projeto. Suporta 720p/1080p, clipes de 5 a 15 segundos e uma imagem ou um vídeo de origem por vez.

Guia da API Página do modelo

Créditos base

Modos

text-to-video, image-to-video, video-to-video

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

5000 caracteres

Mídia de referência

image, video · 1 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "wan-2-6",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5"
  }
}

Regra de referência

Mídia de referência: Envie até 1 arquivo de imagem / vídeo para projetos de imagem / vídeo.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
resolution	select	Não	720p	-	720p, 1080p
duration	select	Não	5	-	5, 10, 15

Wan 2.5 Video

wan-2-5-videoDisponível via APIParcial: Files API necessária

Vídeo · Wan 2.5 agora aparece na Rivya como uma entrada compartilhada para texto para vídeo e imagem para vídeo. O preço atual é `720p_5 = 60`, `720p_10 = 120`, `1080p_5 = 100` e `1080p_10 = 200` créditos.

Guia da API Página do modelo

Créditos base

Modos

text-to-video, image-to-video

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

5000 caracteres

Mídia de referência

image · 1 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "wan-2-5-video",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "negative_prompt": "Exclusões opcionais ou modos de falha a evitar.",
    "nsfw_checker": "false"
  }
}

Regra de referência

Imagem de referência: Envie até 1 arquivo de imagem para o modo imagem para vídeo.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
resolution	select	Não	720p	-	720p, 1080p
duration	select	Não	5	-	5, 10
aspect_ratio	select	Não	16:9	-	16:9, 9:16, 1:1
enable_prompt_expansion	select	Não	false	-	false, true
seed	number	Não	-	min 0 / max 2147483647	-
negative_prompt	text	Não	-	-	-
nsfw_checker	select	Não	false	-	false, true

Wan 2.2 A14B Turbo

wan-2-2-a14b-turboDisponível via APIParcial: Files API necessária

Vídeo · Wan 2.2 A14B Turbo agora cobre texto para vídeo, imagem para vídeo e também um caminho de vídeo guiado por imagem e áudio na Rivya. O preço atual é `480p = 8` e `720p = 12` para execuções por texto ou imagem, além de `480p = 16`, `580p = 20` e `720p = 24` quando uma imagem e um clipe de áudio conduzem o resultado.

Guia da API Página do modelo

Créditos base

Modos

text-to-video, image-to-video, speech-to-video

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

5000 caracteres

Mídia de referência

image, audio · 2 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "wan-2-2-a14b-turbo",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "acceleration": "none",
    "num_frames": 80,
    "frames_per_second": 16,
    "negative_prompt": "Exclusões opcionais ou modos de falha a evitar.",
    "num_inference_steps": 27,
    "guidance_scale": 3.5,
    "shift": 5,
    "enable_safety_checker": "true"
  }
}

Regra de referência

Mídia de referência: Envie até 2 assets. O modo de texto não exige nenhum, imagem para vídeo usa 1 imagem, e o caminho guiado por imagem mais áudio usa 1 imagem mais 1 clipe de áudio.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
resolution	select	Não	720p	-	480p, 580p, 720p
aspect_ratio	select	Não	16:9	-	16:9, 9:16
enable_prompt_expansion	select	Não	false	-	false, true
seed	number	Não	-	min 0 / max 2147483647	-
acceleration	select	Não	none	-	none, regular
num_frames	number	Não	80	min 40 / max 120 / step 1	-
frames_per_second	number	Não	16	min 4 / max 60 / step 1	-
negative_prompt	text	Não	-	-	-
num_inference_steps	number	Não	27	min 2 / max 40 / step 1	-
guidance_scale	number	Não	3.5	min 1 / max 10 / step 0.1	-
shift	number	Não	5	min 1 / max 10 / step 0.1	-
enable_safety_checker	select	Não	true	-	true, false

Wan Animate Replace

wan-2-2-animate-replaceDisponível via APIEntrada de URL pronta

Vídeo · Modelo de vídeo da Wan para substituição de personagem na Rivya, usado para trocar quem aparece em um clipe existente. Use uma URL pública de vídeo de origem, uma URL pública de imagem de substituição e uma faixa de resolução quando o movimento já está correto e o sujeito visível precisa mudar.

Guia da API Página do modelo

Créditos base

Modos

video-to-video

Input da API

Entrada de URL pronta

Entradas

url

Limite de prompt

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "wan-2-2-animate-replace",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "video_url": "https://...",
    "image_url": "https://...",
    "resolution": "480p"
  }
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Este modelo aceita entrada de URL pública por meio dos parâmetros do modelo.

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
video_url	text	Não	-	-	-
image_url	text	Não	-	-	-
resolution	select	Não	480p	-	480p, 580p, 720p

Hailuo 2.3

hailuo-2-3Disponível via APIFiles API necessária

Vídeo · Modelo de imagem para vídeo da MiniMax com faixas de qualidade Standard/Pro, resolução 768P/1080P e clipes de 6s ou 10s. Conhecido por movimentos mais suaves e transições naturais a partir de imagens estáticas.

Guia da API Página do modelo

Créditos base

Modos

image-to-video

Input da API

Files API necessária

Entradas

file

Limite de prompt

5000 caracteres

Mídia de referência

image · 1 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

Nenhum exemplo executável da Public API é mostrado para este modelo.

Regra de referência

Imagem de referência: Envie até 1 arquivo de imagem para projetos com imagem.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos baseados em arquivo precisam de /api/v1/files antes de aparecerem como exemplos completos prontos para API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
quality	select	Não	standard	-	standard, pro
resolution	select	Não	768P	-	768P, 1080P
duration	select	Não	6	-	6, 10

Hailuo Pro

hailuo-proDisponível via APIParcial: Files API necessária

Vídeo · O modelo de vídeo Hailuo Pro mais antigo da MiniMax está conectado aqui como um modelo fixo de faixa Pro para texto para vídeo e imagem para vídeo. O modo de imagem aceita 1 ou 2 imagens de referência, com a segunda imagem usada como último quadro, e cada geração atualmente custa 57 créditos.

Guia da API Página do modelo

Créditos base

Modos

text-to-video, image-to-video

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

1500 caracteres

Mídia de referência

image · 2 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "hailuo-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "prompt_optimizer": "false"
  }
}

Regra de referência

Imagens de referência: O modo de imagem aceita até 2 imagens, e a segunda imagem se torna o último quadro.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
prompt_optimizer	select	Não	false	-	false, true

Hailuo Standard

hailuo-standardDisponível via APIParcial: Files API necessária

Vídeo · Modelo de vídeo Hailuo Standard mais antigo da MiniMax, unificado aqui como um modelo para texto para vídeo e imagem para vídeo. O modo de imagem aceita 1 ou 2 imagens de referência, com a segunda imagem usada como último quadro, e as faixas públicas de preço atualmente verificadas vão de 12 a 50 créditos.

Guia da API Página do modelo

Créditos base

Modos

text-to-video, image-to-video

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

1500 caracteres

Mídia de referência

image · 2 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "hailuo-standard",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "6",
    "resolution": "512P",
    "prompt_optimizer": "false"
  }
}

Regra de referência

Imagens de referência: O modo de imagem aceita até 2 imagens, e a segunda imagem se torna o último quadro.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
duration	select	Não	6	-	6, 10
resolution	select	Não	512P	-	512P, 768P
prompt_optimizer	select	Não	false	-	false, true

Kling 3.0

kling-3-0Disponível via APIParcial: Files API necessária

Vídeo · Modelo de vídeo premium da Kuaishou para texto para vídeo e imagem para vídeo, com níveis Standard (720P) / Pro (1080P), estrutura de tomada única ou múltiplas tomadas, duração de 3 a 15 s, geração de áudio opcional e até 2 imagens de referência.

Guia da API Página do modelo

Créditos base

Modos

text-to-video, image-to-video

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

2000 caracteres

Mídia de referência

image · 2 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "kling-3-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "mode": "pro",
    "multi_shots": "false",
    "duration": "5",
    "sound": "false",
    "aspect_ratio": "16:9"
  }
}

Regra de referência

Mídia de referência: Envie até 2 arquivos de imagem no total para projetos de imagem para vídeo.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
mode	select	Não	pro	-	std, pro
multi_shots	select	Não	false	-	false, true
duration	select	Não	5	-	3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
sound	select	Não	false	-	false, true
aspect_ratio	select	Não	16:9	-	16:9, 9:16, 1:1

Kling 3.0 motion-control

kling-3-0-motion-controlDisponível via APIFiles API necessária

Vídeo · Opção Kling motion-control mais nova para conduzir um sujeito a partir de uma imagem de referência e um vídeo de movimento, com escolha explícita de fonte do fundo. Escolha quando quiser transferência de movimento e mais controle sobre se a cena deve vir do vídeo ou da imagem.

Guia da API Página do modelo

Créditos base

Modos

video-to-video

Input da API

Files API necessária

Entradas

file

Limite de prompt

2500 caracteres

Mídia de referência

image, video · 2 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

Nenhum exemplo executável da Public API é mostrado para este modelo.

Regra de referência

Imagem de referência + vídeo de movimento: Envie exatamente 1 imagem de personagem e 1 clipe de movimento. Escolha 3.0 quando precisar tanto de controle de orientação quanto de escolha de fonte do fundo.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos baseados em arquivo precisam de /api/v1/files antes de aparecerem como exemplos completos prontos para API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
mode	select	Não	pro	-	std, pro
character_orientation	select	Não	video	-	video, image
background_source	select	Não	input_video	-	input_video, input_image

Kling 2.6

kling-2-6Disponível via APIParcial: Files API necessária

Vídeo · Modelo de vídeo da Kuaishou com geração de áudio opcional, clipes de 5s/10s e 3 proporções. Forte em movimento humano e animação expressiva de personagens com física natural.

Guia da API Página do modelo

Créditos base

Modos

text-to-video, image-to-video

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

1000 caracteres

Mídia de referência

image · 1 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "kling-2-6",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "sound": "false",
    "aspect_ratio": "1:1"
  }
}

Regra de referência

Imagem de referência: Envie até 1 arquivo de imagem para projetos com imagem.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
duration	select	Não	5	-	5, 10
sound	select	Não	false	-	false, true
aspect_ratio	select	Não	1:1	-	1:1, 16:9, 9:16

Kling 2.6 motion-control

kling-2-6-motion-controlDisponível via APIFiles API necessária

Vídeo · Projeto dedicado de transferência de movimento para conduzir um sujeito a partir de uma imagem de referência e um vídeo de movimento. Escolha quando quiser uma execução Kling motion-control mais barata e puder abrir mão dos controles extras de cena do Kling 3.0 motion-control.

Guia da API Página do modelo

Créditos base

Modos

video-to-video

Input da API

Files API necessária

Entradas

file

Limite de prompt

2500 caracteres

Mídia de referência

image, video · 2 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

Nenhum exemplo executável da Public API é mostrado para este modelo.

Regra de referência

Imagem de referência + vídeo de movimento: Envie exatamente 1 imagem de personagem e 1 clipe de movimento. Ambos devem mostrar claramente cabeça, ombros e tronco.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos baseados em arquivo precisam de /api/v1/files antes de aparecerem como exemplos completos prontos para API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
mode	select	Não	720p	-	720p, 1080p
character_orientation	select	Não	video	-	video, image

Kling V2.5 Turbo Pro

kling-v2-5-turbo-proDisponível via APIParcial: Files API necessária

Vídeo · Modelo de vídeo Kling V2.5 Turbo Pro, da Kuaishou, agora com suporte a texto para vídeo e imagem para vídeo. A evidência pública de preço cobre claramente os níveis de texto e imagem em 5 segundos e 10 segundos, então a Rivya o mapeia diretamente para 42 / 84 créditos.

Guia da API Página do modelo

Créditos base

Modos

text-to-video, image-to-video

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

2500 caracteres

Mídia de referência

image · 2 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "kling-v2-5-turbo-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Descreva o que o vídeo deve evitar",
    "cfg_scale": 0.5
  }
}

Regra de referência

Imagens de referência: Opcionalmente envie até 2 imagens para alternar para o modo imagem para vídeo; a segunda imagem é mapeada para o frame final.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
duration	select	Não	5	-	5, 10
aspect_ratio	select	Não	16:9	-	16:9, 9:16, 1:1
negative_prompt	text	Não	-	-	-
cfg_scale	number	Não	0.5	min 0 / max 1	-

Kling V2.1 Master

kling-v2-1-masterDisponível via APIParcial: Files API necessária

Vídeo · O modelo de vídeo legado Kling V2.1 Master, da Kuaishou, agora oferece suporte a texto para vídeo e imagem para vídeo na Rivya. O preço atual é de 160 créditos para 5 segundos e 320 créditos para 10 segundos.

Guia da API Página do modelo

Créditos base

160

Modos

text-to-video, image-to-video

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

5000 caracteres

Mídia de referência

image · 1 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "kling-v2-1-master",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Descreva o que o vídeo deve evitar",
    "cfg_scale": 0.5
  }
}

Regra de referência

Imagem de referência: Opcionalmente envie uma imagem para alternar para o modo imagem para vídeo; deixe vazio para continuar no modo de texto.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
duration	select	Não	5	-	5, 10
aspect_ratio	select	Não	16:9	-	16:9, 9:16, 1:1
negative_prompt	text	Não	-	-	-
cfg_scale	number	Não	0.5	min 0 / max 1	-

Kling V2.1 Pro

kling-v2-1-proDisponível via APIFiles API necessária

Vídeo · O modelo legado de imagem para vídeo Kling V2.1 Pro, da Kuaishou, oferece suporte a um primeiro frame e uma imagem opcional de frame final. O preço atual é de 50 créditos para 5 segundos e 100 créditos para 10 segundos.

Guia da API Página do modelo

Créditos base

Modos

image-to-video

Input da API

Files API necessária

Entradas

file

Limite de prompt

5000 caracteres

Mídia de referência

image · 2 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

Nenhum exemplo executável da Public API é mostrado para este modelo.

Regra de referência

Imagens de referência: O modo de imagem aceita até 2 arquivos de imagem, e a segunda imagem é mapeada para o frame final.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos baseados em arquivo precisam de /api/v1/files antes de aparecerem como exemplos completos prontos para API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
duration	select	Não	5	-	5, 10
negative_prompt	text	Não	-	-	-
cfg_scale	number	Não	0.5	min 0 / max 1	-

Kling V2.1 Standard

kling-v2-1-standardDisponível via APIFiles API necessária

Vídeo · Modelo legado de imagem para vídeo Kling V2.1 Standard, da Kuaishou. O preço atual é de 25 créditos para 5 segundos e 50 créditos para 10 segundos.

Guia da API Página do modelo

Créditos base

Modos

image-to-video

Input da API

Files API necessária

Entradas

file

Limite de prompt

5000 caracteres

Mídia de referência

image · 1 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

Nenhum exemplo executável da Public API é mostrado para este modelo.

Regra de referência

Imagem de referência: O modo de imagem aceita até 1 arquivo de imagem como primeiro frame.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos baseados em arquivo precisam de /api/v1/files antes de aparecerem como exemplos completos prontos para API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
duration	select	Não	5	-	5, 10
negative_prompt	text	Não	-	-	-
cfg_scale	number	Não	0.5	min 0 / max 1	-

Kling AI Avatar Pro

kling-ai-avatar-proDisponível via APIFiles API necessária

Vídeo · Modelo de avatar falante Kling AI Avatar Pro, de qualidade mais alta, da Kuaishou, que usa uma imagem de retrato e um clipe de áudio para gerar vídeo de avatar com sincronização labial. A Rivya atualmente cobra um preço fixo de 16 créditos por geração.

Guia da API Página do modelo

Créditos base

Modos

image-to-video

Input da API

Files API necessária

Entradas

file

Limite de prompt

5000 caracteres

Mídia de referência

image, audio · 2 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

Nenhum exemplo executável da Public API é mostrado para este modelo.

Regra de referência

Imagem de retrato e áudio: Envie uma imagem de retrato e um clipe de áudio juntos.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos baseados em arquivo precisam de /api/v1/files antes de aparecerem como exemplos completos prontos para API. Files API

Parâmetros

Nenhum parâmetro adicional do modelo é necessário.

Kling AI Avatar Standard

kling-ai-avatar-standardDisponível via APIFiles API necessária

Vídeo · Modelo de avatar falante Kling AI Avatar Standard, da Kuaishou, que usa uma imagem de retrato e um clipe de áudio para gerar vídeo de avatar com sincronização labial. A Rivya atualmente cobra um preço fixo de 8 créditos por geração.

Guia da API Página do modelo

Créditos base

Modos

image-to-video

Input da API

Files API necessária

Entradas

file

Limite de prompt

5000 caracteres

Mídia de referência

image, audio · 2 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

Nenhum exemplo executável da Public API é mostrado para este modelo.

Regra de referência

Imagem de retrato e áudio: Envie uma imagem de retrato e um clipe de áudio juntos.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos baseados em arquivo precisam de /api/v1/files antes de aparecerem como exemplos completos prontos para API. Files API

Parâmetros

Nenhum parâmetro adicional do modelo é necessário.

Infinitalk

infinitalkDisponível via APIFiles API necessária

Vídeo · Infinitalk é um modelo de vídeo falado com retrato e áudio. O preço atual é medido por resolução e duração do áudio: 480p = 3 créditos por segundo e 720p = 12 créditos por segundo.

Guia da API Página do modelo

Créditos base

Modos

image-to-video

Input da API

Files API necessária

Entradas

file

Limite de prompt

5000 caracteres

Mídia de referência

image, audio · 2 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

Nenhum exemplo executável da Public API é mostrado para este modelo.

Regra de referência

Imagem de retrato e áudio: Envie uma imagem de retrato e um clipe de áudio juntos.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos baseados em arquivo precisam de /api/v1/files antes de aparecerem como exemplos completos prontos para API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
resolution	select	Não	480p	-	480p, 720p
seed	number	Não	-	min 10000 / max 1000000	-

Runway

runwayDisponível via APIParcial: Files API necessária

Vídeo · Runway é um modelo de vídeo independente que oferece suporte a texto para vídeo e imagem para vídeo. A evidência pública de preço atualmente confirma apenas 6 níveis de geração, então a Rivya mantém no conjunto verificado: `720p_5 = 12`, `720p_10 = 30` e `1080p_5 = 30`.

Guia da API Página do modelo

Créditos base

Modos

text-to-video, image-to-video

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

1800 caracteres

Mídia de referência

image · 1 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "runway",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "quality": "720p",
    "aspectRatio": "16:9",
    "waterMark": "Deixe vazio para desativar a watermark"
  }
}

Regra de referência

Imagem de referência: Opcionalmente envie uma imagem para alternar para o modo imagem para vídeo; deixe vazio para continuar no modo de texto.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
duration	select	Não	5	-	5, 10
quality	select	Não	720p	-	720p, 1080p
aspectRatio	select	Não	16:9	-	16:9, 4:3, 1:1, 3:4, 9:16
waterMark	text	Não	-	-	-

Runway Aleph

runway-alephDisponível via APIFiles API necessária

Vídeo · Projeto de transformação de vídeo-fonte para retrabalhar um clipe existente em um novo resultado visual. Use Aleph quando o movimento vem do seu material de entrada e a direção criativa vem do seu prompt, com preço fixo de 90 créditos.

Guia da API Página do modelo

Créditos base

Modos

video-to-video

Input da API

Files API necessária

Entradas

file

Limite de prompt

5000 caracteres

Mídia de referência

video, image · 2 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

Nenhum exemplo executável da Public API é mostrado para este modelo.

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.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos baseados em arquivo precisam de /api/v1/files antes de aparecerem como exemplos completos prontos para API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
aspectRatio	select	Não	16:9	-	16:9, 9:16, 4:3, 3:4, 1:1, 21:9
waterMark	text	Não	-	-	-
seed	number	Não	-	min 0 / max 2147483647	-

Luma Modify Video

luma-modify-videoDisponível via APIFiles API necessária

Vídeo · Projeto independente de reescrita de vídeo-fonte para empurrar um clipe existente em uma nova direção visual. Use quando o prompt deve transformar o próprio material, não apenas deixar a exportação mais nítida.

Guia da API Página do modelo

Créditos base

Modos

video-to-video

Input da API

Files API necessária

Entradas

file

Limite de prompt

Mídia de referência

video · 1 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

Nenhum exemplo executável da Public API é mostrado para este modelo.

Regra de referência

Vídeo de entrada: Envie um clipe-fonte curto que você quer transformar. Esta opção reescreve o material em vez de apenas aprimorá-lo.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos baseados em arquivo precisam de /api/v1/files antes de aparecerem como exemplos completos prontos para API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
watermark	text	Não	-	-	-

Grok Imagine Video

grok-imagine-videoDisponível via APIParcial: Files API necessária

Vídeo · Modelo de vídeo da xAI com modos criativos Fun/Normal/Spicy e 5 proporções. Predefinições de estilo únicas para diferentes tons criativos, do divertido ao cinematográfico e mais ousado.

Guia da API Página do modelo

Créditos base

Modos

text-to-video, image-to-video

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

5000 caracteres

Mídia de referência

image · 1 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "grok-imagine-video",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "mode": "normal",
    "duration": 6,
    "resolution": "480p",
    "aspect_ratio": "2:3"
  }
}

Regra de referência

Imagem de referência: Envie até 1 arquivo de imagem para projetos com imagem.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
mode	select	Não	normal	-	fun, normal, spicy
duration	number	Não	6	min 6 / max 30 / step 1	-
resolution	select	Não	480p	-	480p, 720p
aspect_ratio	select	Não	2:3	-	1:1, 16:9, 9:16, 2:3, 3:2

Sora 2 Pro

sora-2-proDisponível via APIParcial: Files API necessária

Vídeo · A faixa premium do Sora 2, com modos de qualidade Standard/High, clipes de 10s/15s e remoção de marca d'água. Maior detalhe, iluminação e fidelidade de movimento para produção profissional de vídeo.

Guia da API Página do modelo

Créditos base

Modos

text-to-video, image-to-video

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

10000 caracteres

Mídia de referência

image · 1 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "sora-2-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "size": "standard",
    "n_frames": "10",
    "aspect_ratio": "landscape",
    "remove_watermark": "false",
    "upload_method": "s3"
  }
}

Regra de referência

Imagem de referência: Envie até 1 arquivo de imagem para projetos de imagem.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
size	select	Não	-	-	standard, high
n_frames	select	Não	10	-	10, 15
aspect_ratio	select	Não	landscape	-	landscape, portrait
remove_watermark	select	Não	false	-	false, true
upload_method	select	Não	s3	-	s3, oss

Sora 2

sora-2Disponível via APIParcial: Files API necessária

Vídeo · O modelo de vídeo da OpenAI para texto para vídeo e imagem para vídeo, com simulação realista do mundo, áudio sincronizado, clipes de 10s/15s, saídas em paisagem/retrato e remoção opcional de marca d'água.

Guia da API Página do modelo

Créditos base

Modos

text-to-video, image-to-video

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

10000 caracteres

Mídia de referência

image · 1 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "sora-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "n_frames": "10",
    "aspect_ratio": "landscape",
    "remove_watermark": "false",
    "upload_method": "s3"
  }
}

Regra de referência

Imagem de referência: Envie até 1 arquivo de imagem para projetos de imagem.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
n_frames	select	Não	10	-	10, 15
aspect_ratio	select	Não	landscape	-	landscape, portrait
remove_watermark	select	Não	false	-	false, true
upload_method	select	Não	s3	-	s3, oss

Sora Watermark Remover

sora-watermark-removerDisponível via APIEntrada de URL pronta

Vídeo · O modelo de pós-processamento da Rivya para remoção de marca d'água do Sora em links públicos de compartilhamento Sora já finalizados. Use depois que o vídeo já estiver pronto, quando a tarefa restante for remover a marca d'água e escolher entrega em S3 ou OSS.

Guia da API Página do modelo

Créditos base

Modos

video-to-video

Input da API

Entrada de URL pronta

Entradas

url

Limite de prompt

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "sora-watermark-remover",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "video_url": "https://sora.chatgpt.com/p/...",
    "upload_method": "s3"
  }
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Este modelo aceita entrada de URL pública por meio dos parâmetros do modelo.

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
video_url	text	Sim	-	-	-
upload_method	select	Sim	s3	-	s3, oss

Topaz Video Upscaler

topaz-video-upscaleDisponível via APIFiles API necessária

Vídeo · O upscaler de vídeo em nível de entrega da Topaz na Rivya para clipes aprovados que só precisam de mais nitidez na exportação. Use quando a tomada, o movimento e o timing já estiverem certos e o problema restante for resolução ou nitidez do arquivo final.

Guia da API Página do modelo

Créditos base

Modos

video-to-video

Input da API

Files API necessária

Entradas

file

Limite de prompt

Mídia de referência

video · 1 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

Nenhum exemplo executável da Public API é mostrado para este modelo.

Regra de referência

Vídeo de origem: Envie 1 clipe de origem que você quer preservar. Esta opção melhora a clareza de entrega em vez de alterar a tomada.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos baseados em arquivo precisam de /api/v1/files antes de aparecerem como exemplos completos prontos para API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
upscale_factor	select	Não	2	-	1, 2, 4

Veo3.1 Quality

veo3-1-qualityDisponível via APIParcial: Files API necessária

Vídeo · A variante do Google Veo 3.1 voltada primeiro para qualidade em geração premium de texto para vídeo e guiada por imagem. Visuais com maior fidelidade, realismo de movimento mais forte e áudio de fundo por padrão fazem dela a opção Veo mais avançada da Rivya.

Guia da API Página do modelo

Créditos base

150

Modos

text-to-video, image-to-video

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

5000 caracteres

Mídia de referência

image · 2 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "veo3-1-quality",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "watermark": "Texto opcional de marca d'água",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

Regra de referência

Imagem de referência: Envie até 2 arquivos de imagem para o projeto guiado por imagem compatível.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
aspectRatio	select	Não	16:9	-	16:9, 9:16, Auto
watermark	text	Não	-	-	-
seeds	number	Não	-	min 10000 / max 99999 / step 1	-
enableTranslation	select	Não	true	-	true, false

Veo3.1 Fast

veo3-1-fastDisponível via APIParcial: Files API necessária

Vídeo · A variante rápida do Google Veo 3.1 com suporte a três modos: texto para vídeo, imagem para vídeo e referência para vídeo. Até 3 imagens de referência, áudio nativo e controles de proporção sensíveis ao modo tornam a opção útil para clipes cinematográficos rápidos.

Guia da API Página do modelo

Créditos base

Modos

text-to-video, image-to-video, reference-to-video

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

5000 caracteres

Mídia de referência

image · 3 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "veo3-1-fast",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "generationType": "FIRST_AND_LAST_FRAMES_2_VIDEO",
    "aspectRatio": "16:9",
    "watermark": "Texto opcional de marca d'água",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

Regra de referência

Imagem de referência: Envie até 3 arquivos de imagem para projetos guiados por imagem e referência.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
generationType	select	Não	FIRST_AND_LAST_FRAMES_2_VIDEO	-	FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEO
aspectRatio	select	Não	16:9	-	16:9, 9:16, Auto
watermark	text	Não	-	-	-
seeds	number	Não	-	min 10000 / max 99999 / step 1	-
enableTranslation	select	Não	true	-	true, false

Veo3.1 Lite

veo3-1-liteDisponível via APIParcial: Files API necessária

Vídeo · A variante de menor custo do Google Veo 3.1. A Rivya atualmente expõe apenas o menor subconjunto estável: texto para vídeo e imagem para vídeo a um custo fixo de `10` créditos por geração.

Guia da API Página do modelo

Créditos base

Modos

text-to-video, image-to-video

Input da API

Parcial: Files API necessária

Entradas

text, file

Limite de prompt

5000 caracteres

Mídia de referência

image · 2 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "veo3-1-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "watermark": "Texto opcional de marca d'água",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

Regra de referência

Imagem de referência: Envie até 2 arquivos de imagem para o projeto guiado por imagem compatível.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos de prompt ou URL talvez já possam ser chamados. Modos com mídia de referência ainda precisam de suporte a upload pela Files API. Files API

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
aspectRatio	select	Não	16:9	-	16:9, 9:16, Auto
watermark	text	Não	-	-	-
seeds	number	Não	-	min 10000 / max 99999 / step 1	-
enableTranslation	select	Não	true	-	true, false

Suno Music

suno-musicDisponível via APIInput de texto pronto

Áudio · Suno Music é o modelo de texto para música da Rivya para transformar um briefing curto em um primeiro rascunho de música, com ou sem vocais. Ele mantém o ponto de entrada fixo de `12` créditos e expõe `Extend Music` como a próxima etapa depois de uma faixa bem-sucedida.

Guia da API Página do modelo

Créditos base

Modos

text-to-audio

Input da API

Input de texto pronto

Entradas

text

Limite de prompt

500 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "suno-music",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "model": "V4_5",
    "instrumental": "false"
  }
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
model	select	Não	V4_5	-	V4, V4_5, V4_5PLUS, V4_5ALL, V5, V5_5
instrumental	select	Não	false	-	false, true

Suno Sounds

suno-soundsDisponível via APIInput de texto pronto

Áudio · Suno Sounds é o modelo leve de texto para som da Rivya para loops de ambiência, som de fundo e esboços sonoros curtos. Ele mantém o preço fixo documentado de `3` créditos por geração e permite que resultados bem-sucedidos continuem para `Vocal Separation`.

Guia da API Página do modelo

Créditos base

Modos

text-to-audio

Input da API

Input de texto pronto

Entradas

text

Limite de prompt

500 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "suno-sounds",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "model": "V5",
    "soundLoop": "false",
    "soundTempo": 1,
    "soundKey": "Any"
  }
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
model	select	Não	V5	-	V5, V5_5
soundLoop	select	Não	false	-	false, true
soundTempo	number	Não	-	min 1 / max 300 / step 1	-
soundKey	select	Não	Any	-	Any, Cm, C#m, Dm, D#m, Em, Fm, F#m, Gm, G#m, Am, A#m, Bm, C, C#, D, D#, E, F, F#, G, G#, A, A#, B

Suno Lyrics

suno-lyricsDisponível via APIInput de texto pronto

Áudio · Suno Lyrics é o modelo de geração de letras da Rivya para transformar um tema ou mood em palavras de música, com custo fixo de `1` crédito por solicitação.

Guia da API Página do modelo

Créditos base

Modos

text-to-audio

Input da API

Input de texto pronto

Entradas

text

Limite de prompt

200 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "suno-lyrics",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parâmetros

Nenhum parâmetro adicional do modelo é necessário.

ElevenLabs Dialogue V3

elevenlabs-dialogue-v3Disponível via APIInput de texto pronto

Áudio · O modelo de diálogo com múltiplos falantes da ElevenLabs na Rivya. Ele foi criado para geração de fala com papéis definidos, com atribuições individuais de voz, controles de estabilidade e ritmo adequado para diálogo em podcasts, entrevistas e cenas com personagens.

Guia da API Página do modelo

Créditos base

Modos

dialogue-to-audio

Input da API

Input de texto pronto

Entradas

text

Limite de prompt

5000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "elevenlabs-dialogue-v3",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "default_voice": "Adam",
    "stability": "0.5"
  }
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
default_voice	select	Não	Adam	-	Adam, Alice, Bill, Brian, Callum, Charlie, Chris, Daniel, Eric, George, Harry, Jessica, Laura, Liam, Lily, Matilda, River, Roger, Sarah, Will
stability	select	Não	0.5	-	0, 0.5, 1
language_code	text	Não	-	-	-

ElevenLabs Turbo 2.5

elevenlabs-turbo-2-5Disponível via APIInput de texto pronto

Áudio · O modelo rápido de texto para fala da ElevenLabs na Rivya. Com geração de voz de baixa latência e estabilidade, similaridade, estilo e velocidade ajustáveis, ele foi criado para rascunhos rápidos de locução e projetos interativos de texto para fala.

Guia da API Página do modelo

Créditos base

Modos

text-to-speech

Input da API

Input de texto pronto

Entradas

text

Limite de prompt

5000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "elevenlabs-turbo-2-5",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "voice": "TX3LPaxmHKxFdv7VOQHJ",
    "stability": 0.5,
    "similarity_boost": 0.75,
    "style": 0,
    "speed": 1,
    "timestamps": "false",
    "previous_text": "Contexto opcional antes desta linha",
    "next_text": "Contexto opcional depois desta linha",
    "language_code": "Código de idioma opcional, como en ou zh"
  }
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
voice	select	Sim	TX3LPaxmHKxFdv7VOQHJ	-	TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8
stability	number	Não	0.5	min 0 / max 1 / step 0.05	-
similarity_boost	number	Não	0.75	min 0 / max 1 / step 0.05	-
style	number	Não	0	min 0 / max 1 / step 0.05	-
speed	number	Não	1	min 0.7 / max 1.2 / step 0.05	-
timestamps	select	Não	false	-	false, true
previous_text	text	Não	-	-	-
next_text	text	Não	-	-	-
language_code	text	Não	-	-	-

ElevenLabs Multilingual V2

elevenlabs-multilingual-v2Disponível via APIInput de texto pronto

Áudio · O modelo multilíngue de texto para fala da ElevenLabs na Rivya, com suporte a cerca de 30 idiomas e detecção automática. É a opção mais forte para localização, execução entre idiomas e locuções multilíngues mais naturais.

Guia da API Página do modelo

Créditos base

Modos

text-to-speech

Input da API

Input de texto pronto

Entradas

text

Limite de prompt

5000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "elevenlabs-multilingual-v2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "voice": "TX3LPaxmHKxFdv7VOQHJ",
    "stability": 0.5,
    "similarity_boost": 0.75,
    "style": 0,
    "speed": 1,
    "timestamps": "false"
  }
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
voice	select	Sim	TX3LPaxmHKxFdv7VOQHJ	-	TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8
stability	number	Não	0.5	min 0 / max 1 / step 0.05	-
similarity_boost	number	Não	0.75	min 0 / max 1 / step 0.05	-
style	number	Não	0	min 0 / max 1 / step 0.05	-
speed	number	Não	1	min 0.7 / max 1.2 / step 0.05	-
timestamps	select	Não	false	-	false, true
previous_text	text	Não	-	-	-
next_text	text	Não	-	-	-
language_code	text	Não	-	-	-

ElevenLabs Sound Effect V2

elevenlabs-sound-effect-v2Disponível via APIInput de texto pronto

Áudio · O modelo de texto para som da ElevenLabs na Rivya para efeitos curtos, transições e loops de ambiência. Gere clipes de áudio de 0,5 a 22 segundos com influência de prompt ajustável, modo de loop e 19 formatos de saída para projetos de edição, produto ou jogos.

Guia da API Página do modelo

Créditos base

Modos

text-to-audio

Input da API

Input de texto pronto

Entradas

text

Limite de prompt

5000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "elevenlabs-sound-effect-v2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "loop": "false",
    "duration_seconds": 3,
    "prompt_influence": 0.3,
    "output_format": "mp3_44100_128"
  }
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parâmetros

key	Tipo	Obrigatório	Padrão	Intervalo	Opções
loop	select	Não	false	-	false, true
duration_seconds	number	Não	3	min 0.5 / max 22 / step 0.5	-
prompt_influence	number	Não	0.3	min 0 / max 1 / step 0.05	-
output_format	select	Não	mp3_44100_128	-	mp3_22050_32, mp3_44100_32, mp3_44100_64, mp3_44100_96, mp3_44100_128, mp3_44100_192, pcm_8000, pcm_16000, pcm_22050, pcm_24000, pcm_44100, pcm_48000, ulaw_8000, alaw_8000, opus_48000_32, opus_48000_64, opus_48000_96, opus_48000_128, opus_48000_192

ElevenLabs Audio Isolation

elevenlabs-audio-isolationDisponível via APIFiles API necessária

Áudio · O modelo da ElevenLabs para limpeza de áudio e isolamento de voz na Rivya. Envie uma gravação para isolar vocais, remover ruído de fundo e limpar áudio falado antes de editar ou publicar.

Guia da API Página do modelo

Créditos base

Modos

audio-to-audio

Input da API

Files API necessária

Entradas

file

Limite de prompt

Mídia de referência

audio · 1 arquivo(s)

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

Nenhum exemplo executável da Public API é mostrado para este modelo.

Regra de referência

Áudio de origem: Envie um arquivo de áudio e a Rivya isolará e limpará a faixa desejada.

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

Modos baseados em arquivo precisam de /api/v1/files antes de aparecerem como exemplos completos prontos para API. Files API

Parâmetros

Nenhum parâmetro adicional do modelo é necessário.

GPT-5.5

gpt-5-5-chatDisponível via APIInput de texto pronto

Chat · O modelo avançado de chat GPT da OpenAI na Rivya para raciocínio complexo, análise com imagens, síntese de pesquisa e escrita estruturada quando o brief precisa de mais espaço.

Guia da API Página do modelo

Créditos base

Modos

responses

Input da API

Input de texto pronto

Entradas

text, file

Limite de prompt

20000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "gpt-5-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

A Chat API oferece suporte a turnos non-streaming e SSE streaming na Public API v1. Anexos de imagem devem usar valores file_id da Files API.

Parâmetros

Nenhum parâmetro adicional do modelo é necessário.

GPT-5.4

gpt-5-4-chatDisponível via APIInput de texto pronto

Chat · O modelo de chat de IA mais avançado da OpenAI na Rivya, com tratamento mais forte de entradas estruturadas, controle de raciocínio e projetos de conversa orientados a ferramentas para tarefas mais complexas de análise e escrita.

Guia da API Página do modelo

Créditos base

Modos

responses

Input da API

Input de texto pronto

Entradas

text, file

Limite de prompt

20000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "gpt-5-4-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

A Chat API oferece suporte a turnos non-streaming e SSE streaming na Public API v1. Anexos de imagem devem usar valores file_id da Files API.

Parâmetros

Nenhum parâmetro adicional do modelo é necessário.

GPT-5.4 Codex

gpt-5.4-codex-chatDisponível via APIInput de texto pronto

Chat · O modelo Codex de nível mais alto da OpenAI na Rivya, com codificação mais forte, raciocínio estruturado e colaboração orientada a ferramentas para projetos de desenvolvimento exigentes em escala de repositório.

Guia da API Página do modelo

Créditos base

Modos

responses

Input da API

Input de texto pronto

Entradas

text, file

Limite de prompt

20000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "gpt-5.4-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

A Chat API oferece suporte a turnos non-streaming e SSE streaming na Public API v1. Anexos de imagem devem usar valores file_id da Files API.

Parâmetros

Nenhum parâmetro adicional do modelo é necessário.

GPT-5.3 Codex

gpt-5-3-codex-chatDisponível via APIInput de texto pronto

Chat · O modelo Codex mais recente e capaz da OpenAI na Rivya. Ele combina geração de código de ponta com raciocínio mais profundo para agentes nos projetos de desenvolvimento mais exigentes.

Guia da API Página do modelo

Créditos base

Modos

responses

Input da API

Input de texto pronto

Entradas

text, file

Limite de prompt

20000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "gpt-5-3-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

A Chat API oferece suporte a turnos non-streaming e SSE streaming na Public API v1. Anexos de imagem devem usar valores file_id da Files API.

Parâmetros

Nenhum parâmetro adicional do modelo é necessário.

GPT-5.2

gpt-5-2-chatDisponível via APIInput de texto pronto

Chat · O modelo principal de chat de IA da OpenAI na Rivya, com raciocínio avançado, suporte visual para até 6 imagens e janela de contexto de 20K caracteres. É uma opção GPT geral forte para pesquisa, planejamento, escrita e análise com imagens.

Guia da API Página do modelo

Créditos base

Modos

chat-completion

Input da API

Input de texto pronto

Entradas

text, file

Limite de prompt

20000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "gpt-5-2-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

A Chat API oferece suporte a turnos non-streaming e SSE streaming na Public API v1. Anexos de imagem devem usar valores file_id da Files API.

Parâmetros

Nenhum parâmetro adicional do modelo é necessário.

GPT-5.2 Codex

gpt-5-2-codex-chatDisponível via APIInput de texto pronto

Chat · O modelo Codex mais avançado da OpenAI na Rivya, com raciocínio mais forte para tarefas complexas de engenharia. Ele é otimizado para codificação com agentes em horizontes longos, decisões de arquitetura e refatorações maiores em que geração simples de código não basta.

Guia da API Página do modelo

Créditos base

Modos

responses

Input da API

Input de texto pronto

Entradas

text, file

Limite de prompt

20000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "gpt-5-2-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

A Chat API oferece suporte a turnos non-streaming e SSE streaming na Public API v1. Anexos de imagem devem usar valores file_id da Files API.

Parâmetros

Nenhum parâmetro adicional do modelo é necessário.

GPT-5.1 Codex

gpt-5-1-codex-chatDisponível via APIInput de texto pronto

Chat · O modelo Codex atualizado da OpenAI na Rivya, com maior precisão de código e raciocínio mais forte para tarefas de codificação com agentes. Ele mantém o mesmo projeto ciente do repositório e com saída longa, ao mesmo tempo em que melhora refatorações de múltiplos arquivos e edições de código mais seguras.

Guia da API Página do modelo

Créditos base

Modos

responses

Input da API

Input de texto pronto

Entradas

text, file

Limite de prompt

20000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "gpt-5-1-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

A Chat API oferece suporte a turnos non-streaming e SSE streaming na Public API v1. Anexos de imagem devem usar valores file_id da Files API.

Parâmetros

Nenhum parâmetro adicional do modelo é necessário.

GPT-5 Codex

gpt-5-codex-chatDisponível via APIInput de texto pronto

Chat · O modelo GPT-5 Codex especializado em código da OpenAI na Rivya para depuração, planejamento de implementação, refatorações e solução de problemas técnicos com suporte visual.

Guia da API Página do modelo

Créditos base

Modos

responses

Input da API

Input de texto pronto

Entradas

text, file

Limite de prompt

20000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "gpt-5-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

A Chat API oferece suporte a turnos non-streaming e SSE streaming na Public API v1. Anexos de imagem devem usar valores file_id da Files API.

Parâmetros

Nenhum parâmetro adicional do modelo é necessário.

Gemini 3.1 Pro

gemini-3-1-pro-chatDisponível via APIInput de texto pronto

Chat · O modelo de chat Gemini com IA mais recente e capaz do Google na Rivya. Com raciocínio de ponta, suporte visual e seguimento de instruções, é a opção Gemini mais forte para tarefas analíticas e criativas exigentes.

Guia da API Página do modelo

Créditos base

Modos

chat-completion

Input da API

Input de texto pronto

Entradas

text, file

Limite de prompt

20000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "gemini-3-1-pro-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

A Chat API oferece suporte a turnos non-streaming e SSE streaming na Public API v1. Anexos de imagem devem usar valores file_id da Files API.

Parâmetros

Nenhum parâmetro adicional do modelo é necessário.

Gemini 3 Pro

gemini-3-pro-chatDisponível via APIInput de texto pronto

Chat · O modelo de chat Gemini com IA de maior profundidade do Google na Rivya. Com raciocínio mais forte que Gemini 2.5 Pro e suporte visual, ele é mais adequado para síntese de pesquisa, escrita técnica e análise multimodal mais deliberada.

Guia da API Página do modelo

Créditos base

Modos

chat-completion

Input da API

Input de texto pronto

Entradas

text, file

Limite de prompt

20000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "gemini-3-pro-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

A Chat API oferece suporte a turnos non-streaming e SSE streaming na Public API v1. Anexos de imagem devem usar valores file_id da Files API.

Parâmetros

Nenhum parâmetro adicional do modelo é necessário.

Gemini 3 Flash

gemini-3-flash-chatDisponível via APIInput de texto pronto

Chat · O modelo rápido de chat de IA de próxima geração do Google na Rivya. Com custos de token ainda menores que Gemini 2.5 Flash e raciocínio mais forte, ele foi criado para chat multimodal em alto volume, triagem de capturas de tela e trabalho rápido de assistente.

Guia da API Página do modelo

Créditos base

Modos

chat-completion

Input da API

Input de texto pronto

Entradas

text, file

Limite de prompt

20000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "gemini-3-flash-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

A Chat API oferece suporte a turnos non-streaming e SSE streaming na Public API v1. Anexos de imagem devem usar valores file_id da Files API.

Parâmetros

Nenhum parâmetro adicional do modelo é necessário.

Gemini 2.5 Pro

gemini-2-5-pro-chatDisponível via APIInput de texto pronto

Chat · O modelo de chat Gemini com IA mais avançado do Google na Rivya. Com raciocínio mais forte que o Flash, suporte visual e contexto de 20K, ele é mais adequado para síntese de pesquisa, análise de documentos e escrita estruturada a 2 créditos.

Guia da API Página do modelo

Créditos base

Modos

chat-completion

Input da API

Input de texto pronto

Entradas

text, file

Limite de prompt

20000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "gemini-2-5-pro-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

A Chat API oferece suporte a turnos non-streaming e SSE streaming na Public API v1. Anexos de imagem devem usar valores file_id da Files API.

Parâmetros

Nenhum parâmetro adicional do modelo é necessário.

Gemini 2.5 Flash

gemini-2-5-flash-chatDisponível via APIInput de texto pronto

Chat · O modelo de chat de IA mais rápido e acessível do Google na Rivya. Com 1 crédito por uso e suporte visual para até 6 imagens, ele se encaixa em perguntas e respostas rápidas, resumos iniciais, triagem de capturas de tela e assistência de IA do dia a dia.

Guia da API Página do modelo

Créditos base

Modos

chat-completion

Input da API

Input de texto pronto

Entradas

text, file

Limite de prompt

20000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "gemini-2-5-flash-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

A Chat API oferece suporte a turnos non-streaming e SSE streaming na Public API v1. Anexos de imagem devem usar valores file_id da Files API.

Parâmetros

Nenhum parâmetro adicional do modelo é necessário.

Claude Opus 4.7

claude-opus-4-7-chatDisponível via APIInput de texto pronto

Chat · O modelo de chat Claude principal da Anthropic na Rivya para raciocínio profundo, síntese cuidadosa, escrita executiva e trabalho textual de alto impacto.

Guia da API Página do modelo

Créditos base

Modos

chat-completion

Input da API

Input de texto pronto

Entradas

text

Limite de prompt

20000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "claude-opus-4-7-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

A Chat API oferece suporte a turnos non-streaming e SSE streaming na Public API v1. Anexos de imagem não são aceitos por este modelo de Chat.

Parâmetros

Nenhum parâmetro adicional do modelo é necessário.

Claude Opus 4.6

claude-opus-4-6-chatDisponível via APIInput de texto pronto

Chat · O modelo principal de chat Claude com IA da Anthropic na Rivya. Ele foi criado para raciocínio profundo, análise complexa e escrita de alta qualidade em projetos exigentes e de alta responsabilidade.

Guia da API Página do modelo

Créditos base

Modos

chat-completion

Input da API

Input de texto pronto

Entradas

text

Limite de prompt

20000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "claude-opus-4-6-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

A Chat API oferece suporte a turnos non-streaming e SSE streaming na Public API v1. Anexos de imagem não são aceitos por este modelo de Chat.

Parâmetros

Nenhum parâmetro adicional do modelo é necessário.

Claude Sonnet 4.6

claude-sonnet-4-6-chatDisponível via APIInput de texto pronto

Chat · O modelo de chat Claude com IA equilibrado da Anthropic na Rivya. Ele mantém raciocínio forte de formato longo e análise cuidadosa para projetos de conteúdo, pesquisa e programação sem saltar para o gasto em nível Opus.

Guia da API Página do modelo

Créditos base

Modos

chat-completion

Input da API

Input de texto pronto

Entradas

text

Limite de prompt

20000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "claude-sonnet-4-6-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

A Chat API oferece suporte a turnos non-streaming e SSE streaming na Public API v1. Anexos de imagem não são aceitos por este modelo de Chat.

Parâmetros

Nenhum parâmetro adicional do modelo é necessário.

Claude Opus 4.5

claude-opus-4-5-chatDisponível via APIInput de texto pronto

Chat · Modelo principal de chat Claude com IA da Anthropic na Rivya. Ele se destaca em raciocínio profundo, análise complexa e escrita de nível especialista, tornando-se uma escolha premium para tarefas de IA críticas.

Guia da API Página do modelo

Créditos base

Modos

chat-completion

Input da API

Input de texto pronto

Entradas

text

Limite de prompt

20000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "claude-opus-4-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

A Chat API oferece suporte a turnos non-streaming e SSE streaming na Public API v1. Anexos de imagem não são aceitos por este modelo de Chat.

Parâmetros

Nenhum parâmetro adicional do modelo é necessário.

Claude Sonnet 4.5

claude-sonnet-4-5-chatDisponível via APIInput de texto pronto

Chat · O modelo de chat Claude com IA equilibrado da Anthropic na Rivya. Ele é forte em escrita sutil, análise cuidadosa e respostas com atenção à segurança, tornando-se uma opção Claude sólida para criação de conteúdo e pesquisa.

Guia da API Página do modelo

Créditos base

Modos

chat-completion

Input da API

Input de texto pronto

Entradas

text

Limite de prompt

20000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "claude-sonnet-4-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

A Chat API oferece suporte a turnos non-streaming e SSE streaming na Public API v1. Anexos de imagem não são aceitos por este modelo de Chat.

Parâmetros

Nenhum parâmetro adicional do modelo é necessário.

Claude Haiku 4.5

claude-haiku-4-5-chatDisponível via APIInput de texto pronto

Chat · Modelo leve de chat Claude com IA da Anthropic na Rivya. Ele é ajustado para velocidade, eficiência de custo e desempenho estável em chats do dia a dia para projetos de alta frequência em que você quer o tom Claude sem gasto de nível premium.

Guia da API Página do modelo

Créditos base

Modos

chat-completion

Input da API

Input de texto pronto

Entradas

text

Limite de prompt

20000 caracteres

Mídia de referência

Requisição

POST /api/v1/generations

Autenticação

Chave de API Bearer

Idempotency-Key

Recomendado

Corpo

{
  "model": "claude-haiku-4-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regra de referência

Resultado

A resposta de criação retorna um ID público de tarefa. Consulte GET /api/v1/generations/{taskId} até o status ser succeeded ou failed.

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, not_found

A Chat API oferece suporte a turnos non-streaming e SSE streaming na Public API v1. Anexos de imagem não são aceitos por este modelo de Chat.

Parâmetros

Nenhum parâmetro adicional do modelo é necessário.

Referência da API de Modelos

Como Ler Esta Referência

Padrão de Solicitação

Referência Dinâmica de Modelos

Use esta referência com o depurador

Z-Image

Corpo

Parâmetros

Nano Banana 2

Corpo

Parâmetros

Nano Banana Pro

Corpo

Parâmetros

Nano Banana

Corpo

Parâmetros

GPT Image 2

Corpo

Parâmetros

GPT Image 1.5

Corpo

Parâmetros

4o Image

Corpo

Parâmetros

Seedream 5.0 Lite

Corpo

Parâmetros

Seedream 4.5

Corpo

Parâmetros

Seedream 4.0

Corpo

Parâmetros

Seedream 3.0

Corpo

Parâmetros

Grok Imagine

Corpo

Parâmetros

Flux 2 Pro

Corpo

Parâmetros

Flux 2 Flex

Corpo

Parâmetros

Flux Kontext Max

Corpo

Parâmetros

Flux Kontext Pro

Corpo

Parâmetros

Qwen2 Image

Corpo

Parâmetros

Qwen Image

Corpo

Parâmetros

Midjourney

Corpo

Parâmetros

Recraft Remove Background

Corpo

Parâmetros

Recraft Crisp Upscale

Corpo

Parâmetros

Wan 2.7 Image Pro

Corpo

Parâmetros

Wan 2.7 Image

Corpo

Parâmetros

Google Imagen4 Ultra

Corpo

Parâmetros

Google Imagen4

Corpo

Parâmetros