> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# appmixer.utils.ai.CreateSpeech

- Component: `appmixer.utils.ai.CreateSpeech`
- Kind: Action
- Version: 1.0.0
- Visibility: Public
- Connector: [appmixer.utils.ai 1.1.4](https://connectors.appmixer.com/connector/appmixer.utils.ai/1.1.4.md)
- Component page: <https://connectors.appmixer.com/connector/appmixer.utils.ai/1.1.4/component/appmixer.utils.ai.CreateSpeech>

Generates audio from the input text.

## Input ports

### Port `in`

| Field | Type | Description |
| --- | --- | --- |
| Text (`input`) | textarea | - |
| Voice (`voice`) | select | - |
| Response Format (`responseFormat`) | select | - |
| Speed (`speed`) | number | - |

## Output ports

### Port `out`

| Field | Type | Description |
| --- | --- | --- |
| File ID (`fileId`) | string | - |
| File Size (`fileSize`) | number | - |
| Text (`input`) | string | - |

## Full metadata (component.json)

```json
{
  "name": "appmixer.utils.ai.CreateSpeech",
  "author": "Appmixer <info@appmixer.com>",
  "description": "Generates audio from the input text.",
  "inPorts": [
    {
      "name": "in",
      "schema": {
        "type": "object",
        "properties": {
          "input": {
            "type": "string"
          },
          "voice": {
            "type": "string"
          },
          "responseFormat": {
            "type": "string"
          },
          "speed": {
            "type": "number"
          }
        },
        "required": [
          "input"
        ]
      },
      "inspector": {
        "inputs": {
          "input": {
            "label": "Text",
            "type": "textarea",
            "index": 1
          },
          "voice": {
            "label": "Voice",
            "type": "select",
            "defaultValue": "alloy",
            "options": [
              {
                "label": "Alloy (woman)",
                "value": "alloy"
              },
              {
                "label": "Echo (man)",
                "value": "echo"
              },
              {
                "label": "Fable (woman)",
                "value": "fable"
              },
              {
                "label": "Onyx (man)",
                "value": "onyx"
              },
              {
                "label": "Nova (woman)",
                "value": "nova"
              },
              {
                "label": "Shimmer (woman)",
                "value": "shimmer"
              }
            ],
            "index": 2
          },
          "responseFormat": {
            "label": "Response Format",
            "type": "select",
            "defaultValue": "mp3",
            "options": [
              {
                "label": "mp3",
                "value": "mp3"
              },
              {
                "label": "wav",
                "value": "wav"
              },
              {
                "label": "aac",
                "value": "aac"
              },
              {
                "label": "flac",
                "value": "flac"
              },
              {
                "label": "opus",
                "value": "opus"
              },
              {
                "label": "pcm",
                "value": "pcm"
              }
            ],
            "index": 3
          },
          "speed": {
            "label": "Speed",
            "type": "number",
            "index": 4,
            "defaultValue": 1
          }
        }
      }
    }
  ],
  "outPorts": [
    {
      "name": "out",
      "options": [
        {
          "label": "File ID",
          "value": "fileId",
          "schema": {
            "type": "string",
            "format": "appmixer-file-id",
            "example": "a1686006-35c8-4ffc-b23e-d687858cd418"
          }
        },
        {
          "label": "File Size",
          "value": "fileSize",
          "schema": {
            "type": "number",
            "example": 48000
          }
        },
        {
          "label": "Text",
          "value": "input",
          "schema": {
            "type": "string",
            "example": "Your order has shipped and will arrive on Friday."
          }
        }
      ]
    }
  ],
  "icon": "(data URI omitted)"
}
```
