Bỏ qua để đến nội dung

TTS chuyển văn bản thành giọng nói

Xem Markdownllms.txt

API origin: https://api.openaihub.net. Chọn đúng nhóm API và model. Thông số dưới đây là bản tham chiếu kỹ thuật; chưa phải kết quả kiểm thử từng endpoint bằng tài khoản của bạn.

openapi: 3.0.1
info:
title: ''
description: ''
version: 1.0.0
paths:
/v1beta/models/gemini-2.5-flash-preview-tts:generateContent:
post:
summary: TTS chuyển văn bản thành giọng nói
deprecated: false
description: >-
Tài liệu chính thức:
https://ai.google.dev/gemini-api/docs/image-generation?hl=zh-cn#gemini-image-editing
operationId: gemini_v1beta_2_5_flash_preview_tts_generate_content
tags:
- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/Gemini/Định dạng gốc
- Gemini v1beta
parameters:
- name: key
in: query
description: 'Khóa API (cũng hỗ trợ Authorization: Bearer)'
required: true
example: '{{YOUR_API_KEY}}'
schema:
type: string
- name: Content-Type
in: header
description: >-
Kiểu nội dung của phần thân yêu cầu, được cố định là
application/json
required: true
example: application/json
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
required:
- contents
- generationConfig
properties:
contents:
type: array
items:
type: object
properties:
parts:
type: array
items:
type: object
properties:
inline_data:
type: object
required:
- mime_type
- data
properties:
data:
type: string
description: >-
Dữ liệu phương tiện được mã hóa Base64
(không có tiền tố data:)
mime_type:
type: string
description: >-
Loại MIME của phương tiện, ví dụ: audio/wav,
audio/mpeg
description: >-
Dữ liệu nhị phân nội tuyến (ví dụ: âm thanh tham
chiếu); không bắt buộc đối với TTS thuần túy
x-apifox-orders:
- data
- mime_type
x-apidog-orders:
- data
- mime_type
text:
type: string
description: Nội dung văn bản để tổng hợp thành giọng nói
description: >-
Dịch tài liệu kỹ thuật này sang tiếng Việt. Giữ
nguyên Markdown, mã, định danh, URL, đường dẫn, phần
giữ chỗ, cấu trúc JSON và định dạng. Chỉ trả về văn
bản đã dịch và không để lại bất kỳ ký tự Hán nào.
Một phần duy nhất; sử dụng văn bản và/hoặc
inline_data
x-apifox-orders:
- inline_data
- text
x-apidog-orders:
- inline_data
- text
description: >-
Các phần nội dung; TTS chủ yếu sử dụng văn bản; có thể
bao gồm âm thanh tham chiếu `inline_data` nếu hệ thống
nguồn hỗ trợ
description: Nội dung một lượt (vai trò mặc định là người dùng)
x-apifox-orders:
- parts
x-apidog-orders:
- parts
description: >-
Nội dung cuộc trò chuyện; TTS thường cần một tin nhắn của
người dùng chứa văn bản để đọc thành từng phần
generationConfig:
type: object
required:
- responseModalities
properties:
responseModalities:
type: array
items:
type: string
description: >-
Tên phương thức, thường là AUDIO; có thể kết hợp với
TEXT, v.v. tùy theo mô hình
description: >-
Các phương thức phản hồi; đối với TTS, hãy sử dụng
["AUDIO"]
speechConfig:
type: object
required:
- voiceConfig
properties:
voiceConfig:
type: object
required:
- prebuiltVoiceConfig
properties:
prebuiltVoiceConfig:
type: object
required:
- voiceName
properties:
voiceName:
type: string
description: >-
Tên giọng nói cài sẵn, ví dụ: Kore, Puck,
Charon, Fenrir, Aoede
description: >-
Vui lòng cung cấp nội dung tài liệu kỹ thuật cần
dịch.
x-apifox-orders:
- voiceName
x-apidog-orders:
- voiceName
description: Cấu hình giọng nói
x-apifox-orders:
- prebuiltVoiceConfig
x-apidog-orders:
- prebuiltVoiceConfig
description: >-
Cấu hình tổng hợp giọng nói; các tùy chọn về giọng đọc
và cách phát âm
x-apifox-orders:
- voiceConfig
x-apidog-orders:
- voiceConfig
description: >-
Cấu hình tạo sinh; TTS phải khai báo phương thức AUDIO và
cấu hình giọng nói
x-apifox-orders:
- responseModalities
- speechConfig
x-apidog-orders:
- responseModalities
- speechConfig
refName: PostV1betaModelsGemini25FlashPreviewTtsGenerateContentRequest
description: >-
Nội dung yêu cầu chuyển văn bản thành giọng nói của Gemini 2.5
Flash Preview TTS
x-apifox-orders:
- contents
- generationConfig
x-apidog-orders:
- contents
- generationConfig
examples:
gemini_2_5_flash_preview_tts:
value:
contents:
- parts:
- text: Nói ra,tôi là ai,ai là tôi
generationConfig:
responseModalities:
- ÂM THANH
speechConfig:
voiceConfig:
prebuiltVoiceConfig:
voiceName: Kore
model: gemini-2.5-flash-preview-tts
summary: gemini_2_5_flash_preview_tts
description: TTS chuyển văn bản thành giọng nói
responses:
'200':
description: ''
content:
application/json:
schema:
type: object
x-apidog-orders: []
examples:
example:
summary: example
value:
id: resp_example
object: phản hồi
status: completed
headers: {}
x-apidog-name: ''
'400':
description: Yêu cầu không hợp lệ hoặc xác thực thất bại
content:
application/json:
schema:
type: object
required:
- error
properties:
error:
type: object
required:
- message
- type
properties:
message:
type: string
description: Thông báo lỗi (thường kết thúc bằng mã yêu cầu)
type:
type: string
description: Loại lỗi; các lỗi cổng cục bộ thường là new_api_error
examples:
- new_api_error
x-apifox-orders:
- message
- type
x-apidog-orders:
- message
- type
refName: NewApiError
x-apifox-orders:
- error
x-apidog-orders:
- error
examples:
example:
summary: example
value:
error:
message: >-
Yêu cầu không hợp lệ (mã yêu cầu:
20260805120000123456789AbCdEfGh)
type: new_api_error
headers: {}
x-apidog-name: Yêu cầu không hợp lệ hoặc xác thực thất bại
'401':
description: Khóa API bị thiếu hoặc không hợp lệ
content:
application/json:
schema:
type: object
required:
- error
properties:
error:
type: object
required:
- message
- type
properties:
message:
type: string
description: Thông báo lỗi (thường kết thúc bằng mã yêu cầu)
type:
type: string
description: Loại lỗi; các lỗi cổng cục bộ thường là new_api_error
examples:
- new_api_error
x-apifox-orders:
- message
- type
x-apidog-orders:
- message
- type
refName: NewApiError
x-apifox-orders:
- error
x-apidog-orders:
- error
examples:
example:
summary: example
value:
error:
message: >-
Mã thông báo không hợp lệ (request id:
20260805120000123456789AbCdEfGh)
type: new_api_error
headers: {}
x-apidog-name: Khóa API bị thiếu hoặc không hợp lệ
security: []
x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/Gemini/Định dạng gốc
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208847-run
components:
schemas: {}
securitySchemes: {}
servers:
- url: https://api.openaihub.net
description: Prod Env
security: []