Geliştirici Kaynakları

Prompts

Yayınlanmış prompt örneklerini arayın ve her prompt'un örnek medyasını ve referans görsellerini okuyun.

Prompts API, yayınlanmış prompt örneklerini ve bunları çalıştırabilen endpoint’leri döndürür. Herkese açıktır ve API anahtarı gerektirmez.

Prompt'ları listeleme

SHELL

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

modality, category, tags (virgülle ayrılmış), q ve model ile filtreleyin. page ve limit (en fazla 100) ile sayfalayın. Yanıt prompts ve pagination (page, per_page, total, pages) içerir.

Bir prompt'u alma

SHELL

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

Prompt alanları

Alan Açıklama id Prompt kimliği. title, prompt, negative_prompt Başlık, prompt metni ve isteğe bağlı negatif prompt. language, modality, input_kind, category, tags Prompt meta verileri. preview_url Kapak görseli URL’si; prompt’un örnek görseli yoksa null. media Tüm örnek ve referans öğeleri, kaynak sırasıyla. Aşağıya bakın. source_url, published_at Orijinal kaynak sayfası ve yayın zamanı. eligible_endpoints Prompt’u çalıştırabilen endpoint’ler.

Medya

Her media öğesi prompt’a eklenmiş bir dosyayı tanımlar:

Alan Açıklama role Örnek sonuçlar için example_output veya preview; kullanıcının sağlaması gereken referans görsel için reference_input. null olabilir. modality image, video veya audio, küçük harfle. null olabilir. media_type MIME türü, örneğin video/mp4. null olabilir. url Dosya URL’si. Kapak olarak kullanılan öğe preview_url ile aynı URL’ye sahiptir. alt_text Metin açıklaması veya 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"}
]

reference_input öğesi olan bir prompt, yalnızca kendi referans görselinizi sağladığınızda örneklerine benzer sonuçlar verir. Yalnızca video içeren bir prompt’ta preview_url: null olur; videolarını media içinden okuyun.