提示词 API

请求

curl 'https://01router.com/api/v1/prompts?model=seedance-2.5&locale=en&page=1'

model

string可选

可选。模型 slug，例如 seedance-2.5；不传则查询所有模型。返回的 categories 提供可选模型及各模型的收录量。

source

string可选

可选。来源域名，例如 evolink.ai；seed 表示种子示例，unknown 表示未标注来源。使用 sources 返回的 name，不是模型供应商路由参数。

scene

string可选

可选。场景分类的完整名称，例如 Cinematic Story；使用 scenes 返回的 name，并对查询值进行 URL 编码。

locale

string可选

可选，en 或 zh，默认 en。返回对应语言及语言通用的记录；详情接口也接受此参数。

默认值:"en"

可选值:"en""zh"

page

integer可选

可选。1–100000 的整数，默认 1，每页固定 24 条。超过总页数时返回最后一页；空结果的 total_pages 为 1。

默认值:1

最小值:1

最大值:100000

响应示例

{
  "object": "list",
  "data": [
    {
      "id": "prompt_example",
      "title": "Cinematic landscape",
      "prompt": "A cinematic landscape at sunrise.",
      "category": "Cinematic Story",
      "source": "evolink.ai",
      "mediaType": "video",
      "mediaUrl": "https://example.com/video.mp4",
      "modelSlug": "seedance-2.5",
      "modelName": "Seedance 2.5"
    }
  ],
  "total": 1,
  "page": 1,
  "page_size": 24,
  "total_pages": 1,
  "categories": [
    {
      "slug": "seedance-2.5",
      "name": "Seedance 2.5",
      "type": "video",
      "total": 1
    }
  ],
  "sources": [
    {
      "name": "evolink.ai",
      "total": 1
    }
  ],
  "scenes": [
    {
      "name": "Cinematic Story",
      "total": 1
    }
  ]
}

响应仅用于说明结构；ID、用量、价格和结果以实际请求为准。

输出字段

data

array

公开提示词对象：id、title、prompt、category、source、mediaType、mediaUrl、modelSlug 和 modelName。

total

integer

匹配记录的总数。

page / page_size / total_pages

integer

可选。1–100000 的整数，默认 1，每页固定 24 条。超过总页数时返回最后一页；空结果的 total_pages 为 1。

categories / sources / scenes

array

可用模型分类、来源和场景及数量，统计范围见下方说明。

使用说明

• 下方为返回结构示意，数量和内容以实际响应为准。data 为提示词数组；categories 为当前语言下所有模型分类；sources 的数量按当前模型统计，scenes 的数量按当前模型和来源统计；total 是应用全部筛选后的数量。category 表示场景分类，modelSlug 表示模型分类。
• 使用返回的 modelSlug 和 prompt 构造下方请求体，调用 POST /generations；生成接口仍需 API Key，并按模型计费。其他生成参数请通过 GET /models/{slug} 查询后补充。
• 参数无效返回 400；模型分类或提示词不存在、停用或在所选语言下不可见时返回 404；有效分类下无匹配结果返回 200 和空 data。接口按 IP 限流，同一路径请求间隔至少 200 毫秒，触发时返回 429 和 Retry-After；成功响应允许缓存 60 秒。