Saltar al contenido
Recursos para desarrolladores
Recursos para desarrolladores

Prompts

Busca ejemplos de prompts publicados y lee los medios de ejemplo y las imágenes de referencia de cada prompt.

Ver Markdown

La Prompts API devuelve ejemplos de prompts publicados junto con los endpoints que pueden ejecutarlos. Es pública y no requiere clave de API.

Listar prompts

SHELL 
curl "https://runapi.ai/api/v1/prompts?modality=video&q=sunset&limit=20"

Filtra con modality, category, tags (separadas por comas), q y model. Pagina con page y limit (máximo 100). La respuesta contiene prompts y pagination (page, per_page, total, pages).

Obtener un prompt

SHELL 
curl "https://runapi.ai/api/v1/prompts/PROMPT_ID"

Campos del prompt

Campo Descripción id ID del prompt. title, prompt, negative_prompt Título, texto del prompt y prompt negativo opcional. language, modality, input_kind, category, tags Metadatos del prompt. preview_url URL de la imagen de portada, o null si el prompt no tiene imagen de ejemplo. media Todos los elementos de ejemplo y de referencia, en el orden de origen. Ver abajo. source_url, published_at Página de origen y fecha de publicación. eligible_endpoints Endpoints que pueden ejecutar el prompt.

Medios

Cada elemento de media describe un archivo adjunto al prompt:

Campo Descripción role example_output o preview para resultados de ejemplo; reference_input para una imagen de referencia que debe aportar el usuario. Puede ser null. modality image, video o audio, en minúsculas. Puede ser null. media_type Tipo MIME, como video/mp4. Puede ser null. url URL del archivo. El elemento usado como portada tiene la misma URL que preview_url. alt_text Descripción de texto, o null.
JSON 
"media": [
  {"role": "example_output", "modality": "video", "media_type": "video/mp4", "url": "https://example.test/clip.mp4", "alt_text": null},
  {"role": "reference_input", "modality": "image", "media_type": "image/png", "url": "https://example.test/face.png", "alt_text": "Face"}
]

Un prompt con un elemento reference_input solo da resultados como sus ejemplos si proporcionas tu propia imagen de referencia. Un prompt solo con video tiene preview_url: null; lee sus videos desde media.