Prompt API

Request

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

model

stringOptional

Optional model slug, such as seedance-2.5. Omit to query all models. The categories array lists available models and their collected prompt counts.

source

stringOptional

Optional source domain, such as evolink.ai. seed means seeded examples; unknown means unspecified. Use a name from sources. This is provenance, not a provider routing parameter.

scene

stringOptional

Optional exact scene name, such as Cinematic Story. Use a name from scenes and URL-encode query values.

locale

stringOptional

Optional: en or zh; defaults to en. Includes matching-language and language-neutral records. Also supported by the detail endpoint.

Default:"en"

Allowed values:"en""zh"

page

integerOptional

Optional integer from 1 to 100000; defaults to 1. Fixed page size of 24. Values above the last page return the last page; empty results have total_pages: 1.

Default:1

Minimum:1

Maximum:100000

Response example

{
  "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
    }
  ]
}

Responses are illustrative. IDs, usage, prices and results depend on the actual request.

Response fields

data

array

Published prompt objects: id, title, prompt, category, source, mediaType, mediaUrl, modelSlug and modelName.

total

integer

Total number of matching records.

page / page_size / total_pages

integer

Optional integer from 1 to 100000; defaults to 1. Fixed page size of 24. Values above the last page return the last page; empty results have total_pages: 1.

categories / sources / scenes

array

Available model categories, sources and scenes with counts. Counts use the filter scopes described below.

Usage notes

• Illustrative response below; counts and content depend on your query. data contains prompts. categories lists all model categories for the locale. sources counts reflect the current model; scenes counts reflect the model and source. total applies all filters. category is the scene; modelSlug is the model category.
• Use modelSlug and prompt to construct the request body below for POST /generations. Generation still requires an API key and incurs model charges. Query GET /models/{slug} for any additional required inputs.
• Invalid parameters return 400. Missing, disabled or locale-unavailable model categories and prompts return 404. Valid categories with no matching results return 200 and empty data. Requests to the same path are limited by IP to intervals of at least 200 ms; 429 includes Retry-After. Successful responses are cacheable for 60 seconds.