Naar inhoud springen
Developer Resources
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.