Documentación de Rivya AI

Referencia de modelos de la API

Consulta IDs de modelos de Rivya API, disponibilidad, modos admitidos, tablas de parámetros, límites de prompt, reglas de medios de referencia y enlaces de detalle de modelo.

Última revisión el 2026/05/11

Esta página es la referencia de API a nivel de modelo para Rivya API v1.

La tabla siguiente se genera desde el mismo catálogo de modelos y serializer público que usa /api/v1/models. No es un conteo fijo de modelos escrito a mano.

Cómo leer esta referencia

  • Usa el id del modelo como model en POST /api/v1/generations para modelos asíncronos de imagen, video y audio.
  • Usa los IDs de modelos de chat en POST /api/v1/chat/completions.
  • Usa prompt de nivel superior para el texto del prompt de generación.
  • Usa message de nivel superior para turnos de Chat API.
  • Coloca los campos específicos del modelo asíncrono dentro de params.
  • Lee api_input_status antes de construir una integración. available_text y available_url_input pueden probarse sin subir archivos; partial_requires_files significa que solo algunos modos necesitan Files API; requires_files_api significa que debes subir medios de referencia mediante Files API antes de llamar al modelo.
  • Para modelos de chat, lee chat_capabilities para confirmar soporte sin streaming, soporte de streaming SSE, adjuntos de imagen file_id, búsqueda web, thoughts y reasoning effort.
  • Las páginas de detalle de modelo dan orientación y ejemplos a nivel de producto.

Patrón de solicitud

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

Para ejemplos en JavaScript y Python, consulta crear generación.

Forma de solicitud de Chat:

{
  "model": "gpt-5-2-chat",
  "message": "Write a concise launch plan for a new product image campaign"
}

Para ejemplos de Chat, consulta Chat API.

Referencia dinámica de modelos

Usa esta referencia con el depurador

Empieza por el quickstart, confirma aquí los campos del modelo y luego ejecuta una solicitud mock o real con sesión iniciada en el depurador de Developers.

Z-Image

z-imageDisponible vía APIEntrada de texto lista

Imagen · El modelo ligero de texto a imagen de Alibaba. Generación rápida de una sola imagen con 5 relaciones de aspecto, ideal para borradores conceptuales rápidos y visuales de redes sociales por solo 1 crédito.

Créditos base

1

Modos

text-to-image

Entrada de API

Entrada de texto lista

Entradas

text

Límite de prompt

1000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
aspect_ratioselectNo1:1-1:1, 4:3, 3:4, 16:9, 9:16

Nano Banana 2

nano-banana-2Disponible vía APIParcial: requiere Files API

Imagen · Modelo de imagen de nueva generación de Google con resolución 4K, 15 relaciones de aspecto (incluida la extrema 8:1), fundamentación con Google Search y hasta 14 imágenes de referencia: el generador de imágenes más flexible en Rivya.

Créditos base

5

Modos

text-to-image, image-to-image

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

20000 caracteres

Medios de referencia

image · 14 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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"
  }
}

Regla de referencia

Imagen de referencia: Sube hasta 14 archivos de imagen para proyectos de imagen.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
aspect_ratioselectNoauto-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
resolutionselectNo1K-1K, 2K, 4K
output_formatselectNojpg-jpg, png
google_searchselectNofalse-false, true

Nano Banana Pro

nano-banana-proDisponible vía APIParcial: requiere Files API

Imagen · Modelo de imagen premium de Google con salida 4K, 11 relaciones de aspecto y hasta 8 imágenes de referencia. Optimizado para visuales de marca y campaña de alta fidelidad, con mejor detalle y precisión de color.

Créditos base

8

Modos

text-to-image, image-to-image

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

10000 caracteres

Medios de referencia

image · 8 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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"
  }
}

Regla de referencia

Imagen de referencia: Sube hasta 8 archivos de imagen para proyectos de imagen.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
aspect_ratioselectNo1:1-1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, auto
resolutionselectNo1K-1K, 2K, 4K
output_formatselectNopng-png, jpg

Nano Banana

nano-bananaDisponible vía APIParcial: requiere Files API

Imagen · Modelo de imagen flexible de Google para texto a imagen e imagen a imagen, con 11 relaciones de aspecto, hasta 10 imágenes de referencia y salida PNG/JPEG. Encaja muy bien en retratos, composiciones de producto y visuales amplios para landing pages.

Créditos base

3

Modos

text-to-image, image-to-image

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

5000 caracteres

Medios de referencia

image · 10 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

Imagen de referencia: Sube hasta 10 archivos de imagen para proyectos de imagen.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
imageSizeselectNo1:1-1:1, 9:16, 16:9, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9, auto
output_formatselectNopng-png, jpeg

GPT Image 2

gpt-image-2Disponible vía APIParcial: requiere Files API

Imagen · Modelo GPT Image más nuevo de OpenAI en Rivya, con texto a imagen, imagen a imagen, hasta 16 imágenes de referencia y niveles claros de créditos para 1K / 2K / 4K.

Créditos base

3

Modos

text-to-image, image-to-image

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

20000 caracteres

Medios de referencia

image · 16 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

Imágenes de referencia: Sube hasta 16 referencias de imagen para tareas imagen a imagen de GPT Image 2.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
aspect_ratioselectNo1:1-auto, 1:1, 9:16, 16:9, 4:3, 3:4
resolutionselectNo1K-1K, 2K, 4K

GPT Image 1.5

gpt-image-1-5Disponible vía APIParcial: requiere Files API

Imagen · Modelo de imagen de OpenAI con niveles de calidad medium/high y hasta 16 imágenes de referencia. Destaca siguiendo instrucciones complejas y renderizando escenas coherentes con relaciones espaciales precisas.

Créditos base

4

Modos

text-to-image, image-to-image

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

-

Medios de referencia

image · 16 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

Imagen de referencia: Sube hasta 16 archivos de imagen para proyectos de imagen.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
qualityselectNomedium-medium, high
aspect_ratioselectNo1:1-1:1, 2:3, 3:2

4o Image

4o-imageDisponible vía APIEntrada de texto lista

Imagen · El modelo 4o Image de OpenAI ya está disponible en Rivya como una ruta dedicada de texto a imagen. Por ahora mantiene una configuración de página intencionalmente estrecha: prompt más 3 relaciones de aspecto compatibles a un precio fijo de 3 créditos por imagen.

Créditos base

3

Modos

text-to-image

Entrada de API

Entrada de texto lista

Entradas

text

Límite de prompt

-

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
sizeselectNo1:1-1:1, 3:2, 2:3

Seedream 5.0 Lite

seedream-5-liteDisponible vía APIParcial: requiere Files API

Imagen · Modelo de imagen Seedream más ligero de ByteDance con precio compartido para texto a imagen y edición de imagen. Admite 8 relaciones de aspecto, hasta 14 imágenes de referencia y actualmente cuesta 6 créditos por ejecución.

Créditos base

6

Modos

text-to-image, image-to-image

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

3000 caracteres

Medios de referencia

image · 14 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

Imagen de referencia: Sube hasta 14 archivos de imagen para proyectos de imagen.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
aspectRatioselectNo1:1-1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
qualityselectNobasic-basic, high

Seedream 4.5

seedream-4-5Disponible vía APIParcial: requiere Files API

Imagen · Modelo de imagen de gama alta de ByteDance con niveles de calidad 2K/4K, 8 relaciones de aspecto y hasta 14 imágenes de referencia. Conocido por su gradación de color cinematográfica y detalle rico de texturas en visuales de moda y lifestyle.

Créditos base

7

Modos

text-to-image, image-to-image

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

3000 caracteres

Medios de referencia

image · 14 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

Imagen de referencia: Sube hasta 14 archivos de imagen para proyectos de imagen.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
aspectRatioselectNo1:1-1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
qualityselectNobasic-basic, high

Seedream 4.0

seedream-4-0Disponible vía APIParcial: requiere Files API

Imagen · Seedream 4.0 es un modelo de imagen equilibrado de ByteDance en Rivya para generación de texto a imagen, edición con imágenes de referencia y controles explícitos de salida.

Créditos base

6

Modos

text-to-image, image-to-image

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

5000 caracteres

Medios de referencia

image · 10 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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"
  }
}

Regla de referencia

Imágenes de referencia: Sube hasta 10 imágenes para la ruta de edición de Seedream 4.0.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
image_sizeselectNosquare_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_resolutionselectNo1K-1K, 2K, 4K
max_imagesnumberNo1min 1 / max 6 / step 1-
seednumberNo-min 0 / max 2147483647 / step 1-
nsfw_checkerselectNofalse-false, true

Seedream 3.0

seedream-3-0Disponible vía APIEntrada de texto lista

Imagen · Seedream 3.0 vuelve como modelo de imagen legacy independiente en Rivya. Actualmente conserva solo la ruta pública de texto a imagen y cuesta 5 créditos por ejecución.

Créditos base

5

Modos

text-to-image

Entrada de API

Entrada de texto lista

Entradas

text

Límite de prompt

5000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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
  }
}

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
image_sizeselectNosquare_hd-square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
guidance_scalenumberNo2.5min 1 / max 10 / step 0.1-
seednumberNo-min 0 / max 2147483647-

Grok Imagine

grok-imagineDisponible vía APIParcial: requiere Files API

Imagen · Modelo de imagen de xAI con fuerte interpretación creativa y 5 relaciones de aspecto. Generación de una sola imagen enfocada en expresión artística y estilos visuales no convencionales.

Créditos base

4

Modos

text-to-image, image-to-image

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

5000 caracteres

Medios de referencia

image · 1 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

Imagen de referencia: Sube hasta 1 archivo de imagen para proyectos de imagen.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
aspect_ratioselectNo1:1-1:1, 2:3, 3:2, 16:9, 9:16
enable_proselectNofalse-false, true

Flux 2 Pro

flux-2-proDisponible vía APIParcial: requiere Files API

Imagen · Modelo insignia de Black Forest Labs con 32B parámetros. Admite texto a imagen e imagen a imagen con hasta 8 imágenes de referencia, resolución 2K y renderizado preciso de texto, creado para fotos de producto y visuales de marca.

Créditos base

5

Modos

text-to-image, image-to-image

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

5000 caracteres

Medios de referencia

image · 8 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

Imagen de referencia: Sube hasta 8 archivos de imagen para proyectos de imagen.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
aspectRatioselectNo1:1-1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
resolutionselectNo1K-1K, 2K

Flux 2 Flex

flux-2-flexDisponible vía APIParcial: requiere Files API

Imagen · Variante de la familia Flux 2 enfocada en edición. Se especializa en ajustes estructurales y transferencia de estilo con hasta 8 imágenes de referencia y resolución 2K, ideal para iterar sobre visuales existentes.

Créditos base

14

Modos

text-to-image, image-to-image

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

5000 caracteres

Medios de referencia

image · 8 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

Imagen de referencia: Sube hasta 8 archivos de imagen para proyectos de imagen.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
aspectRatioselectNo1:1-1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
resolutionselectNo1K-1K, 2K

Flux Kontext Max

flux-kontext-maxDisponible vía APIParcial: requiere Files API

Imagen · Modelo Flux Kontext mejorado de Black Forest Labs para generación guiada por indicaciones y tareas de edición de imagen más exigentes. Rivya actualmente mantiene texto a imagen e imagen a imagen dentro del mismo proyecto asíncrono y los cobra a un precio fijo de 8 créditos por ejecución según la política actual de la plataforma.

Créditos base

8

Modos

text-to-image, image-to-image

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

-

Medios de referencia

image · 1 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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 de marca de agua opcional"
  }
}

Regla de referencia

Imagen de referencia: Sube hasta 1 archivo de imagen para proyectos de edición de imagen.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
aspectRatioselectNo16:9-21:9, 16:9, 4:3, 1:1, 3:4, 9:16
outputFormatselectNojpeg-jpeg, png
enableTranslationselectNotrue-true, false
promptUpsamplingselectNofalse-false, true
safetyTolerancenumberNo2min 0 / max 6-
watermarktextNo---

Flux Kontext Pro

flux-kontext-proDisponible vía APIParcial: requiere Files API

Imagen · Proyecto Flux Kontext de menor costo de Black Forest Labs para texto a imagen y edición de una sola imagen. Rivya actualmente expone texto a imagen e imagen a imagen en el mismo proyecto asíncrono de imagen, con precio fijo de 4 créditos para ambos modos según la política actual de precios de la plataforma.

Créditos base

4

Modos

text-to-image, image-to-image

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

-

Medios de referencia

image · 1 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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 de marca de agua opcional"
  }
}

Regla de referencia

Imagen de referencia: Sube hasta 1 archivo de imagen para proyectos de edición de imagen.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
aspectRatioselectNo16:9-21:9, 16:9, 4:3, 1:1, 3:4, 9:16
outputFormatselectNojpeg-jpeg, png
enableTranslationselectNotrue-true, false
promptUpsamplingselectNofalse-false, true
safetyTolerancenumberNo2min 0 / max 6-
watermarktextNo---

Qwen2 Image

qwen2-imageDisponible vía APIParcial: requiere Files API

Imagen · El modelo de imagen Qwen2 de Alibaba está integrado actualmente en Rivya como un proyecto de imagen de precio fijo. Cubre con seguridad texto a imagen e imagen a imagen con el subconjunto compartido de relaciones de aspecto que exponen ambas documentaciones públicas, además de salida PNG/JPEG, reutilización de seed y un interruptor NSFW simple.

Créditos base

6

Modos

text-to-image, image-to-image

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

800 caracteres

Medios de referencia

image · 1 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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"
  }
}

Regla de referencia

Imagen de referencia: Sube hasta 1 archivo de imagen para proyectos de imagen.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
image_sizeselectNo16:9-1:1, 3:4, 4:3, 9:16, 16:9
output_formatselectNopng-png, jpeg
seednumberNo-min 0-
nsfw_checkerselectNofalse-false, true

Qwen Image

qwen-imageDisponible vía APIParcial: requiere Files API

Imagen · Modelo de imagen de la familia Alibaba Qwen con preajustes HD (Square, Portrait, Landscape) y salida PNG/JPEG. Fuerte en instrucciones en chino y generación visual con matices culturales.

Créditos base

4

Modos

text-to-image, image-to-image

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

5000 caracteres

Medios de referencia

image · 1 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

Imagen de referencia: Sube hasta 1 archivo de imagen para proyectos de imagen.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
image_sizeselectNosquare_hd-square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
output_formatselectNopng-png, jpeg

Midjourney

midjourneyDisponible vía APIParcial: requiere Files API

Imagen · Modelo de imagen V7 de Midjourney para texto a imagen e imagen a imagen, con modos anime Niji, 3 niveles de velocidad (Relaxed/Fast/Turbo), referencias de estilo y consistencia guiada por Omni Reference. Sigue siendo la referencia para arte cinematográfico, ilustraciones y tableros de ambiente.

Créditos base

3

Modos

text-to-image, image-to-image

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

2000 caracteres

Medios de referencia

image · 4 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

Imagen de referencia: Sube hasta 4 archivos de imagen para proyectos de imagen.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
speedselectNorelaxed-relaxed, fast, turbo
aspectRatioselectNo1:1-1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
versionselectNo7-7, 6.1, 6, niji7, niji6

Recraft Remove Background

recraft-remove-backgroundDisponible vía APIRequiere Files API

Imagen · Modelo de eliminación de fondo de Recraft en Rivya para aislar el sujeto de una imagen existente. Úsalo cuando el siguiente paso necesite un recurso transparente, un recorte limpio o una imagen fuente sin el fondo original.

Créditos base

1

Modos

image-to-image

Entrada de API

Requiere Files API

Entradas

file

Límite de prompt

-

Medios de referencia

image · 1 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

No se muestra un ejemplo ejecutable de Public API para este modelo.

Regla de referencia

Imagen fuente: Sube exactamente 1 imagen. Los bordes de sujeto más limpios suelen producir recortes más limpios.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos basados en archivos necesitan /api/v1/files antes de poder mostrarse como ejemplos API-ready completos. Files API

Parámetros

No se requiere ningún parámetro adicional del modelo.

Recraft Crisp Upscale

recraft-crisp-upscaleDisponible vía APIRequiere Files API

Imagen · Modelo ligero de ampliación de imagen de Recraft en Rivya para mejoras de nitidez y claridad de bajo costo en una imagen fija aprobada. Úsalo cuando la imagen elegida solo necesite una pasada barata de pulido antes de exportar, no una ampliación pesada de nivel entrega.

Créditos base

1

Modos

image-to-image

Entrada de API

Requiere Files API

Entradas

file

Límite de prompt

-

Medios de referencia

image · 1 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

No se muestra un ejemplo ejecutable de Public API para este modelo.

Regla de referencia

Imagen fuente: Sube exactamente 1 imagen. Esta opción está pensada para una pasada rápida de pulido de bajo costo.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos basados en archivos necesitan /api/v1/files antes de poder mostrarse como ejemplos API-ready completos. Files API

Parámetros

No se requiere ningún parámetro adicional del modelo.

Wan 2.7 Image Pro

wan-2-7-image-proDisponible vía APIParcial: requiere Files API

Imagen · El modelo de imagen Wan 2.7 de gama más alta de Alibaba, expuesto actualmente en Rivya como un slot de imagen separado para texto a imagen y edición de imagen. El precio se mantiene fijo en 12 créditos por ejecución al conservar explícitamente la generación en una sola imagen de salida.

Créditos base

12

Modos

text-to-image, image-to-image

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

5000 caracteres

Medios de referencia

image · 9 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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
  }
}

Regla de referencia

Imagen de referencia: Sube hasta 9 archivos de imagen para proyectos de edición de imagen.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
aspect_ratioselectNo1:1-1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8
resolutionselectNo2K-1K, 2K
watermarkselectNofalse-false, true
seednumberNo-min 0 / max 2147483647 / step 1-

Wan 2.7 Image

wan-2-7-imageDisponible vía APIParcial: requiere Files API

Imagen · El modelo estándar de imagen Wan 2.7 de Alibaba se expone en Rivya como su propio slot de imagen para texto a imagen y edición de imagen, y actualmente cuesta 5 créditos por ejecución.

Créditos base

5

Modos

text-to-image, image-to-image

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

5000 caracteres

Medios de referencia

image · 9 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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
  }
}

Regla de referencia

Imagen de referencia: Sube hasta 9 archivos de imagen para proyectos de edición de imagen.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
aspect_ratioselectNo1:1-1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8
resolutionselectNo2K-1K, 2K
watermarkselectNofalse-false, true
seednumberNo-min 0 / max 2147483647-

Google Imagen4 Ultra

google-imagen4-ultraDisponible vía APIEntrada de texto lista

Imagen · Google Imagen4 Ultra es el nivel premium de texto a imagen de Imagen en Rivya. Actualmente está integrado como un proyecto de una sola imagen con precio fijo de 12 créditos y controles públicos de prompt, prompt negativo, relación de aspecto y seed.

Créditos base

12

Modos

text-to-image

Entrada de API

Entrada de texto lista

Entradas

text

Límite de prompt

5000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "model": "google-imagen4-ultra",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "negative_prompt": "Elementos opcionales que quieres evitar",
    "seed": "Valor seed opcional"
  }
}

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
aspect_ratioselectNo1:1-1:1, 16:9, 9:16, 3:4, 4:3
negative_prompttextNo---
seedtextNo---

Google Imagen4

google-imagen4Disponible vía APIEntrada de texto lista

Imagen · Google Imagen4 es el nivel estándar de texto a imagen de Imagen en Rivya. Actualmente está integrado como un proyecto de una sola imagen con precio fijo de 8 créditos y controles públicos de prompt, prompt negativo, relación de aspecto y seed.

Créditos base

8

Modos

text-to-image

Entrada de API

Entrada de texto lista

Entradas

text

Límite de prompt

5000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "model": "google-imagen4",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "negative_prompt": "Elementos opcionales que quieres evitar",
    "seed": "Valor seed opcional"
  }
}

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
aspect_ratioselectNo1:1-1:1, 16:9, 9:16, 3:4, 4:3
negative_prompttextNo---
seedtextNo---

Google Imagen4 Fast

google-imagen4-fastDisponible vía APIEntrada de texto lista

Imagen · Google Imagen4 Fast es el nivel ligero de texto a imagen de Imagen en Rivya. Actualmente mantiene un proyecto de una sola imagen, usa precio fijo de 4 créditos y expone controles públicos de prompt, prompt negativo, relación de aspecto y seed sin abrir salida multiimagen.

Créditos base

4

Modos

text-to-image

Entrada de API

Entrada de texto lista

Entradas

text

Límite de prompt

5000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
aspect_ratioselectNo16:9-1:1, 16:9, 9:16, 3:4, 4:3
negative_prompttextNo---
seednumberNo-min 0-

Topaz Image Upscaler

topaz-image-upscaleDisponible vía APIRequiere Files API

Imagen · Topaz es el escalador de imagen de nivel de entrega en Rivya para imágenes fijas aprobadas que necesitan un salto real de tamaño. Úsalo cuando la composición ya esté cerrada y el problema restante sea la resolución de exportación, el tamaño para revisión o la preparación para impresión.

Créditos base

5

Modos

image-to-image

Entrada de API

Requiere Files API

Entradas

file

Límite de prompt

-

Medios de referencia

image · 1 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

No se muestra un ejemplo ejecutable de Public API para este modelo.

Regla de referencia

Imagen fuente: Sube 1 imagen aprobada que quieras conservar. Esta opción es para ampliación, no para reedición creativa.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos basados en archivos necesitan /api/v1/files antes de poder mostrarse como ejemplos API-ready completos. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
upscale_factorselectNo1-1, 2, 4, 8

Ideogram V3

ideogram-v3Disponible vía APIEntrada de texto lista

Imagen · Ideogram V3 es el modelo de texto a imagen de Rivya para renderizado de texto, layouts de póster y prompts de imagen orientados al diseño. El precio actual es de 4 créditos para TURBO, 7 para BALANCED y 10 para QUALITY.

Créditos base

7

Modos

text-to-image

Entrada de API

Entrada de texto lista

Entradas

text

Límite de prompt

5000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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": "Elementos opcionales que quieres evitar"
  }
}

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
rendering_speedselectNoBALANCED-TURBO, BALANCED, QUALITY
styleselectNoAUTO-AUTO, GENERAL, REALISTIC, DESIGN
expand_promptselectNotrue-true, false
image_sizeselectNosquare_hd-square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seednumberNo-min 0-
negative_prompttextNo---

Ideogram V3 Reframe

ideogram-v3-reframeDisponible vía APIRequiere Files API

Imagen · Ideogram V3 Reframe está integrado actualmente en Rivya como un proyecto de reencuadre de una sola imagen con precios por velocidad de renderizado. El precio actual es de 4 créditos para TURBO, 7 para BALANCED y 10 para QUALITY.

Créditos base

7

Modos

image-to-image

Entrada de API

Requiere Files API

Entradas

file

Límite de prompt

-

Medios de referencia

image · 1 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

No se muestra un ejemplo ejecutable de Public API para este modelo.

Regla de referencia

Imagen de referencia: Sube exactamente 1 archivo de imagen para este proyecto.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos basados en archivos necesitan /api/v1/files antes de poder mostrarse como ejemplos API-ready completos. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
rendering_speedselectNoBALANCED-TURBO, BALANCED, QUALITY
styleselectNoAUTO-AUTO, GENERAL, REALISTIC, DESIGN
image_sizeselectNosquare_hd-square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seednumberNo-min 0-

Ideogram V3 Remix

ideogram-v3-remixDisponible vía APIRequiere Files API

Imagen · Ideogram V3 Remix está integrado actualmente en Rivya como un proyecto de remix de una sola imagen con precios por velocidad de renderizado. El precio actual es de 4 créditos para TURBO, 7 para BALANCED y 10 para QUALITY.

Créditos base

7

Modos

image-to-image

Entrada de API

Requiere Files API

Entradas

file

Límite de prompt

5000 caracteres

Medios de referencia

image · 1 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

No se muestra un ejemplo ejecutable de Public API para este modelo.

Regla de referencia

Imagen de referencia: Sube exactamente 1 archivo de imagen para este proyecto.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos basados en archivos necesitan /api/v1/files antes de poder mostrarse como ejemplos API-ready completos. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
rendering_speedselectNoBALANCED-TURBO, BALANCED, QUALITY
styleselectNoAUTO-AUTO, GENERAL, REALISTIC, DESIGN
expand_promptselectNotrue-true, false
image_sizeselectNosquare_hd-square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seednumberNo-min 0-
strengthnumberNo0.8min 0.01 / max 1-
negative_prompttextNo---

Ideogram Character

ideogram-characterDisponible vía APIRequiere Files API

Imagen · Opción de consistencia de personaje para convertir una imagen de personaje aprobada en nuevas escenas, atuendos y formatos. Úsala cuando la retención de identidad importe más que la edición amplia de imágenes y solo necesites una imagen de salida por vez.

Créditos base

18

Modos

image-to-image

Entrada de API

Requiere Files API

Entradas

file

Límite de prompt

5000 caracteres

Medios de referencia

image · 1 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

No se muestra un ejemplo ejecutable de Public API para este modelo.

Regla de referencia

Imagen de referencia del personaje: Sube 1 imagen clara de referencia del personaje. Esta opción ignora imágenes extra y mantiene la salida en un solo resultado.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos basados en archivos necesitan /api/v1/files antes de poder mostrarse como ejemplos API-ready completos. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
rendering_speedselectNoBALANCED-TURBO, BALANCED, QUALITY
styleselectNoAUTO-AUTO, REALISTIC, FICTION
expand_promptselectNotrue-true, false
image_sizeselectNosquare_hd-square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seednumberNo-min 0-
negative_prompttextNo---

Seedance 2.0

seedance-2Disponible vía APIEntrada de texto lista

Vídeo · Modelo completo de vídeo Seedance 2.0 de ByteDance con soporte explícito para generación solo con prompt, animación guiada por fotogramas y generación con referencia multimodal. Rivya mantiene explícita la división documentada de roles para que las entradas de fotograma y las referencias multimodales se mantengan mutuamente excluyentes en lugar de caer en un único contenedor ambiguo de subida.

Créditos base

175

Modos

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

Entrada de API

Entrada de texto lista

Entradas

text

Límite de prompt

2500 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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"
  }
}

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
seedance_sceneselectNotext-text, frames, reference
resolutionselectNo720p-480p, 720p
aspect_ratioselectNo16:9-1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
durationnumberNo5min 4 / max 15-
generate_audioselectNotrue-true, false
return_last_frameselectNofalse-false, true
web_searchselectNofalse-false, true
nsfw_checkerselectNofalse-false, true

Seedance 2.0 Fast

seedance-2-fastDisponible vía APIEntrada de texto lista

Vídeo · Modelo de vídeo Seedance 2.0 más rápido de ByteDance, con enrutamiento completo de escenas para generación solo con prompt, animación de imagen guiada por fotogramas y generación de vídeo con referencia multimodal. Rivya mantiene explícita la división documentada de escenas para que las entradas de primer/último fotograma no se confundan con los roles de imagen, vídeo y audio de referencia.

Créditos base

140

Modos

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

Entrada de API

Entrada de texto lista

Entradas

text

Límite de prompt

2500 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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"
  }
}

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
seedance_sceneselectNotext-text, frames, reference
resolutionselectNo720p-480p, 720p
aspect_ratioselectNo16:9-1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
durationnumberNo5min 4 / max 15-
generate_audioselectNotrue-true, false
return_last_frameselectNofalse-false, true
web_searchselectNofalse-false, true
nsfw_checkerselectNofalse-false, true

Seedance 1.5 Pro

seedance-1-5-proDisponible vía APIParcial: requiere Files API

Vídeo · Modelo de vídeo insignia de ByteDance para texto a vídeo e imagen a vídeo con sincronización audiovisual nativa. Clips de 480p-1080p y 4-12s, 6 relaciones de aspecto, control de lente dinámica/fija, generación de audio opcional y compatibilidad con lip sync.

Créditos base

28

Modos

text-to-video, image-to-video

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

2500 caracteres

Medios de referencia

image · 2 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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"
  }
}

Regla de referencia

Imagen de referencia: Sube hasta 2 archivos de imagen para proyectos de imagen.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
resolutionselectNo720p-480p, 720p, 1080p
durationselectNo8-4, 8, 12
generate_audioselectNofalse-false, true
aspectRatioselectNo1:1-1:1, 4:3, 3:4, 16:9, 9:16, 21:9
fixed_lensselectNofalse-false, true

Seedance 1.0 Pro

seedance-1-0-proDisponible vía APIParcial: requiere Files API

Vídeo · El modelo Seedance 1.0 Pro de ByteDance se expone en Rivya como la opción estándar 1.0 Pro tanto para texto a vídeo como para imagen a vídeo. Mantiene la configuración actual de la página alineada con la documentación pública V1 Pro mediante controles de resolución, duración, bloqueo de cámara, seed y comprobación de seguridad.

Créditos base

25

Modos

text-to-video, image-to-video

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

10000 caracteres

Medios de referencia

image · 1 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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"
  }
}

Regla de referencia

Imagen de referencia: Sube 1 archivo de imagen para ejecuciones de imagen a vídeo.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
resolutionselectNo720p-480p, 720p, 1080p
durationselectNo5-5, 10
aspect_ratioselectNo16:9-21:9, 16:9, 4:3, 1:1, 3:4, 9:16
camera_fixedselectNofalse-false, true
seednumberNo-1min -1 / max 2147483647-
enable_safety_checkerselectNotrue-true, false

Seedance 1.0 Pro Fast

seedance-1-0-pro-fastDisponible vía APIRequiere Files API

Vídeo · Modelo rápido de imagen a vídeo de ByteDance. Anima una sola imagen de referencia en clips de 5s o 10s a 720p/1080p, optimizado para velocidad cuando necesitas vídeo rápido a partir de una imagen fija.

Créditos base

16

Modos

image-to-video

Entrada de API

Requiere Files API

Entradas

file

Límite de prompt

10000 caracteres

Medios de referencia

image · 1 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

No se muestra un ejemplo ejecutable de Public API para este modelo.

Regla de referencia

Imagen de referencia: Sube 1 imagen de origen para animarla como vídeo.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos basados en archivos necesitan /api/v1/files antes de poder mostrarse como ejemplos API-ready completos. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
resolutionselectNo720p-720p, 1080p
durationselectNo5-5, 10

Seedance 1.0 Lite

seedance-1-0-liteDisponible vía APIParcial: requiere Files API

Vídeo · El modelo Seedance 1.0 Lite de ByteDance se expone en Rivya como la opción 1.0 más ligera tanto para texto a vídeo como para imagen a vídeo. Sigue el conjunto público de parámetros V1 Lite y actualmente usa una escala de precios más baja que Seedance 1.0 Pro.

Créditos base

16

Modos

text-to-video, image-to-video

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

10000 caracteres

Medios de referencia

image · 2 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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"
  }
}

Regla de referencia

Imagen de referencia: Sube 1 imagen de origen para imagen a vídeo, o 2 imágenes cuando también quieras proporcionar un fotograma final opcional.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
resolutionselectNo720p-480p, 720p, 1080p
durationselectNo5-5, 10
aspect_ratioselectNo16:9-16:9, 4:3, 1:1, 3:4, 9:16, 9:21
camera_fixedselectNofalse-false, true
seednumberNo-1min -1 / max 2147483647-
enable_safety_checkerselectNotrue-true, false

HappyHorse 1.0

happyhorse-1-0Disponible vía APIParcial: requiere Files API

Video · Un modelo de video IA flexible en Rivya para texto a video, movimiento desde una sola imagen, video con múltiples referencias de imagen y edición de video desde una sola página pública de modelo.

Créditos base

28

Modos

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

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

5000 caracteres

Medios de referencia

image, video · 10 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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
  }
}

Regla de referencia

Medios de referencia: Usa hasta 9 imágenes sin video, o 1 video con hasta 5 referencias de imagen para edición de video.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
resolutionselectNo1080p-720p, 1080p
aspect_ratioselectNo16:9-16:9, 9:16, 1:1, 4:3, 3:4
durationnumberNo5min 3 / max 15-
audio_settingselectNoauto-auto, origin
seednumberNo0min 0 / max 2147483647-

Wan 2.7 Video

wan-2-7-videoDisponible vía APIParcial: requiere Files API

Vídeo · La línea de vídeo Wan más nueva de Alibaba con precio por resolución y duración. Rivya expone texto a vídeo, imagen a vídeo y edición de vídeo en un solo slot, desde 80 créditos por generación.

Créditos base

80

Modos

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

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

5000 caracteres

Medios de referencia

image, video · 2 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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": "Exclusiones opcionales o modos de fallo que evitar.",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0
  }
}

Regla de referencia

Medios de referencia: Sube hasta 2 recursos. Usa hasta 2 imágenes para imagen a vídeo, o 1 vídeo más 1 imagen opcional para edición de vídeo.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
resolutionselectNo720p-720p, 1080p
durationselectNo5-5, 10, 15
aspect_ratioselectNo16:9-16:9, 9:16, 1:1, 4:3, 3:4
negative_prompttextNo---
prompt_extendselectNotrue-true, false
watermarkselectNofalse-false, true
audio_settingselectNoauto-auto, origin
seednumberNo-min 0 / max 2147483647-

Wan 2.6

wan-2-6Disponible vía APIParcial: requiere Files API

Vídeo · La opción Wan de triple modo de Alibaba en Rivya: texto a vídeo, imagen a vídeo y edición desde vídeo fuente en un solo proyecto. Admite 720p/1080p, clips de 5 a 15 segundos y una imagen o un vídeo fuente a la vez.

Créditos base

70

Modos

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

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

5000 caracteres

Medios de referencia

image, video · 1 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

Medios de referencia: Sube hasta 1 archivo de imagen / vídeo para proyectos de imagen / vídeo.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
resolutionselectNo720p-720p, 1080p
durationselectNo5-5, 10, 15

Wan 2.5 Video

wan-2-5-videoDisponible vía APIParcial: requiere Files API

Vídeo · Wan 2.5 ahora se expone en Rivya como una entrada compartida para texto a vídeo e imagen a vídeo. El precio actual es `720p_5 = 60`, `720p_10 = 120`, `1080p_5 = 100` y `1080p_10 = 200` créditos.

Créditos base

60

Modos

text-to-video, image-to-video

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

5000 caracteres

Medios de referencia

image · 1 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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": "Exclusiones opcionales o modos de fallo que evitar.",
    "nsfw_checker": "false"
  }
}

Regla de referencia

Imagen de referencia: Sube hasta 1 archivo de imagen para el modo imagen a vídeo.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
resolutionselectNo720p-720p, 1080p
durationselectNo5-5, 10
aspect_ratioselectNo16:9-16:9, 9:16, 1:1
enable_prompt_expansionselectNofalse-false, true
seednumberNo-min 0 / max 2147483647-
negative_prompttextNo---
nsfw_checkerselectNofalse-false, true

Wan 2.2 A14B Turbo

wan-2-2-a14b-turboDisponible vía APIParcial: requiere Files API

Vídeo · Wan 2.2 A14B Turbo ahora cubre texto a vídeo, imagen a vídeo y una ruta de vídeo guiada por imagen y audio en Rivya. El precio actual es `480p = 8` y `720p = 12` para ejecuciones de texto o imagen, más `480p = 16`, `580p = 20` y `720p = 24` cuando una imagen y un clip de audio guían el resultado.

Créditos base

12

Modos

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

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

5000 caracteres

Medios de referencia

image, audio · 2 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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": "Exclusiones opcionales o modos de fallo que evitar.",
    "num_inference_steps": 27,
    "guidance_scale": 3.5,
    "shift": 5,
    "enable_safety_checker": "true"
  }
}

Regla de referencia

Medios de referencia: Sube hasta 2 recursos. El modo texto no necesita ninguno, imagen a vídeo usa 1 imagen y la ruta guiada por imagen más audio usa 1 imagen más 1 clip de audio.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
resolutionselectNo720p-480p, 580p, 720p
aspect_ratioselectNo16:9-16:9, 9:16
enable_prompt_expansionselectNofalse-false, true
seednumberNo-min 0 / max 2147483647-
accelerationselectNonone-none, regular
num_framesnumberNo80min 40 / max 120 / step 1-
frames_per_secondnumberNo16min 4 / max 60 / step 1-
negative_prompttextNo---
num_inference_stepsnumberNo27min 2 / max 40 / step 1-
guidance_scalenumberNo3.5min 1 / max 10 / step 0.1-
shiftnumberNo5min 1 / max 10 / step 0.1-
enable_safety_checkerselectNotrue-true, false

Wan Animate Replace

wan-2-2-animate-replaceDisponible vía APIEntrada de URL lista

Vídeo · El modelo de vídeo de reemplazo de personajes de Wan en Rivya para cambiar quién aparece en un clip existente. Usa una URL pública de vídeo fuente, una URL pública de imagen de reemplazo y un nivel de resolución cuando el movimiento ya es correcto y debe cambiar el sujeto visible.

Créditos base

20

Modos

video-to-video

Entrada de API

Entrada de URL lista

Entradas

url

Límite de prompt

-

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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"
  }
}

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Este modelo acepta entrada de URL pública mediante parámetros del modelo.

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
video_urltextNo---
image_urltextNo---
resolutionselectNo480p-480p, 580p, 720p

Hailuo 2.3

hailuo-2-3Disponible vía APIRequiere Files API

Video · Modelo de imagen a video de MiniMax con niveles de calidad Standard/Pro, resolución 768P/1080P y clips de 6s o 10s. Conocido por movimiento más fluido y transiciones naturales desde imágenes estáticas.

Créditos base

25

Modos

image-to-video

Entrada de API

Requiere Files API

Entradas

file

Límite de prompt

5000 caracteres

Medios de referencia

image · 1 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

No se muestra un ejemplo ejecutable de Public API para este modelo.

Regla de referencia

Imagen de referencia: Sube hasta 1 archivo de imagen para proyectos de imagen.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos basados en archivos necesitan /api/v1/files antes de poder mostrarse como ejemplos API-ready completos. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
qualityselectNostandard-standard, pro
resolutionselectNo768P-768P, 1080P
durationselectNo6-6, 10

Hailuo Pro

hailuo-proDisponible vía APIParcial: requiere Files API

Video · El modelo de video Hailuo Pro anterior de MiniMax está conectado aquí como un modelo fijo de nivel Pro tanto para texto a video como para imagen a video. El modo imagen acepta 1 o 2 imágenes de referencia, con la segunda imagen usada como último frame, y cada ejecución cuesta actualmente 57 créditos.

Créditos base

57

Modos

text-to-video, image-to-video

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

1500 caracteres

Medios de referencia

image · 2 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

Imágenes de referencia: El modo imagen acepta hasta 2 imágenes, y la segunda imagen se convierte en el último frame.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
prompt_optimizerselectNofalse-false, true

Hailuo Standard

hailuo-standardDisponible vía APIParcial: requiere Files API

Video · Modelo de video Hailuo Standard anterior de MiniMax, unificado aquí como un modelo para texto a video e imagen a video. El modo imagen acepta 1 o 2 imágenes de referencia, con la segunda imagen usada como último frame, y los niveles de precio públicos verificados actualmente van de 12 a 50 créditos.

Créditos base

30

Modos

text-to-video, image-to-video

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

1500 caracteres

Medios de referencia

image · 2 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

Imágenes de referencia: El modo imagen acepta hasta 2 imágenes, y la segunda imagen se convierte en el último frame.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
durationselectNo6-6, 10
resolutionselectNo512P-512P, 768P
prompt_optimizerselectNofalse-false, true

Kling 3.0

kling-3-0Disponible vía APIParcial: requiere Files API

Video · Modelo de video premium de Kuaishou para texto a video e imagen a video, con niveles Standard (720P) / Pro (1080P), estructura de toma única o de varias tomas, duración de 3–15s, generación de audio opcional y hasta 2 imágenes de referencia.

Créditos base

90

Modos

text-to-video, image-to-video

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

2000 caracteres

Medios de referencia

image · 2 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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"
  }
}

Regla de referencia

Medios de referencia: Sube hasta 2 archivos de imagen en total para proyectos de imagen a video.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
modeselectNopro-std, pro
multi_shotsselectNofalse-false, true
durationselectNo5-3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
soundselectNofalse-false, true
aspect_ratioselectNo16:9-16:9, 9:16, 1:1

Kling 3.0 motion-control

kling-3-0-motion-controlDisponible vía APIRequiere Files API

Video · Opción Kling motion-control más nueva para animar un sujeto desde una imagen de referencia y un video de movimiento, con elección explícita de fuente de fondo. Úsala cuando quieras transferencia de movimiento y más control sobre si la escena debe venir del video o de la imagen.

Créditos base

27

Modos

video-to-video

Entrada de API

Requiere Files API

Entradas

file

Límite de prompt

2500 caracteres

Medios de referencia

image, video · 2 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

No se muestra un ejemplo ejecutable de Public API para este modelo.

Regla de referencia

Imagen de referencia + video de movimiento: Sube exactamente 1 imagen de personaje y 1 clip de movimiento. Usa 3.0 cuando necesites tanto control de orientación como elección de fuente de fondo.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos basados en archivos necesitan /api/v1/files antes de poder mostrarse como ejemplos API-ready completos. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
modeselectNopro-std, pro
character_orientationselectNovideo-video, image
background_sourceselectNoinput_video-input_video, input_image

Kling 2.6

kling-2-6Disponible vía APIParcial: requiere Files API

Video · Modelo de video de Kuaishou con generación de audio opcional, clips de 5s/10s y 3 relaciones de aspecto. Destaca en movimiento humano y animación expresiva de personajes con física natural.

Créditos base

55

Modos

text-to-video, image-to-video

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

1000 caracteres

Medios de referencia

image · 1 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

Imagen de referencia: Sube hasta 1 archivo de imagen para proyectos de imagen.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
durationselectNo5-5, 10
soundselectNofalse-false, true
aspect_ratioselectNo1:1-1:1, 16:9, 9:16

Kling 2.6 motion-control

kling-2-6-motion-controlDisponible vía APIRequiere Files API

Video · Proyecto dedicado de transferencia de movimiento para animar un sujeto desde una imagen de referencia y un video de movimiento. Úsalo cuando quieras una pasada de Kling motion-control más barata y puedas prescindir de los controles de escena adicionales de Kling 3.0 motion-control.

Créditos base

16

Modos

video-to-video

Entrada de API

Requiere Files API

Entradas

file

Límite de prompt

2500 caracteres

Medios de referencia

image, video · 2 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

No se muestra un ejemplo ejecutable de Public API para este modelo.

Regla de referencia

Imagen de referencia + video de movimiento: Sube exactamente 1 imagen de personaje y 1 clip de movimiento. Ambos deben mostrar con claridad la cabeza, los hombros y el torso.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos basados en archivos necesitan /api/v1/files antes de poder mostrarse como ejemplos API-ready completos. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
modeselectNo720p-720p, 1080p
character_orientationselectNovideo-video, image

Kling V2.5 Turbo Pro

kling-v2-5-turbo-proDisponible vía APIParcial: requiere Files API

Video · Modelo de video Kling V2.5 Turbo Pro de Kuaishou, ahora con soporte para texto a video e imagen a video. La evidencia pública de precios cubre claramente los niveles de texto e imagen a 5 segundos y 10 segundos, así que Rivya lo asigna directamente a 42 / 84 créditos.

Créditos base

42

Modos

text-to-video, image-to-video

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

2500 caracteres

Medios de referencia

image · 2 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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": "Describe lo que el video debe evitar",
    "cfg_scale": 0.5
  }
}

Regla de referencia

Imágenes de referencia: Opcionalmente sube hasta 2 imágenes para cambiar al modo imagen a video; la segunda imagen se asigna al fotograma final.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
durationselectNo5-5, 10
aspect_ratioselectNo16:9-16:9, 9:16, 1:1
negative_prompttextNo---
cfg_scalenumberNo0.5min 0 / max 1-

Kling V2.1 Master

kling-v2-1-masterDisponible vía APIParcial: requiere Files API

Video · El modelo de video Kling V2.1 Master heredado de Kuaishou ahora admite tanto texto a video como imagen a video en Rivya. El precio actual es de 160 créditos por 5 segundos y 320 créditos por 10 segundos.

Créditos base

160

Modos

text-to-video, image-to-video

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

5000 caracteres

Medios de referencia

image · 1 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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": "Describe lo que el video debe evitar",
    "cfg_scale": 0.5
  }
}

Regla de referencia

Imagen de referencia: Opcionalmente sube una imagen para cambiar al modo imagen a video; déjalo vacío para seguir en modo texto.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
durationselectNo5-5, 10
aspect_ratioselectNo16:9-16:9, 9:16, 1:1
negative_prompttextNo---
cfg_scalenumberNo0.5min 0 / max 1-

Kling V2.1 Pro

kling-v2-1-proDisponible vía APIRequiere Files API

Video · El modelo imagen a video Kling V2.1 Pro heredado de Kuaishou admite un primer fotograma más una imagen opcional de fotograma final. El precio actual es de 50 créditos por 5 segundos y 100 créditos por 10 segundos.

Créditos base

50

Modos

image-to-video

Entrada de API

Requiere Files API

Entradas

file

Límite de prompt

5000 caracteres

Medios de referencia

image · 2 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

No se muestra un ejemplo ejecutable de Public API para este modelo.

Regla de referencia

Imágenes de referencia: El modo imagen acepta hasta 2 archivos de imagen, y la segunda imagen se asigna al fotograma final.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos basados en archivos necesitan /api/v1/files antes de poder mostrarse como ejemplos API-ready completos. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
durationselectNo5-5, 10
negative_prompttextNo---
cfg_scalenumberNo0.5min 0 / max 1-

Kling V2.1 Standard

kling-v2-1-standardDisponible vía APIRequiere Files API

Video · Modelo imagen a video Kling V2.1 Standard heredado de Kuaishou. El precio actual es de 25 créditos por 5 segundos y 50 créditos por 10 segundos.

Créditos base

25

Modos

image-to-video

Entrada de API

Requiere Files API

Entradas

file

Límite de prompt

5000 caracteres

Medios de referencia

image · 1 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

No se muestra un ejemplo ejecutable de Public API para este modelo.

Regla de referencia

Imagen de referencia: El modo imagen acepta hasta 1 archivo de imagen como primer fotograma.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos basados en archivos necesitan /api/v1/files antes de poder mostrarse como ejemplos API-ready completos. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
durationselectNo5-5, 10
negative_prompttextNo---
cfg_scalenumberNo0.5min 0 / max 1-

Kling AI Avatar Pro

kling-ai-avatar-proDisponible vía APIRequiere Files API

Video · Modelo Kling AI Avatar Pro de Kuaishou para avatares hablantes de mayor calidad, que usa una imagen de retrato y un clip de audio para generar video de avatar con sincronización labial. Rivya actualmente lo cobra a un precio fijo de 16 créditos por generación.

Créditos base

16

Modos

image-to-video

Entrada de API

Requiere Files API

Entradas

file

Límite de prompt

5000 caracteres

Medios de referencia

image, audio · 2 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

No se muestra un ejemplo ejecutable de Public API para este modelo.

Regla de referencia

Imagen de retrato y audio: Sube una imagen de retrato y un clip de audio juntos.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos basados en archivos necesitan /api/v1/files antes de poder mostrarse como ejemplos API-ready completos. Files API

Parámetros

No se requiere ningún parámetro adicional del modelo.

Kling AI Avatar Standard

kling-ai-avatar-standardDisponible vía APIRequiere Files API

Video · Modelo Kling AI Avatar Standard de Kuaishou para avatares hablantes, que usa una imagen de retrato y un clip de audio para generar video de avatar con sincronización labial. Rivya actualmente lo cobra a un precio fijo de 8 créditos por generación.

Créditos base

8

Modos

image-to-video

Entrada de API

Requiere Files API

Entradas

file

Límite de prompt

5000 caracteres

Medios de referencia

image, audio · 2 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

No se muestra un ejemplo ejecutable de Public API para este modelo.

Regla de referencia

Imagen de retrato y audio: Sube una imagen de retrato y un clip de audio juntos.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos basados en archivos necesitan /api/v1/files antes de poder mostrarse como ejemplos API-ready completos. Files API

Parámetros

No se requiere ningún parámetro adicional del modelo.

Infinitalk

infinitalkDisponible vía APIRequiere Files API

Video · Infinitalk es un modelo de video hablado con retrato más audio. El precio actual se mide por resolución y duración del audio: 480p = 3 créditos por segundo y 720p = 12 créditos por segundo.

Créditos base

3

Modos

image-to-video

Entrada de API

Requiere Files API

Entradas

file

Límite de prompt

5000 caracteres

Medios de referencia

image, audio · 2 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

No se muestra un ejemplo ejecutable de Public API para este modelo.

Regla de referencia

Imagen de retrato y audio: Sube una imagen de retrato y un clip de audio juntos.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos basados en archivos necesitan /api/v1/files antes de poder mostrarse como ejemplos API-ready completos. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
resolutionselectNo480p-480p, 720p
seednumberNo-min 10000 / max 1000000-

Runway

runwayDisponible vía APIParcial: requiere Files API

Vídeo · Runway es un modelo de vídeo independiente que admite tanto texto a vídeo como imagen a vídeo. La evidencia pública de precios confirma actualmente solo 6 niveles de generación, por lo que Rivya lo mantiene en el conjunto verificado: `720p_5 = 12`, `720p_10 = 30` y `1080p_5 = 30`.

Créditos base

12

Modos

text-to-video, image-to-video

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

1800 caracteres

Medios de referencia

image · 1 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "model": "runway",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "quality": "720p",
    "aspectRatio": "16:9",
    "waterMark": "Déjalo vacío para desactivar la marca de agua"
  }
}

Regla de referencia

Imagen de referencia: Opcionalmente sube una imagen para cambiar al modo imagen a vídeo; déjalo vacío para seguir en modo texto.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
durationselectNo5-5, 10
qualityselectNo720p-720p, 1080p
aspectRatioselectNo16:9-16:9, 4:3, 1:1, 3:4, 9:16
waterMarktextNo---

Runway Aleph

runway-alephDisponible vía APIRequiere Files API

Video · Proyecto de transformación de video fuente para reelaborar un clip existente en un nuevo resultado visual. Usa Aleph cuando el movimiento venga de tu metraje de entrada y la dirección creativa venga de tu instrucción, con un precio fijo de 90 créditos.

Créditos base

90

Modos

video-to-video

Entrada de API

Requiere Files API

Entradas

file

Límite de prompt

5000 caracteres

Medios de referencia

video, image · 2 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

No se muestra un ejemplo ejecutable de Public API para este modelo.

Regla de referencia

Medios de entrada: Sube el clip fuente que quieres que Aleph transforme. Añade una imagen fija opcional solo cuando necesites guía extra de estilo o sujeto.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos basados en archivos necesitan /api/v1/files antes de poder mostrarse como ejemplos API-ready completos. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
aspectRatioselectNo16:9-16:9, 9:16, 4:3, 3:4, 1:1, 21:9
waterMarktextNo---
seednumberNo-min 0 / max 2147483647-

Luma Modify Video

luma-modify-videoDisponible vía APIRequiere Files API

Video · Proyecto independiente de reescritura de video fuente para llevar un clip existente hacia una nueva dirección visual. Úsalo cuando la instrucción deba transformar el metraje en sí, no solo limpiar la exportación.

Créditos base

30

Modos

video-to-video

Entrada de API

Requiere Files API

Entradas

file

Límite de prompt

-

Medios de referencia

video · 1 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

No se muestra un ejemplo ejecutable de Public API para este modelo.

Regla de referencia

Video de entrada: Sube un clip fuente corto que quieras transformar. Esta opción reescribe el metraje en lugar de simplemente mejorarlo.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos basados en archivos necesitan /api/v1/files antes de poder mostrarse como ejemplos API-ready completos. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
watermarktextNo---

Grok Imagine Video

grok-imagine-videoDisponible vía APIParcial: requiere Files API

Video · Modelo de video de xAI con modos creativos Fun/Normal/Spicy y 5 relaciones de aspecto. Presets de estilo únicos para distintos tonos creativos, desde juguetón hasta cinematográfico y atrevido.

Créditos base

10

Modos

text-to-video, image-to-video

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

5000 caracteres

Medios de referencia

image · 1 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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"
  }
}

Regla de referencia

Imagen de referencia: Sube hasta 1 archivo de imagen para proyectos de imagen.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
modeselectNonormal-fun, normal, spicy
durationnumberNo6min 6 / max 30 / step 1-
resolutionselectNo480p-480p, 720p
aspect_ratioselectNo2:3-1:1, 16:9, 9:16, 2:3, 3:2

Sora 2 Pro

sora-2-proDisponible vía APIParcial: requiere Files API

Vídeo · Nivel premium de Sora 2 con modos de calidad Standard/High, clips de 10s/15s y eliminación de marca de agua. Más detalle, iluminación y fidelidad de movimiento para producción de vídeo profesional.

Créditos base

75

Modos

text-to-video, image-to-video

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

10000 caracteres

Medios de referencia

image · 1 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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"
  }
}

Regla de referencia

Imagen de referencia: Sube hasta 1 archivo de imagen para proyectos de imagen.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
sizeselectNo--standard, high
n_framesselectNo10-10, 15
aspect_ratioselectNolandscape-landscape, portrait
remove_watermarkselectNofalse-false, true
upload_methodselectNos3-s3, oss

Sora 2

sora-2Disponible vía APIParcial: requiere Files API

Vídeo · Modelo de vídeo de OpenAI para texto a vídeo e imagen a vídeo con simulación realista del mundo, audio sincronizado, clips de 10s/15s, salidas horizontal/vertical y eliminación opcional de marca de agua.

Créditos base

6

Modos

text-to-video, image-to-video

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

10000 caracteres

Medios de referencia

image · 1 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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"
  }
}

Regla de referencia

Imagen de referencia: Sube hasta 1 archivo de imagen para proyectos de imagen.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
n_framesselectNo10-10, 15
aspect_ratioselectNolandscape-landscape, portrait
remove_watermarkselectNofalse-false, true
upload_methodselectNos3-s3, oss

Sora Watermark Remover

sora-watermark-removerDisponible vía APIEntrada de URL lista

Vídeo · Modelo de posprocesamiento de Sora para eliminar marcas de agua en Rivya, pensado para enlaces públicos de Sora ya terminados. Úsalo después de que el vídeo ya esté aprobado, cuando la tarea restante sea eliminar la marca de agua y elegir entrega por S3 u OSS.

Créditos base

3

Modos

video-to-video

Entrada de API

Entrada de URL lista

Entradas

url

Límite de prompt

-

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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"
  }
}

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Este modelo acepta entrada de URL pública mediante parámetros del modelo.

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
video_urltext---
upload_methodselects3-s3, oss

Topaz Video Upscaler

topaz-video-upscaleDisponible vía APIRequiere Files API

Vídeo · Topaz es el escalador de vídeo de nivel de entrega en Rivya para clips aprobados que solo necesitan más claridad al exportar. Úsalo cuando la toma, el movimiento y el ritmo ya sean correctos y el problema restante sea la resolución o la nitidez del archivo final.

Créditos base

12

Modos

video-to-video

Entrada de API

Requiere Files API

Entradas

file

Límite de prompt

-

Medios de referencia

video · 1 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

No se muestra un ejemplo ejecutable de Public API para este modelo.

Regla de referencia

Vídeo fuente: Sube 1 clip fuente que quieras conservar. Esta opción mejora la claridad de entrega en lugar de cambiar la toma.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos basados en archivos necesitan /api/v1/files antes de poder mostrarse como ejemplos API-ready completos. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
upscale_factorselectNo2-1, 2, 4

Veo3.1 Quality

veo3-1-qualityDisponible vía APIParcial: requiere Files API

Vídeo · La variante de Google Veo 3.1 orientada primero a calidad para generación premium de texto a vídeo y guiada por imagen. Visuales de mayor fidelidad, realismo de movimiento más sólido y audio de fondo por defecto la convierten en la opción Veo de gama más alta de Rivya.

Créditos base

150

Modos

text-to-video, image-to-video

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

5000 caracteres

Medios de referencia

image · 2 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

Imagen de referencia: Sube hasta 2 archivos de imagen para el proyecto guiado por imagen compatible.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
aspectRatioselectNo16:9-16:9, 9:16, Auto
watermarktextNo---
seedsnumberNo-min 10000 / max 99999 / step 1-
enableTranslationselectNotrue-true, false

Veo3.1 Fast

veo3-1-fastDisponible vía APIParcial: requiere Files API

Vídeo · La variante rápida de Google Veo 3.1 con soporte de triple modo: texto a vídeo, imagen a vídeo y referencia a vídeo. Hasta 3 imágenes de referencia, audio nativo y controles de relación de aspecto según el modo la hacen útil para clips cinematográficos rápidos.

Créditos base

20

Modos

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

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

5000 caracteres

Medios de referencia

image · 3 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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 de marca de agua opcional",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

Regla de referencia

Imagen de referencia: Sube hasta 3 archivos de imagen para proyectos guiados por imagen y referencia.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
generationTypeselectNoFIRST_AND_LAST_FRAMES_2_VIDEO-FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEO
aspectRatioselectNo16:9-16:9, 9:16, Auto
watermarktextNo---
seedsnumberNo-min 10000 / max 99999 / step 1-
enableTranslationselectNotrue-true, false

Veo3.1 Lite

veo3-1-liteDisponible vía APIParcial: requiere Files API

Vídeo · La variante de menor coste de Google Veo 3.1. Rivya actualmente expone solo el subconjunto estable más pequeño: texto a vídeo e imagen a vídeo con un precio fijo de `10` créditos por generación.

Créditos base

10

Modos

text-to-video, image-to-video

Entrada de API

Parcial: requiere Files API

Entradas

text, file

Límite de prompt

5000 caracteres

Medios de referencia

image · 2 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

Imagen de referencia: Sube hasta 2 archivos de imagen para el proyecto guiado por imagen compatible.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos de prompt o URL pueden estar disponibles ahora. Los modos con medios de referencia todavía necesitan soporte de subida con Files API. Files API

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
aspectRatioselectNo16:9-16:9, 9:16, Auto
watermarktextNo---
seedsnumberNo-min 10000 / max 99999 / step 1-
enableTranslationselectNotrue-true, false

Suno Music

suno-musicDisponible vía APIEntrada de texto lista

Audio · Suno Music es el modelo de texto a música de Rivya para convertir un brief corto en un primer borrador de canción, con o sin voces. Mantiene el punto de entrada fijo de `12` créditos y expone `Extend Music` como siguiente paso después de una pista correcta.

Créditos base

12

Modos

text-to-audio

Entrada de API

Entrada de texto lista

Entradas

text

Límite de prompt

500 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
modelselectNoV4_5-V4, V4_5, V4_5PLUS, V4_5ALL, V5, V5_5
instrumentalselectNofalse-false, true

Suno Sounds

suno-soundsDisponible vía APIEntrada de texto lista

Audio · Suno Sounds es el modelo ligero de texto a sonido de Rivya para bucles de ambiente, sonido de fondo y bocetos sonoros cortos. Mantiene el precio fijo documentado de `3` créditos por generación y permite que los resultados correctos continúen hacia `Vocal Separation`.

Créditos base

3

Modos

text-to-audio

Entrada de API

Entrada de texto lista

Entradas

text

Límite de prompt

500 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
modelselectNoV5-V5, V5_5
soundLoopselectNofalse-false, true
soundTemponumberNo-min 1 / max 300 / step 1-
soundKeyselectNoAny-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-lyricsDisponible vía APIEntrada de texto lista

Audio · Suno Lyrics es el modelo de generación de letras de Rivya para convertir un tema o estado de ánimo en palabras de canción con un coste fijo de `1` crédito por solicitud.

Créditos base

1

Modos

text-to-audio

Entrada de API

Entrada de texto lista

Entradas

text

Límite de prompt

200 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parámetros

No se requiere ningún parámetro adicional del modelo.

ElevenLabs Dialogue V3

elevenlabs-dialogue-v3Disponible vía APIEntrada de texto lista

Audio · Modelo de diálogo con varios hablantes de ElevenLabs en Rivya. Está creado para generación de voz basada en roles, con asignación individual de voces, controles de estabilidad y ritmo preparado para diálogos en podcasts, entrevistas y escenas con personajes.

Créditos base

14

Modos

dialogue-to-audio

Entrada de API

Entrada de texto lista

Entradas

text

Límite de prompt

5000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
default_voiceselectNoAdam-Adam, Alice, Bill, Brian, Callum, Charlie, Chris, Daniel, Eric, George, Harry, Jessica, Laura, Liam, Lily, Matilda, River, Roger, Sarah, Will
stabilityselectNo0.5-0, 0.5, 1
language_codetextNo---

ElevenLabs Turbo 2.5

elevenlabs-turbo-2-5Disponible vía APIEntrada de texto lista

Audio · Modelo rápido de texto a voz de ElevenLabs en Rivya. Con generación de voz de baja latencia y estabilidad, similitud, estilo y velocidad ajustables, está creado para borradores rápidos de locución y proyectos TTS interactivos.

Créditos base

6

Modos

text-to-speech

Entrada de API

Entrada de texto lista

Entradas

text

Límite de prompt

5000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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 de esta línea",
    "next_text": "Contexto opcional después de esta línea",
    "language_code": "Código de idioma opcional como en o zh"
  }
}

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
voiceselectTX3LPaxmHKxFdv7VOQHJ-TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8
stabilitynumberNo0.5min 0 / max 1 / step 0.05-
similarity_boostnumberNo0.75min 0 / max 1 / step 0.05-
stylenumberNo0min 0 / max 1 / step 0.05-
speednumberNo1min 0.7 / max 1.2 / step 0.05-
timestampsselectNofalse-false, true
previous_texttextNo---
next_texttextNo---
language_codetextNo---

ElevenLabs Multilingual V2

elevenlabs-multilingual-v2Disponible vía APIEntrada de texto lista

Audio · Modelo de texto a voz multilingüe de ElevenLabs en Rivya, con soporte para unas 30 lenguas y detección automática. Es la opción más sólida para localización, entrega entre idiomas y locuciones multilingües más naturales.

Créditos base

12

Modos

text-to-speech

Entrada de API

Entrada de texto lista

Entradas

text

Límite de prompt

5000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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"
  }
}

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
voiceselectTX3LPaxmHKxFdv7VOQHJ-TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8
stabilitynumberNo0.5min 0 / max 1 / step 0.05-
similarity_boostnumberNo0.75min 0 / max 1 / step 0.05-
stylenumberNo0min 0 / max 1 / step 0.05-
speednumberNo1min 0.7 / max 1.2 / step 0.05-
timestampsselectNofalse-false, true
previous_texttextNo---
next_texttextNo---
language_codetextNo---

ElevenLabs Sound Effect V2

elevenlabs-sound-effect-v2Disponible vía APIEntrada de texto lista

Audio · Modelo de texto a sonido de ElevenLabs en Rivya para efectos cortos, transiciones y bucles de ambiente. Genera clips de audio de 0.5–22 segundos con influencia de indicación ajustable, modo de bucle y 19 formatos de salida para proyectos de edición, producto o juegos.

Créditos base

3

Modos

text-to-audio

Entrada de API

Entrada de texto lista

Entradas

text

Límite de prompt

5000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

{
  "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"
  }
}

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parámetros

keyTipoObligatorioPredeterminadoRangoOpciones
loopselectNofalse-false, true
duration_secondsnumberNo3min 0.5 / max 22 / step 0.5-
prompt_influencenumberNo0.3min 0 / max 1 / step 0.05-
output_formatselectNomp3_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-isolationDisponible vía APIRequiere Files API

Audio · Modelo de limpieza de audio y aislamiento de voz de ElevenLabs en Rivya. Sube una grabación para aislar voces, eliminar ruido de fondo y limpiar audio hablado antes de editarlo o publicarlo.

Créditos base

12

Modos

audio-to-audio

Entrada de API

Requiere Files API

Entradas

file

Límite de prompt

-

Medios de referencia

audio · 1 archivo(s)

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

No se muestra un ejemplo ejecutable de Public API para este modelo.

Regla de referencia

Audio fuente: Sube un archivo de audio y Rivya aislará y limpiará la pista objetivo.

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Los modos basados en archivos necesitan /api/v1/files antes de poder mostrarse como ejemplos API-ready completos. Files API

Parámetros

No se requiere ningún parámetro adicional del modelo.

GPT-5.5

gpt-5-5-chatDisponible vía APIEntrada de texto lista

Chat · Modelo avanzado de chat GPT de OpenAI en Rivya para razonamiento complejo, análisis con imágenes, síntesis de investigación y escritura estructurada cuando el brief necesita más margen.

Créditos base

5

Modos

responses

Entrada de API

Entrada de texto lista

Entradas

text, file

Límite de prompt

20000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API admite turnos no streaming y SSE streaming en Public API v1. Los adjuntos de imagen deben usar valores file_id de Files API.

Parámetros

No se requiere ningún parámetro adicional del modelo.

GPT-5.4

gpt-5-4-chatDisponible vía APIEntrada de texto lista

Chat · Modelo de chat IA de gama más alta de OpenAI en Rivya, con manejo más fuerte de entradas estructuradas, control de razonamiento y proyectos de conversación orientados a herramientas para tareas más complejas de análisis y escritura.

Créditos base

4

Modos

responses

Entrada de API

Entrada de texto lista

Entradas

text, file

Límite de prompt

20000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API admite turnos no streaming y SSE streaming en Public API v1. Los adjuntos de imagen deben usar valores file_id de Files API.

Parámetros

No se requiere ningún parámetro adicional del modelo.

GPT-5.4 Codex

gpt-5.4-codex-chatDisponible vía APIEntrada de texto lista

Chat · Modelo Codex de gama más alta de OpenAI en Rivya, con programación más fuerte, razonamiento estructurado y colaboración orientada a herramientas para proyectos exigentes de desarrollo a escala de repositorio.

Créditos base

4

Modos

responses

Entrada de API

Entrada de texto lista

Entradas

text, file

Límite de prompt

20000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API admite turnos no streaming y SSE streaming en Public API v1. Los adjuntos de imagen deben usar valores file_id de Files API.

Parámetros

No se requiere ningún parámetro adicional del modelo.

GPT-5.3 Codex

gpt-5-3-codex-chatDisponible vía APIEntrada de texto lista

Chat · El modelo Codex más reciente y capaz de OpenAI en Rivya. Combina generación de código de vanguardia con razonamiento agentic más profundo para los proyectos de desarrollo más exigentes.

Créditos base

4

Modos

responses

Entrada de API

Entrada de texto lista

Entradas

text, file

Límite de prompt

20000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API admite turnos no streaming y SSE streaming en Public API v1. Los adjuntos de imagen deben usar valores file_id de Files API.

Parámetros

No se requiere ningún parámetro adicional del modelo.

GPT-5.2

gpt-5-2-chatDisponible vía APIEntrada de texto lista

Chat · Modelo insignia de chat IA de OpenAI en Rivya, con razonamiento avanzado, soporte visual para hasta 6 imágenes y una ventana de contexto de 20K caracteres. Es una opción GPT general sólida para investigación, planificación, escritura y análisis con conciencia de imagen.

Créditos base

3

Modos

chat-completion

Entrada de API

Entrada de texto lista

Entradas

text, file

Límite de prompt

20000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API admite turnos no streaming y SSE streaming en Public API v1. Los adjuntos de imagen deben usar valores file_id de Files API.

Parámetros

No se requiere ningún parámetro adicional del modelo.

GPT-5.2 Codex

gpt-5-2-codex-chatDisponible vía APIEntrada de texto lista

Chat · Modelo Codex más avanzado de OpenAI en Rivya, con razonamiento más fuerte para tareas de ingeniería complejas. Está optimizado para programación agentic de largo horizonte, decisiones de arquitectura y refactorizaciones mayores donde la generación simple de código no basta.

Créditos base

4

Modos

responses

Entrada de API

Entrada de texto lista

Entradas

text, file

Límite de prompt

20000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API admite turnos no streaming y SSE streaming en Public API v1. Los adjuntos de imagen deben usar valores file_id de Files API.

Parámetros

No se requiere ningún parámetro adicional del modelo.

GPT-5.1 Codex

gpt-5-1-codex-chatDisponible vía APIEntrada de texto lista

Chat · Modelo Codex actualizado de OpenAI en Rivya, con mejor precisión de código y razonamiento más fuerte para tareas de programación agentic. Mantiene el mismo proyecto consciente del repositorio y de salida larga, pero mejora las refactorizaciones multifichero y las ediciones de código más seguras.

Créditos base

3

Modos

responses

Entrada de API

Entrada de texto lista

Entradas

text, file

Límite de prompt

20000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API admite turnos no streaming y SSE streaming en Public API v1. Los adjuntos de imagen deben usar valores file_id de Files API.

Parámetros

No se requiere ningún parámetro adicional del modelo.

GPT-5 Codex

gpt-5-codex-chatDisponible vía APIEntrada de texto lista

Chat · Modelo GPT-5 Codex especializado en código de OpenAI en Rivya para depuración, planificación de implementación, refactorizaciones y resolución técnica de problemas con soporte visual.

Créditos base

3

Modos

responses

Entrada de API

Entrada de texto lista

Entradas

text, file

Límite de prompt

20000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API admite turnos no streaming y SSE streaming en Public API v1. Los adjuntos de imagen deben usar valores file_id de Files API.

Parámetros

No se requiere ningún parámetro adicional del modelo.

Gemini 3.1 Pro

gemini-3-1-pro-chatDisponible vía APIEntrada de texto lista

Chat · El modelo de chat Gemini AI más reciente y capaz de Google en Rivya. Con razonamiento de primer nivel, visión y seguimiento de instrucciones, es la opción Gemini más sólida para tareas analíticas y creativas exigentes.

Créditos base

3

Modos

chat-completion

Entrada de API

Entrada de texto lista

Entradas

text, file

Límite de prompt

20000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API admite turnos no streaming y SSE streaming en Public API v1. Los adjuntos de imagen deben usar valores file_id de Files API.

Parámetros

No se requiere ningún parámetro adicional del modelo.

Gemini 3 Pro

gemini-3-pro-chatDisponible vía APIEntrada de texto lista

Chat · Modelo de chat IA Gemini de mayor profundidad de Google en Rivya. Con razonamiento más fuerte que Gemini 2.5 Pro y soporte visual, encaja mejor en síntesis de investigación, escritura técnica y análisis multimodal más deliberado.

Créditos base

2

Modos

chat-completion

Entrada de API

Entrada de texto lista

Entradas

text, file

Límite de prompt

20000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API admite turnos no streaming y SSE streaming en Public API v1. Los adjuntos de imagen deben usar valores file_id de Files API.

Parámetros

No se requiere ningún parámetro adicional del modelo.

Gemini 3 Flash

gemini-3-flash-chatDisponible vía APIEntrada de texto lista

Chat · Modelo de chat IA rápido de nueva generación de Google en Rivya. Con costos por token aún más bajos que Gemini 2.5 Flash y razonamiento más fuerte, está creado para chat multimodal de alto volumen, revisión inicial de capturas y trabajo rápido de asistente.

Créditos base

1

Modos

chat-completion

Entrada de API

Entrada de texto lista

Entradas

text, file

Límite de prompt

20000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API admite turnos no streaming y SSE streaming en Public API v1. Los adjuntos de imagen deben usar valores file_id de Files API.

Parámetros

No se requiere ningún parámetro adicional del modelo.

Gemini 2.5 Pro

gemini-2-5-pro-chatDisponible vía APIEntrada de texto lista

Chat · Modelo de chat Gemini AI más avanzado de Google en Rivya. Con razonamiento más fuerte que Flash, soporte visual y contexto 20K, encaja mejor con síntesis de investigación, análisis de documentos y escritura estructurada a 2 créditos.

Créditos base

2

Modos

chat-completion

Entrada de API

Entrada de texto lista

Entradas

text, file

Límite de prompt

20000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API admite turnos no streaming y SSE streaming en Public API v1. Los adjuntos de imagen deben usar valores file_id de Files API.

Parámetros

No se requiere ningún parámetro adicional del modelo.

Gemini 2.5 Flash

gemini-2-5-flash-chatDisponible vía APIEntrada de texto lista

Chat · El modelo de chat IA más rápido y asequible de Google en Rivya. Con 1 crédito por uso y soporte visual para hasta 6 imágenes, encaja con preguntas rápidas, resúmenes de primera pasada, revisión inicial de capturas y asistencia IA cotidiana.

Créditos base

1

Modos

chat-completion

Entrada de API

Entrada de texto lista

Entradas

text, file

Límite de prompt

20000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API admite turnos no streaming y SSE streaming en Public API v1. Los adjuntos de imagen deben usar valores file_id de Files API.

Parámetros

No se requiere ningún parámetro adicional del modelo.

Claude Opus 4.7

claude-opus-4-7-chatDisponible vía APIEntrada de texto lista

Chat · Modelo de chat Claude insignia de Anthropic en Rivya para razonamiento profundo, síntesis cuidadosa, escritura ejecutiva y trabajo de texto de alto impacto.

Créditos base

8

Modos

chat-completion

Entrada de API

Entrada de texto lista

Entradas

text

Límite de prompt

20000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API admite turnos no streaming y SSE streaming en Public API v1. Este modelo de Chat no admite adjuntos de imagen.

Parámetros

No se requiere ningún parámetro adicional del modelo.

Claude Opus 4.6

claude-opus-4-6-chatDisponible vía APIEntrada de texto lista

Chat · Modelo insignia de chat Claude AI de Anthropic en Rivya. Está creado para razonamiento profundo, análisis complejo y escritura de alta calidad en proyectos exigentes y de alto riesgo.

Créditos base

8

Modos

chat-completion

Entrada de API

Entrada de texto lista

Entradas

text

Límite de prompt

20000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API admite turnos no streaming y SSE streaming en Public API v1. Este modelo de Chat no admite adjuntos de imagen.

Parámetros

No se requiere ningún parámetro adicional del modelo.

Claude Sonnet 4.6

claude-sonnet-4-6-chatDisponible vía APIEntrada de texto lista

Chat · Modelo de chat Claude AI equilibrado de Anthropic en Rivya. Mantiene un razonamiento sólido de formato largo y análisis cuidadoso para proyectos de contenido, investigación y programación sin subir al gasto de nivel Opus.

Créditos base

4

Modos

chat-completion

Entrada de API

Entrada de texto lista

Entradas

text

Límite de prompt

20000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API admite turnos no streaming y SSE streaming en Public API v1. Este modelo de Chat no admite adjuntos de imagen.

Parámetros

No se requiere ningún parámetro adicional del modelo.

Claude Opus 4.5

claude-opus-4-5-chatDisponible vía APIEntrada de texto lista

Chat · Modelo insignia de chat Claude AI de Anthropic en Rivya. Es excepcional en razonamiento profundo, análisis complejo y escritura de nivel experto, lo que lo convierte en una opción premium para tareas de IA críticas.

Créditos base

8

Modos

chat-completion

Entrada de API

Entrada de texto lista

Entradas

text

Límite de prompt

20000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API admite turnos no streaming y SSE streaming en Public API v1. Este modelo de Chat no admite adjuntos de imagen.

Parámetros

No se requiere ningún parámetro adicional del modelo.

Claude Sonnet 4.5

claude-sonnet-4-5-chatDisponible vía APIEntrada de texto lista

Chat · Modelo de chat Claude AI equilibrado de Anthropic en Rivya. Destaca en escritura matizada, análisis cuidadoso y respuestas con criterio de seguridad, por lo que es una opción Claude sólida para creación de contenido e investigación.

Créditos base

4

Modos

chat-completion

Entrada de API

Entrada de texto lista

Entradas

text

Límite de prompt

20000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API admite turnos no streaming y SSE streaming en Public API v1. Este modelo de Chat no admite adjuntos de imagen.

Parámetros

No se requiere ningún parámetro adicional del modelo.

Claude Haiku 4.5

claude-haiku-4-5-chatDisponible vía APIEntrada de texto lista

Chat · Modelo ligero de chat Claude AI de Anthropic en Rivya. Está ajustado para velocidad, eficiencia de costos y rendimiento estable de chat diario en proyectos de alta frecuencia donde quieres tono Claude sin gasto premium.

Créditos base

2

Modos

chat-completion

Entrada de API

Entrada de texto lista

Entradas

text

Límite de prompt

20000 caracteres

Medios de referencia

-

Solicitud

POST /api/v1/generations

Autenticación

Bearer API key

Idempotency-Key

Recomendado

Body

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

Regla de referencia

-

Resultado

La respuesta de creación devuelve un ID de tarea público. Consulta GET /api/v1/generations/{taskId} hasta que el estado sea succeeded o failed.

Errores comunes

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API admite turnos no streaming y SSE streaming en Public API v1. Este modelo de Chat no admite adjuntos de imagen.

Parámetros

No se requiere ningún parámetro adicional del modelo.

Páginas relacionadas

Tabla de contenido