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

gemini-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-pro-preview-tts:generateContent:
post:
summary: gemini-tts chuyển văn bản thành giọng nói
deprecated: false
description: >-
Vui lòng cung cấp nội dung tài liệu cần dịch. Tôi không thể truy cập
trực tiếp nội dung từ URL đã cung cấp.
operationId: gemini_v1beta_2_5_pro_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: Loại nội dung của phần thân yêu cầu, thường 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:
text:
type: string
description: Nội dung văn bản để tổng hợp thành giọng nói
description: Phần văn bản
x-apifox-orders:
- text
x-apidog-orders:
- text
description: Các phần nội dung; TTS sử dụng văn bản
description: Nội dung một lượt
x-apifox-orders:
- parts
x-apidog-orders:
- parts
description: >-
Nội dung cuộc trò chuyện; cung cấp văn bản để đọc trong
parts.text
generationConfig:
type: object
required:
- responseModalities
- speechConfig
properties:
responseModalities:
type: array
items:
type: string
description: Tên phương thức, thường là AUDIO
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; chỉ định tên giọng nói định sẵn
x-apifox-orders:
- prebuiltVoiceConfig
x-apidog-orders:
- prebuiltVoiceConfig
description: Cấu hình tổng hợp giọng nói
x-apifox-orders:
- voiceConfig
x-apidog-orders:
- voiceConfig
description: >-
Cấu hình tạo; phải bao gồm 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: PostV1betaModelsGemini25ProPreviewTtsGenerateContentRequest
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
Pro Preview TTS
x-apifox-orders:
- contents
- generationConfig
x-apidog-orders:
- contents
- generationConfig
examples:
gemini_tts_single:
value:
contents:
- parts:
- text: Chúc bạn một ngày thật tuyệt vời!
generationConfig:
responseModalities:
- ÂM THANH
speechConfig:
voiceConfig:
prebuiltVoiceConfig:
voiceName: Kore
summary: gemini_tts_single
description: gemini-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:
candidates:
- content:
parts:
- inlineData:
data: AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA...
mimeType: audio/L16;codec=pcm;rate=24000
role: mô hình
finishReason: DỪNG LẠI
index: 0
safetyRatings: []
modelVersion: gemini-2.5-pro-preview-tts
promptFeedback:
safetyRatings: []
responseId: nXxoaf7mPM6j_uMPyICzkQo
usageMetadata:
candidatesTokenCount: 51
promptTokenCount: 9
promptTokensDetails:
- modality: Vui lòng cung cấp nội dung tài liệu cần dịch.
tokenCount: 9
thoughtsTokenCount: 0
totalTokenCount: 60
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-45208844-run
components:
schemas: {}
securitySchemes: {}
servers:
- url: https://api.openaihub.net
description: Prod Env
security: []