Skip to main content
Welcome to the Faseeh API reference. This documentation provides detailed information about all available endpoints, request/response formats, and authentication methods.

​
Base URL

All API requests should be made to: 
https://api.faseeh.ai/api/v1

​
Authentication

All API endpoints require authentication using an API key. Include your API key in the request headers: 
x-api-key: YOUR_API_KEY
Security: Keep your API key secure and never expose it in client-side code or public repositories. API keys can be created and managed in the Faseeh dashboard.

​
Endpoints

Models

Retrieve available models

Text-to-Speech (POST)

Generate speech and receive complete WAV file

Text-to-Speech (STREAM)

Generate speech with streaming PCM16 audio

WebSocket Streaming (WSS)

Real-time bidirectional audio streaming

​
Response Formats

​
Success Responses

Successful API responses return appropriate data based on the endpoint:
  • JSON: For model listings and metadata
  • Audio Stream: For streaming audio generation (PCM16)
  • Audio File: For complete audio generation (WAV)

​
Error Responses

Error responses follow this format: 
{
  "errorCode": "xxxxxx",
  "errorMessage": "Human-readable error message"
}
Common HTTP status codes:
  • 200: Success
  • 400: Bad Request - Invalid parameters
  • 401: Unauthorized - Invalid or missing API key
  • 402: Payment Required - Insufficient wallet balance
  • 404: Not Found - Resource not found
  • 429: Too Many Requests - Rate limit exceeded
  • 500: Internal Server Error

​
Wallet System

Faseeh uses a wallet-based billing system. Each API call consumes credits based on:
  • Model cost per character
  • Text length
  • Generation type
Ensure your wallet has sufficient balance before making API calls. Insufficient balance will result in a 402 Payment Required error.

​
Getting Started

Quickstart Guide

Follow our quickstart guide to make your first API call