Zasoby dla deweloperów

Prompts

Wyszukuj opublikowane przykłady promptów i odczytuj przykładowe media oraz obrazy referencyjne każdego promptu.

Prompts API zwraca opublikowane przykłady promptów wraz z endpointami, które mogą je uruchomić. Jest publiczne i nie wymaga klucza API.

Lista promptów

SHELL

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

Filtruj za pomocą modality, category, tags (rozdzielone przecinkami), q i model. Stronicuj za pomocą page i limit (maksymalnie 100). Odpowiedź zawiera prompts i pagination (page, per_page, total, pages).

Pobieranie promptu

SHELL

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

Pola promptu

Pole Opis id ID promptu. title, prompt, negative_prompt Tytuł, tekst promptu i opcjonalny prompt negatywny. language, modality, input_kind, category, tags Metadane promptu. preview_url URL obrazu okładki lub null, gdy prompt nie ma przykładowego obrazu. media Wszystkie elementy przykładowe i referencyjne w kolejności źródłowej. Zobacz niżej. source_url, published_at Oryginalna strona źródłowa i czas publikacji. eligible_endpoints Endpointy, które mogą uruchomić prompt.

Media

Każdy element media opisuje jeden plik dołączony do promptu:

Pole Opis role example_output lub preview dla przykładowych wyników; reference_input dla obrazu referencyjnego, który musi dostarczyć użytkownik. Może mieć wartość null. modality image, video lub audio, małymi literami. Może mieć wartość null. media_type Typ MIME, np. video/mp4. Może mieć wartość null. url URL pliku. Element użyty jako okładka ma ten sam URL co preview_url. alt_text Opis tekstowy lub 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"}
]

Prompt z elementem reference_input daje wyniki podobne do przykładów tylko wtedy, gdy dostarczysz własny obraz referencyjny. Prompt zawierający tylko wideo ma preview_url: null; odczytaj jego filmy z media.