fakeyou-api 0.2.0

A very simple Rust library for FakeYou API.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

[comment]: # (README.md is autogenerated from src/lib.rs by `cargo readme > README.md`)

# fakeyou-api

<div align="center">
<!-- Build -->
<img src="https://img.shields.io/github/actions/workflow/status/alexjercan/fakeyou-api/rust.yml?style=flat-square"
alt="Github Worflow Status" />
<!-- Version -->
<a href="https://crates.io/crates/fakeyou-api">
  <img src="https://img.shields.io/crates/v/fakeyou-api?style=flat-square"
  alt="Crates.io version" />
</a>
<!-- Docs -->
<a href="https://docs.rs/fakeyou-api">
  <img src="https://img.shields.io/badge/docs-latest-blue.svg?style=flat-square"
    alt="docs.rs docs" />
</a>
<!-- Downloads -->
<a href="https://crates.io/crates/fakeyou-api">
  <img src="https://img.shields.io/crates/d/fakeyou-api?style=flat-square"
    alt="Crates.io downloads" />
</a>
<!-- License -->
<a href="https://github.com/alexjercan/fakeyou-api/blob/master/LICENSE">
  <img src="https://img.shields.io/github/license/alexjercan/fakeyou-api?style=flat-square"
    alt="Crates.io downloads" />
</a>
</div>

A very simple Rust library for FakeYou API.

### API

Check the [official](https://docs.fakeyou.com/) API reference.

|API|Support|
|---|---|
|Text to Speech|✔️|
|Voices|❌|
|Categories|❌|

### Usage

Install the library using the Cargo.toml file or run the following command.

```console
cargo add fakeyou-api
```

Export your API key into the environment variables (if you use the paid version).

```console
export FAKEYOU_API_KEY=...
```

Then use the crate in your Rust code:

```rust
// Import the dependencies
use fakeyou_api::{tts::InferenceBody, util::tts::TtsApiSync, *};

// You can create a default client without any api key.
// You can also load the API key from environment FAKEYOU_API_KEY.
// You can also hadcode through `Auth::new(<your_api_key>)`, but it is not recommended.
let auth = Auth::default();
let fakeyou = FakeYou::new(auth, FAKEYOU_API_URL);

// Create the TTS body
let inference_body =
    InferenceBody::new("TM:ebgxj0j4fvzp", "Hello, World! What should we do today?");

// Call the TTS API
// This uses the util module of this crate and will block the thread until the task is done
let output_result = fakeyou.create_tts_task(&inference_body).unwrap();

// Do what you need with the audio file
std::fs::write("output.wav", output_result.bytes).unwrap();
```

### License
This project is licensed under MIT