開発者向けリソース

Prompts

公開済みのプロンプト例を検索し、各プロンプトのサンプル素材と参照画像を取得します。

Prompts API は、公開済みのプロンプト例と、それを実行できるエンドポイントを返します。公開 API のため、API キーは不要です。

プロンプトの一覧

SHELL

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

modality、category、tags（カンマ区切り）、q、model で絞り込み、page と limit（最大 100）でページ分割します。レスポンスには prompts と pagination（page、per_page、total、pages）が含まれます。

プロンプトの取得

SHELL

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

プロンプトのフィールド

フィールド説明 id プロンプト ID。 title, prompt, negative_prompt タイトル、プロンプト本文、任意のネガティブプロンプト。 language, modality, input_kind, category, tags プロンプトのメタデータ。 preview_url カバー画像の URL。サンプル画像がない場合は null。 media すべてのサンプル素材と参照素材（元の順序）。下記を参照。 source_url, published_at 元のソースページと公開日時。 eligible_endpoints プロンプトを実行できるエンドポイント。

素材

media の各項目は、プロンプトに添付された 1 つのファイルを表します。

フィールド説明 role example_output または preview はサンプル結果、reference_input はユーザーが用意する参照画像です。null の場合があります。 modality image、video、audio（小文字）。null の場合があります。 media_type MIME タイプ（例: video/mp4）。null の場合があります。 url ファイルの URL。カバーに使われる項目は preview_url と同じ URL です。 alt_text テキストによる説明、または 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 項目を持つプロンプトは、自分の参照画像を用意した場合にのみ例に近い結果になります。動画のみのプロンプトは preview_url: null のため、動画は media から取得してください。