# 01Router — Gateway API reference

> A single REST API for image, video, audio and chat models across fal.ai, Replicate, WaveSpeedAI, KIE AI, APIMart, EvoLink, AtlasCloud, Vercel AI Gateway and OpenRouter.

Base URL: https://01router.com/api/v1
Documentation: https://01router.com/docs
Index: https://01router.com/docs/llms.txt?locale=en
Full reference: https://01router.com/docs/llms-full.txt?locale=en

Generation, task history, cancellation and chat require a key. Catalogs, prompts and quotes are public. Keep the API key on your server.

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


## Model reference

Source: https://01router.com/docs/models/gemini-3.8-flash-tts

# Gemini 3.8 Flash TTS API

Google Gemini 3.8 Flash TTS: expressive speech in 30 voices with natural-language style control and inline vocal events like <laugh>.

`POST /api/v1/generations`

Bearer API key

## Input parameters

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| model | string | yes | Model slug from the catalog. Project keys may use a project-specific model slug. | options: [   "gemini-3.8-flash-tts" ] |
| input | object | yes | Model-specific input object. See the selected model reference for required fields, defaults and limits. |  |
| provider | string | no | Optional provider slug. Omit for automatic routing; project settings may pin the provider. |  |
| project | string | no | Optional project ID. Use its published model catalog and routing configuration. |  |
| callback_url | string<uri> | no | Public HTTPS URL, up to 1,000 characters. Receives the final generation object. Private network addresses are rejected. |  |
| input.prompt | string | yes |  |  |
| input.voice | enum | no |  | default: "Kore"; options: [   "Kore",   "Puck",   "Charon",   "Fenrir",   "Leda",   "Orus",   "Aoede",   "Zephyr",   "Callirrhoe",   "Autonoe",   "Enceladus",   "Iapetus",   "Umbriel",   "Algieba",   "Despina",   "Erinome",   "Algenib",   "Rasalgethi",   "Laomedeia",   "Achernar",   "Alnilam",   "Schedar",   "Gacrux",   "Pulcherrima",   "Achird",   "Zubenelgenubi",   "Vindemiatrix",   "Sadachbia",   "Sadaltager",   "Sulafat" ] |
| input.style_instructions | string | no | e.g. "cheerful and friendly"; billing depends on the provider |  |

## Response fields

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| id | string | — | Generation ID returned by the create request. |  |
| object | "generation" | — | generation |  |
| model | string | — | Model slug from the catalog. Project keys may use a project-specific model slug. |  |
| type | video \| image \| audio \| chat | — |  |  |
| provider | string | — | Optional provider slug. Omit for automatic routing; project settings may pin the provider. |  |
| status | string | — | queued / processing / succeeded / failed. Stop polling on succeeded or failed. |  |
| input | object | — | Model-specific input object. See the selected model reference for required fields, defaults and limits. |  |
| outputs | string[] | — | Result file URLs. Empty until available; download promptly because URLs may expire. |  |
| error | string \| null | — | Error message on failure; null otherwise. |  |
| credits | number | — | Credits charged for this generation; zero after a refund. |  |
| price_usd | number | — | Price of this generation in USD; zero after a refund. |  |
| created_at | string | — | Creation time in ISO 8601 format. |  |
| completed_at | string \| null | — | Completion time in ISO 8601 format, or null while running. |  |

## cURL

```bash
curl 'https://01router.com/api/v1/generations' \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gemini-3.8-flash-tts",
  "input": {
    "prompt": "A cinematic landscape at sunrise.",
    "voice": "Kore"
  }
}'
```

## 200 · application/json

```json
{
  "id": "gen_example",
  "object": "generation",
  "model": "gemini-3.8-flash-tts",
  "type": "audio",
  "provider": "fal",
  "status": "processing",
  "input": {
    "prompt": "A cinematic landscape at sunrise.",
    "voice": "Kore"
  },
  "outputs": [],
  "error": null,
  "credits": 100,
  "price_usd": 1,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": null
}
```

## Usage notes

- Poll at intervals of at least 3 seconds. A 504 from the synchronous image endpoint means the task may still be running: poll its error.id instead of submitting it again.


## Endpoints for this model

- [POST /api/v1/generations](https://01router.com/docs/llms-full.txt?locale=en&section=create): Create a generation
- [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=en&section=poll): Get the result
- [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=en&section=cancel): Cancel a task
- [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=en&section=quote): Quote
- [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=en&section=model-detail): Get one model

For /generations and /quote, put these parameters inside input. For /images/generations, put them at the top level. Chat parameters go at the top level of /chat/completions.

Select a provider to see its effective parameter limits. Automatic routing chooses a provider that supports your input. Examples include defaults and required inputs; replace example media URLs with accessible files.

### Provider parameter schemas

```json
[
  {
    "provider": "fal",
    "params": [
      {
        "name": "prompt",
        "type": "text",
        "label": "Text",
        "required": true
      },
      {
        "name": "voice",
        "type": "enum",
        "label": "Voice",
        "options": [
          "Kore",
          "Puck",
          "Charon",
          "Fenrir",
          "Leda",
          "Orus",
          "Aoede",
          "Zephyr",
          "Callirrhoe",
          "Autonoe",
          "Enceladus",
          "Iapetus",
          "Umbriel",
          "Algieba",
          "Despina",
          "Erinome",
          "Algenib",
          "Rasalgethi",
          "Laomedeia",
          "Achernar",
          "Alnilam",
          "Schedar",
          "Gacrux",
          "Pulcherrima",
          "Achird",
          "Zubenelgenubi",
          "Vindemiatrix",
          "Sadachbia",
          "Sadaltager",
          "Sulafat"
        ],
        "default": "Kore"
      },
      {
        "name": "style_instructions",
        "type": "string",
        "label": "Style",
        "description": "e.g. \"cheerful and friendly\"; billing depends on the provider"
      }
    ]
  },
  {
    "provider": "wavespeed",
    "params": [
      {
        "name": "prompt",
        "type": "text",
        "label": "Text",
        "required": true,
        "maxLength": 8000
      },
      {
        "name": "voice",
        "type": "enum",
        "label": "Voice",
        "options": [
          "Kore",
          "Puck",
          "Charon",
          "Fenrir",
          "Leda",
          "Orus",
          "Aoede",
          "Zephyr",
          "Callirrhoe",
          "Autonoe",
          "Enceladus",
          "Iapetus",
          "Umbriel",
          "Algieba",
          "Despina",
          "Erinome",
          "Algenib",
          "Rasalgethi",
          "Laomedeia",
          "Achernar",
          "Alnilam",
          "Schedar",
          "Gacrux",
          "Pulcherrima",
          "Achird",
          "Zubenelgenubi",
          "Vindemiatrix",
          "Sadachbia",
          "Sadaltager",
          "Sulafat"
        ],
        "default": "Kore"
      },
      {
        "name": "style_instructions",
        "type": "string",
        "label": "Style",
        "description": "e.g. \"cheerful and friendly\"; billing depends on the provider",
        "maxLength": 2000
      }
    ]
  },
  {
    "provider": "kie",
    "params": [
      {
        "name": "prompt",
        "type": "text",
        "label": "Text",
        "required": true,
        "maxLength": 8000
      },
      {
        "name": "voice",
        "type": "enum",
        "label": "Voice",
        "options": [
          "Kore",
          "Puck",
          "Charon",
          "Fenrir",
          "Leda",
          "Orus",
          "Aoede",
          "Zephyr",
          "Callirrhoe",
          "Autonoe",
          "Enceladus",
          "Iapetus",
          "Umbriel",
          "Algieba",
          "Despina",
          "Erinome",
          "Algenib",
          "Rasalgethi",
          "Laomedeia",
          "Achernar",
          "Alnilam",
          "Schedar",
          "Gacrux",
          "Pulcherrima",
          "Achird",
          "Zubenelgenubi",
          "Vindemiatrix",
          "Sadachbia",
          "Sadaltager",
          "Sulafat"
        ],
        "default": "Kore"
      },
      {
        "name": "style_instructions",
        "type": "string",
        "label": "Style",
        "description": "e.g. \"cheerful and friendly\"; billing depends on the provider",
        "maxLength": 2000
      }
    ]
  },
  {
    "provider": "vercel",
    "params": [
      {
        "name": "prompt",
        "type": "text",
        "label": "Text",
        "required": true,
        "maxLength": 8000
      },
      {
        "name": "voice",
        "type": "enum",
        "label": "Voice",
        "options": [
          "Kore",
          "Puck",
          "Charon",
          "Fenrir",
          "Leda",
          "Orus",
          "Aoede",
          "Zephyr",
          "Callirrhoe",
          "Autonoe",
          "Enceladus",
          "Iapetus",
          "Umbriel",
          "Algieba",
          "Despina",
          "Erinome",
          "Algenib",
          "Rasalgethi",
          "Laomedeia",
          "Achernar",
          "Alnilam",
          "Schedar",
          "Gacrux",
          "Pulcherrima",
          "Achird",
          "Zubenelgenubi",
          "Vindemiatrix",
          "Sadachbia",
          "Sadaltager",
          "Sulafat"
        ],
        "default": "Kore"
      },
      {
        "name": "style_instructions",
        "type": "string",
        "label": "Style",
        "description": "e.g. \"cheerful and friendly\"; billing depends on the provider",
        "maxLength": 2000
      }
    ]
  },
  {
    "provider": "openrouter",
    "params": [
      {
        "name": "prompt",
        "type": "text",
        "label": "Text",
        "required": true,
        "maxLength": 8000
      },
      {
        "name": "voice",
        "type": "enum",
        "label": "Voice",
        "options": [
          "Kore",
          "Puck",
          "Charon",
          "Fenrir",
          "Leda",
          "Orus",
          "Aoede",
          "Zephyr",
          "Callirrhoe",
          "Autonoe",
          "Enceladus",
          "Iapetus",
          "Umbriel",
          "Algieba",
          "Despina",
          "Erinome",
          "Algenib",
          "Rasalgethi",
          "Laomedeia",
          "Achernar",
          "Alnilam",
          "Schedar",
          "Gacrux",
          "Pulcherrima",
          "Achird",
          "Zubenelgenubi",
          "Vindemiatrix",
          "Sadachbia",
          "Sadaltager",
          "Sulafat"
        ],
        "default": "Kore"
      },
      {
        "name": "style_instructions",
        "type": "string",
        "label": "Style",
        "description": "e.g. \"cheerful and friendly\"; billing depends on the provider",
        "maxLength": 2000
      }
    ]
  }
]
```

---