google/gemini-2.5-pro-tts

文生音訊

PRO

Gemini 2.5 Pro TTS API by Google

google/gemini-2.5-pro-tts

Gemini-2.5-pro-tts

Gemini text-to-speech (Pro): studio-quality, expressive speech from text with 30 prebuilt voices and natural-language style control. Powered by gemini-2.5-pro-preview-tts.

Gemini 2.5 Pro TTS 由 Google 開發。Atlas Cloud（由 Atlas Cloud AI LLC 營運）僅提供接取服務，並不擁有該模型。所有商標均歸其各自所有者所有。

輸入

文字 *

語音

輸出

閒置

生成的音訊將顯示在這裡

輸入文字並點擊執行以合成語音。

參數

程式碼範例
import requests
import time

# Step 1: Start audio generation
generate_url = "https://api.atlascloud.ai/api/v1/model/generateAudio"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
    "model": "google/gemini-2.5-pro-tts",  # Required. Model name. options: google/gemini-2.5-pro-tts
    "text": "Welcome to Atlas Cloud — One API for All Media AI.",  # Required. Text to synthesize into speech audio
    "voice": "Kore",  # Gemini prebuilt voice
}

generate_response = requests.post(generate_url, headers=headers, json=data)
generate_result = generate_response.json()
prediction_id = generate_result["data"]["id"]

# Step 2: Poll for result
poll_url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"

def check_status():
    while True:
        response = requests.get(poll_url, headers={"Authorization": "Bearer $ATLASCLOUD_API_KEY"})
        result = response.json()

        if result["data"]["status"] in ["completed", "succeeded"]:
            print("Generated audio:", result["data"]["outputs"][0])
            return result["data"]["outputs"][0]
        elif result["data"]["status"] == "failed":
            raise Exception(result["data"]["error"] or "Generation failed")
        else:
            # Still processing, wait 2 seconds
            time.sleep(2)

audio_url = check_status()

安裝

安裝所需的相依套件。

pip install requests

驗證

所有 API 請求都需要透過 API Key 進行認證。您可以在 Atlas Cloud 控制台取得 API Key。

export ATLASCLOUD_API_KEY="your-api-key-here"

HTTP 標頭

import os

API_KEY = os.environ.get("ATLASCLOUD_API_KEY")
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_KEY}"
}

保護好您的 API Key

切勿在客戶端程式碼或公開儲存庫中暴露您的 API Key。請使用環境變數或後端代理。

提交請求

import requests

url = "https://api.atlascloud.ai/api/v1/model/generateAudio"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
    "model": "your-model",
    "text": "Hello, welcome to AtlasCloud text-to-speech."
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

提交請求

提交一個非同步生成請求。API 會傳回一個 prediction ID，您可以用它來檢查狀態與取得結果。

POST/api/v1/model/generateAudio

請求主體

import requests

url = "https://api.atlascloud.ai/api/v1/model/generateAudio"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer $ATLASCLOUD_API_KEY"
}

data = {
    "model": "google/gemini-2.5-pro-tts",
    "text": "Hello, welcome to AtlasCloud text-to-speech."
}

response = requests.post(url, headers=headers, json=data)
result = response.json()

print(f"Prediction ID: {result['data']['id']}")
print(f"Status: {result['data']['status']}")

回應

{
  "code": 200,
  "data": {
    "id": "pred_abc123",
    "status": "processing",
    "model": "model-name",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

檢查狀態

輪詢 prediction 端點以檢查請求的當前狀態。

GET/api/v1/model/prediction/{prediction_id}

輪詢範例

import requests
import time

prediction_id = "pred_abc123"
url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"
headers = { "Authorization": "Bearer $ATLASCLOUD_API_KEY" }

while True:
    response = requests.get(url, headers=headers)
    result = response.json()
    status = result["data"]["status"]
    print(f"Status: {status}")

    if status in ["completed", "succeeded"]:
        output_url = result["data"]["outputs"][0]
        print(f"Output URL: {output_url}")
        break
    elif status == "failed":
        print(f"Error: {result['data'].get('error', 'Unknown')}")
        break

    time.sleep(3)

狀態值

processing請求仍在處理中。

completed生成完成，輸出可用。

succeeded生成成功，輸出可用。

failed生成失敗，請檢查 error 欄位。

完成回應

{
  "data": {
    "id": "pred_abc123",
    "status": "completed",
    "outputs": [
      "https://storage.atlascloud.ai/outputs/result.mp3"
    ],
    "metrics": {
      "predict_time": 8.3
    },
    "created_at": "2025-01-01T00:00:00Z",
    "completed_at": "2025-01-01T00:00:10Z"
  }
}

Input Schema

以下參數在請求主體中被接受。

總計: 3必填: 2選填: 1

modelstringrequired

Model name.

Default: "google/gemini-2.5-pro-tts"

google/gemini-2.5-pro-tts

textstringrequired

Text to synthesize into speech audio. Use natural-language instructions in the text for style, accent, pace, and tone control.

Default: "Welcome to Atlas Cloud — One API for All Media AI."

voicestring

Gemini prebuilt voice.

Default: "Kore"

ZephyrPuckCharonKoreFenrirLedaOrusAoedeCallirrhoeAutonoeEnceladusIapetusUmbrielAlgiebaDespinaErinomeAlgenibRasalgethiLaomedeiaAchernarAlnilamSchedarGacruxPulcherrimaAchirdZubenelgenubiVindemiatrixSadachbiaSadaltagerSulafat

範例請求主體

{
  "model": "google/gemini-2.5-pro-tts",
  "text": "Welcome to Atlas Cloud — One API for All Media AI.",
  "voice": "Kore"
}

Output Schema

API 傳回包含生成輸出 URL 的 prediction 回應。

idstring

Unique identifier for the prediction.

modelstring

Model ID used for the prediction.

statusstring

Status of the task: created, processing, completed, or failed.

outputsarray

Array of URLs to the generated audio.

created_atstring

ISO timestamp of when the request was created.

範例回應

{
  "id": "pred_abc123",
  "status": "completed",
  "model": "model-name",
  "outputs": [
    "https://storage.atlascloud.ai/outputs/result.png"
  ],
  "metrics": {
    "predict_time": 8.3
  },
  "created_at": "2025-01-01T00:00:00Z",
  "completed_at": "2025-01-01T00:00:10Z"
}

Atlas Cloud Skills

Atlas Cloud Skills 將 400+ AI 模型直接整合到您的 AI 程式碼助手中。一條命令安裝，即可用自然語言生成圖片、影片，以及與 LLM 對話。

支援的客戶端

Claude Code

OpenAI Codex

Gemini CLI

Cursor

Windsurf

VS Code

Trae

GitHub Copilot

Cline

Roo Code

Amp

Goose

Replit

40+ 支援的客戶端

安裝

npx skills add AtlasCloudAI/atlas-cloud-skills

設定 API Key

從 Atlas Cloud 控制台取得 API Key，並將其設定為環境變數。

export ATLASCLOUD_API_KEY="your-api-key-here"

功能

安裝完成後，您可以在 AI 助手中使用自然語言存取所有 Atlas Cloud 模型。

圖片生成使用 Nano Banana 2、Z-Image 等模型生成圖片。

影片創作使用 Kling、Vidu、Veo 等從文字或圖片創建影片。

LLM 對話與 Qwen、DeepSeek 及其他大型語言模型對話。

媒體上傳上傳本機檔案用於圖片編輯和圖生影片工作流程。

MCP Server

Atlas Cloud MCP Server 透過 Model Context Protocol 將您的 IDE 與 400+ AI 模型連接。支援任何相容 MCP 的客戶端。

支援的客戶端

Cursor

VS Code

Windsurf

Claude Code

OpenAI Codex

Gemini CLI

Cline

Roo Code

100+ 支援的客戶端

安裝

npx -y atlascloud-mcp

設定

將以下設定新增到您的 IDE 的 MCP 設定檔中。

{
  "mcpServers": {
    "atlascloud": {
      "command": "npx",
      "args": [
        "-y",
        "atlascloud-mcp"
      ],
      "env": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

可用工具

atlas_generate_image根據文字提示生成圖片。

atlas_generate_video從文字或圖片創建影片。

atlas_chat與大型語言模型對話。

atlas_list_models瀏覽 400+ 可用 AI 模型。

atlas_quick_generate一步式內容創建，自動選擇最佳模型。

atlas_upload_media上傳本機檔案用於 API 工作流程。

了解更多

github.com/AtlasCloudAI/mcp-server

API Schema

{
  "info": {
    "title": "AtlasCloud API",
    "version": "1.0.0",
    "description": "The AtlasCloud API."
  },
  "openapi": "3.0.0",
  "paths": {
    "/api/v1/model/generateAudio": {
      "post": {
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Input"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PredictionResponse"
                }
              }
            },
            "description": "The request status."
          }
        }
      },
      "x-api-name": "model_run"
    },
    "/api/v1/model/prediction/{request_id}": {
      "get": {
        "parameters": [
          {
            "in": "path",
            "name": "request_id",
            "required": true,
            "schema": {
              "description": "Request ID",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PredictionResponse"
                }
              }
            },
            "description": "Result of the request."
          }
        }
      },
      "x-api-name": "model_result"
    }
  },
  "components": {
    "schemas": {
      "Input": {
        "type": "object",
        "properties": {
          "model": {
            "type": "string",
            "description": "Model name.",
            "default": "google/gemini-2.5-pro-tts",
            "enum": [
              "google/gemini-2.5-pro-tts"
            ]
          },
          "text": {
            "type": "string",
            "description": "Text to synthesize into speech audio. Use natural-language instructions in the text for style, accent, pace, and tone control.",
            "default": "Welcome to Atlas Cloud — One API for All Media AI.",
            "x-ui-component": "textarea"
          },
          "voice": {
            "type": "string",
            "description": "Gemini prebuilt voice.",
            "default": "Kore",
            "enum": [
              "Zephyr",
              "Puck",
              "Charon",
              "Kore",
              "Fenrir",
              "Leda",
              "Orus",
              "Aoede",
              "Callirrhoe",
              "Autonoe",
              "Enceladus",
              "Iapetus",
              "Umbriel",
              "Algieba",
              "Despina",
              "Erinome",
              "Algenib",
              "Rasalgethi",
              "Laomedeia",
              "Achernar",
              "Alnilam",
              "Schedar",
              "Gacrux",
              "Pulcherrima",
              "Achird",
              "Zubenelgenubi",
              "Vindemiatrix",
              "Sadachbia",
              "Sadaltager",
              "Sulafat"
            ],
            "x-ui-component": "select",
            "x-enum-options": {
              "Zephyr": {
                "name": "Zephyr (Bright)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/zephyr.wav"
              },
              "Puck": {
                "name": "Puck (Upbeat)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/puck.wav"
              },
              "Charon": {
                "name": "Charon (Informative)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/charon.wav"
              },
              "Kore": {
                "name": "Kore (Firm)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/kore.wav"
              },
              "Fenrir": {
                "name": "Fenrir (Excitable)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/fenrir.wav"
              },
              "Leda": {
                "name": "Leda (Youthful)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/leda.wav"
              },
              "Orus": {
                "name": "Orus (Firm)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/orus.wav"
              },
              "Aoede": {
                "name": "Aoede (Breezy)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/aoede.wav"
              },
              "Callirrhoe": {
                "name": "Callirrhoe (Easy-going)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/callirrhoe.wav"
              },
              "Autonoe": {
                "name": "Autonoe (Bright)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/autonoe.wav"
              },
              "Enceladus": {
                "name": "Enceladus (Breathy)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/enceladus.wav"
              },
              "Iapetus": {
                "name": "Iapetus (Clear)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/iapetus.wav"
              },
              "Umbriel": {
                "name": "Umbriel (Easy-going)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/umbriel.wav"
              },
              "Algieba": {
                "name": "Algieba (Smooth)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/algieba.wav"
              },
              "Despina": {
                "name": "Despina (Smooth)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/despina.wav"
              },
              "Erinome": {
                "name": "Erinome (Clear)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/erinome.wav"
              },
              "Algenib": {
                "name": "Algenib (Gravelly)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/algenib.wav"
              },
              "Rasalgethi": {
                "name": "Rasalgethi (Informative)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/rasalgethi.wav"
              },
              "Laomedeia": {
                "name": "Laomedeia (Upbeat)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/laomedeia.wav"
              },
              "Achernar": {
                "name": "Achernar (Soft)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/achernar.wav"
              },
              "Alnilam": {
                "name": "Alnilam (Firm)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/alnilam.wav"
              },
              "Schedar": {
                "name": "Schedar (Even)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/schedar.wav"
              },
              "Gacrux": {
                "name": "Gacrux (Mature)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/gacrux.wav"
              },
              "Pulcherrima": {
                "name": "Pulcherrima (Forward)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/pulcherrima.wav"
              },
              "Achird": {
                "name": "Achird (Friendly)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/achird.wav"
              },
              "Zubenelgenubi": {
                "name": "Zubenelgenubi (Casual)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/zubenelgenubi.wav"
              },
              "Vindemiatrix": {
                "name": "Vindemiatrix (Gentle)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/vindemiatrix.wav"
              },
              "Sadachbia": {
                "name": "Sadachbia (Lively)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/sadachbia.wav"
              },
              "Sadaltager": {
                "name": "Sadaltager (Knowledgeable)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/sadaltager.wav"
              },
              "Sulafat": {
                "name": "Sulafat (Warm)",
                "example": "https://static.atlascloud.ai/model/example/gemini-tts/sulafat.wav"
              }
            }
          }
        },
        "required": [
          "model",
          "text"
        ],
        "x-order-properties": [
          "model",
          "text",
          "voice"
        ]
      },
      "PredictionResponse": {
        "type": "object",
        "properties": {
          "id": {
            "description": "Unique identifier for the prediction.",
            "type": "string"
          },
          "model": {
            "description": "Model ID used for the prediction.",
            "type": "string"
          },
          "status": {
            "description": "Status of the task: created, processing, completed, or failed.",
            "type": "string"
          },
          "outputs": {
            "description": "Array of URLs to the generated audio.",
            "items": {
              "type": "string",
              "x-format": "audio"
            },
            "type": "array"
          },
          "created_at": {
            "description": "ISO timestamp of when the request was created.",
            "format": "date-time",
            "type": "string"
          },
          "urls": {
            "description": "Object containing related API endpoints.",
            "type": "object"
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.atlascloud.ai"
    }
  ]
}

LLM 友善的提示詞範本

# google/gemini-2.5-pro-tts

> Gemini text-to-speech (Pro): studio-quality, expressive speech from text with 30 prebuilt voices and natural-language style control. Powered by gemini-2.5-pro-preview-tts.


## Overview

- **Submit endpoint (POST)**: `https://api.atlascloud.ai/api/v1/model/generateAudio` — start an async generation; returns a `prediction_id`
- **Poll endpoint (GET)**: `https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}` — poll this until the prediction finishes
- **Model ID**: `google/gemini-2.5-pro-tts`


## API Information

This model can be used via our HTTP API or more conveniently via our client libraries.
See the input and output schema below, as well as the usage examples.


### Input Schema

The API accepts the following input parameters:

- **`model`** (`string`, _required_):
  Model name.
  - Default: `"google/gemini-2.5-pro-tts"`
  - Options: "google/gemini-2.5-pro-tts"

- **`text`** (`string`, _required_):
  Text to synthesize into speech audio. Use natural-language instructions in the text for style, accent, pace, and tone control.
  - Default: `"Welcome to Atlas Cloud — One API for All Media AI."`

- **`voice`** (`string`, _optional_):
  Gemini prebuilt voice.
  - Default: `"Kore"`
  - Options: "Zephyr", "Puck", "Charon", "Kore", "Fenrir", "Leda", "Orus", "Aoede", "Callirrhoe", "Autonoe", "Enceladus", "Iapetus", "Umbriel", "Algieba", "Despina", "Erinome", "Algenib", "Rasalgethi", "Laomedeia", "Achernar", "Alnilam", "Schedar", "Gacrux", "Pulcherrima", "Achird", "Zubenelgenubi", "Vindemiatrix", "Sadachbia", "Sadaltager", "Sulafat"



**Required Parameters Example**:

```json
{
  "model": "google/gemini-2.5-pro-tts",
  "text": "Welcome to Atlas Cloud — One API for All Media AI."
}
```


**Full Example**:

```json
{
  "model": "google/gemini-2.5-pro-tts",
  "text": "Welcome to Atlas Cloud — One API for All Media AI.",
  "voice": "Kore"
}
```


### Output Schema

The API returns the following output format:


- **`id`** (`string`, _optional_):
  Unique identifier for the prediction.

- **`model`** (`string`, _optional_):
  Model ID used for the prediction.

- **`status`** (`string`, _optional_):
  Status of the task: created, processing, completed, or failed.

- **`outputs`** (`array[string]`, _optional_):
  Array of URLs to the generated audio.

- **`created_at`** (`string`, _optional_):
  ISO timestamp of when the request was created.

- **`urls`** (`object`, _optional_):
  Object containing related API endpoints.



**Example Response**:

```json
{
  "id": "",
  "model": "",
  "status": "",
  "outputs": [
    ""
  ],
  "created_at": "",
  "urls": {}
}
```


## Usage Examples

### cURL

```bash
# Step 1: Start generation (async)
curl -X POST "https://api.atlascloud.ai/api/v1/model/generateAudio" \
  -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "google/gemini-2.5-pro-tts",
  "text": "Welcome to Atlas Cloud — One API for All Media AI.",
  "voice": "Kore"
}'

# Response will contain: {"code": 200, "data": {"id": "prediction_id", "status": "processing"}}

# Step 2: Poll for result (replace {prediction_id} with the id returned above)
curl -X GET "https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}" \
  -H "Authorization: Bearer $ATLASCLOUD_API_KEY"

# Keep polling until status is "completed", "succeeded" or "failed"
# When completed, outputs will contain the generated content URL(s)
```

## Additional Resources

### Documentation

- [Model Playground](https://www.atlascloud.ai/models/google/gemini-2.5-pro-tts)

Step into the heart of the forest, where towering trees whisper with the wind and golden light filters through the leaves. Every footstep echoes with stories older than time, inviting you to slow down, breathe deeply, and rediscover the beauty hidden in silence.

載入中...

Gemini 2.5 Pro TTS

Studio-quality, expressive text-to-speech powered by Google's gemini-2.5-pro-preview-tts.

Highlights

30 prebuilt voices — Kore, Puck, Charon, Aoede, Fenrir, Leda, Orus, Zephyr, and more.
Style prompting — steer tone, pace and emotion in natural language inside text, e.g. "Say cheerfully: ..." or "Read slowly and calmly: ...".
Output is a WAV file (24 kHz PCM); billed per 1k characters.

Parameters

field	required	notes
`text`	yes	text to synthesize (may embed a style instruction), ≤10000 chars
`voice_name`	no	prebuilt voice, default `Kore`

探索類似模型

NEW

文生音訊

MiniMax Music 3.0

MiniMax Music 3.0 is MiniMax's 11.1B-parameter open-weights music model that turns a musical description and optional lyrics into a complete, fully arranged and mixed song of up to five minutes - vocals, instrumentation and production included - in a single generation, with section-tag control over the arrangement and vocal or instrumental output.

Gemini 2.5 Pro TTS API by Google

輸入

輸出

參數

程式碼範例

安裝

驗證

HTTP 標頭

提交請求

提交請求

請求主體

回應

檢查狀態

輪詢範例

狀態值

完成回應

Input Schema

範例請求主體

Output Schema

範例回應

Atlas Cloud Skills

支援的客戶端

安裝

設定 API Key

功能

MCP Server

支援的客戶端

安裝

設定

可用工具

API Schema

LLM 友善的提示詞範本

Gemini 2.5 Pro TTS

Highlights

Parameters

探索類似模型

MiniMax Music 3.0

MiniMax Lyrics Generation

Suno chirp-v4-5-all

Suno chirp-v4-5-plus

Suno chirp-auk

Suno chirp-fenix

Suno chirp-v3-5

Suno chirp-v4

Suno chirp-v5

Seed Audio 1.0

xAI TTS v1

Seed ASR 2.0

MiniMax Music 2.6

ElevenLabs v3 Text-to-Speech

xAI STT v1

一個 API，暢享全模態 AI。

輸入

輸出

參數

程式碼範例

安裝

驗證

HTTP 標頭

提交請求

提交請求

請求主體

回應

檢查狀態

輪詢範例

狀態值

完成回應

Input Schema

範例請求主體

Output Schema

範例回應

Atlas Cloud Skills

支援的客戶端

安裝

設定 API Key

功能

MCP Server

支援的客戶端

安裝

設定