Source: https://01router.com/docs/prompts
Base URL: https://01router.com/api/v1

# Prompt API

Public read-only endpoints: no API key or credits required. Browse published examples for active models using combined model, source and scene filters.

`GET /api/v1/prompts`

Public · No API key

## Input parameters

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| model | string | no | 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 | string | no | 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 | string | no | Optional exact scene name, such as Cinematic Story. Use a name from scenes and URL-encode query values. |  |
| locale | string | no | Optional: en or zh; defaults to en. Includes matching-language and language-neutral records. Also supported by the detail endpoint. | default: "en"; options: [   "en",   "zh" ] |
| page | integer | no | 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; min: 1; max: 100000 |

## Response fields

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| 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. |  |

## cURL

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

## 200 · application/json

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

## 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.