Aller au contenu
Ressources pour développeurs
Ressources pour développeurs

Prompts

Recherchez des exemples de prompts publiés et lisez les médias d'exemple et les images de référence de chaque prompt.

Voir en Markdown

La Prompts API renvoie des exemples de prompts publiés avec les endpoints capables de les exécuter. Elle est publique et ne nécessite pas de clé API.

Lister les prompts

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

Filtrez avec modality, category, tags (séparés par des virgules), q et model. Paginez avec page et limit (100 au maximum). La réponse contient prompts et pagination (page, per_page, total, pages).

Récupérer un prompt

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

Champs du prompt

Champ Description id ID du prompt. title, prompt, negative_prompt Titre, texte du prompt et prompt négatif facultatif. language, modality, input_kind, category, tags Métadonnées du prompt. preview_url URL de l’image de couverture, ou null si le prompt n’a pas d’image d’exemple. media Tous les éléments d’exemple et de référence, dans l’ordre d’origine. Voir ci-dessous. source_url, published_at Page source d’origine et date de publication. eligible_endpoints Endpoints capables d’exécuter le prompt.

Médias

Chaque élément de media décrit un fichier joint au prompt :

Champ Description role example_output ou preview pour les résultats d’exemple ; reference_input pour une image de référence que l’utilisateur doit fournir. Peut être null. modality image, video ou audio, en minuscules. Peut être null. media_type Type MIME, par exemple video/mp4. Peut être null. url URL du fichier. L’élément utilisé comme couverture a la même URL que preview_url. alt_text Description textuelle, ou 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 comportant un élément reference_input ne donne des résultats proches de ses exemples que si vous fournissez votre propre image de référence. Un prompt vidéo uniquement a preview_url: null ; lisez ses vidéos dans media.