Developer Resources
Prompts
Zoek gepubliceerde promptvoorbeelden en lees de voorbeeldmedia en referentieafbeeldingen van elke prompt.
De Prompts API retourneert gepubliceerde promptvoorbeelden met de endpoints die ze kunnen uitvoeren. De API is openbaar en vereist geen API-sleutel.
Prompts weergeven
SHELL
curl "https://runapi.ai/api/v1/prompts?modality=video&q=sunset&limit=20"
Filter met modality, category, tags (kommagescheiden), q en model. Pagineer met page en limit (maximaal 100). Het antwoord bevat prompts en pagination (page, per_page, total, pages).
Een prompt ophalen
SHELL
curl "https://runapi.ai/api/v1/prompts/PROMPT_ID"
Promptvelden
Veld
Beschrijving
id
Prompt-ID.
title, prompt, negative_prompt
Titel, prompttekst en optionele negatieve prompt.
language, modality, input_kind, category, tags
Promptmetadata.
preview_url
URL van de omslagafbeelding, of null als de prompt geen voorbeeldafbeelding heeft.
media
Alle voorbeeld- en referentie-items, in bronvolgorde. Zie hieronder.
source_url, published_at
Oorspronkelijke bronpagina en publicatietijd.
eligible_endpoints
Endpoints die de prompt kunnen uitvoeren.
Media
Elk media-item beschrijft één bestand dat aan de prompt is gekoppeld:
Veld
Beschrijving
role
example_output of preview voor voorbeeldresultaten; reference_input voor een referentieafbeelding die de gebruiker moet aanleveren. Kan null zijn.
modality
image, video of audio, in kleine letters. Kan null zijn.
media_type
MIME-type, zoals video/mp4. Kan null zijn.
url
Bestands-URL. Het item dat als omslag wordt gebruikt, heeft dezelfde URL als preview_url.
alt_text
Tekstuele beschrijving, of 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"}
]
Een prompt met een reference_input-item geeft alleen resultaten zoals de voorbeelden als u een eigen referentieafbeelding aanlevert. Een prompt met alleen video heeft preview_url: null; lees de video’s uit media.