开发者资源

Prompts

搜索已发布的 Prompt 示例，并读取每条 Prompt 的示例素材和参考图。

Prompts API 返回已发布的 Prompt 示例，以及可以运行它们的端点。接口公开，不需要 API 密钥。

列出 Prompt

SHELL

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

可用 modality、category、tags（以逗号连接多个）、q 和 model 过滤。翻页使用 page 和 limit，limit 最多 100。响应包含 prompts 和 pagination（page、per_page、total、pages）。

获取单条 Prompt

SHELL

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

Prompt 字段

字段说明 id Prompt ID。 title、prompt、negative_prompt 标题、Prompt 文本和可选的反向提示词。 language、modality、input_kind、category、tags Prompt 元数据。 preview_url 封面图地址；没有示例图时为 null。 media 全部示例素材和参考图，按来源顺序排列，见下文。 source_url、published_at 原始来源页和发布时间。 eligible_endpoints 可以运行该 Prompt 的端点。

素材（media）

media 的每一项对应 Prompt 附带的一个文件：

字段说明 role example_output 或 preview 表示示例结果；reference_input 表示需要用户自己提供的参考图。可能为 null。 modality image、video 或 audio，小写。可能为 null。 media_type MIME 类型，例如 video/mp4。可能为 null。 url 文件地址。被用作封面的那一项与 preview_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 的 Prompt，只有提供你自己的参考图，结果才会接近示例。只有视频的 Prompt preview_url 为 null，视频从 media 读取。