Entwickler-Ressourcen

Prompts

Veröffentlichte Prompt-Beispiele durchsuchen und die Beispielmedien und Referenzbilder jedes Prompts abrufen.

Die Prompts API liefert veröffentlichte Prompt-Beispiele zusammen mit den Endpoints, die sie ausführen können. Sie ist öffentlich und benötigt keinen API-Schlüssel.

Prompts auflisten

SHELL

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

Filtern Sie mit modality, category, tags (kommagetrennt), q und model. Blättern Sie mit page und limit (höchstens 100). Die Antwort enthält prompts und pagination (page, per_page, total, pages).

Einen Prompt abrufen

SHELL

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

Prompt-Felder

Feld Beschreibung id Prompt-ID. title, prompt, negative_prompt Titel, Prompt-Text und optionaler Negativ-Prompt. language, modality, input_kind, category, tags Prompt-Metadaten. preview_url URL des Titelbilds oder null, wenn der Prompt kein Beispielbild hat. media Alle Beispiel- und Referenzelemente in Quellreihenfolge. Siehe unten. source_url, published_at Ursprüngliche Quellseite und Veröffentlichungszeit. eligible_endpoints Endpoints, die den Prompt ausführen können.

Medien

Jedes media-Element beschreibt eine an den Prompt angehängte Datei:

Feld Beschreibung role example_output oder preview für Beispielergebnisse; reference_input für ein Referenzbild, das der Nutzer bereitstellen muss. Kann null sein. modality image, video oder audio, kleingeschrieben. Kann null sein. media_type MIME-Typ, etwa video/mp4. Kann null sein. url Datei-URL. Das als Titelbild verwendete Element hat dieselbe URL wie preview_url. alt_text Textbeschreibung oder 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"}
]

Ein Prompt mit einem reference_input-Element liefert nur dann Ergebnisse wie seine Beispiele, wenn Sie ein eigenes Referenzbild bereitstellen. Ein Prompt nur mit Video hat preview_url: null; lesen Sie seine Videos aus media.