Risorse per sviluppatori

Prompts

Cerca esempi di prompt pubblicati e leggi i media di esempio e le immagini di riferimento di ogni prompt.

La Prompts API restituisce esempi di prompt pubblicati insieme agli endpoint che possono eseguirli. È pubblica e non richiede una chiave API.

Elencare i prompt

SHELL

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

Filtra con modality, category, tags (separati da virgole), q e model. Pagina con page e limit (al massimo 100). La risposta contiene prompts e pagination (page, per_page, total, pages).

Recuperare un prompt

SHELL

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

Campi del prompt

Campo Descrizione id ID del prompt. title, prompt, negative_prompt Titolo, testo del prompt e prompt negativo facoltativo. language, modality, input_kind, category, tags Metadati del prompt. preview_url URL dell’immagine di copertina, oppure null se il prompt non ha un’immagine di esempio. media Tutti gli elementi di esempio e di riferimento, nell’ordine di origine. Vedi sotto. source_url, published_at Pagina di origine e data di pubblicazione. eligible_endpoints Endpoint che possono eseguire il prompt.

Media

Ogni elemento di media descrive un file allegato al prompt:

Campo Descrizione role example_output o preview per i risultati di esempio; reference_input per un’immagine di riferimento che l’utente deve fornire. Può essere null. modality image, video o audio, in minuscolo. Può essere null. media_type Tipo MIME, ad esempio video/mp4. Può essere null. url URL del file. L’elemento usato come copertina ha lo stesso URL di preview_url. alt_text Descrizione testuale, oppure 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 dà risultati simili ai suoi esempi solo se fornisci una tua immagine di riferimento. Un prompt solo video ha preview_url: null; leggi i suoi video da media.