Gemini Omni Audio

This page is generated from the upstream official OpenAPI documentation. Endpoints, parameters and examples match the official docs; brand and API domain are replaced with ModelFold.

Endpoint

POST /omni/audio/create

Full URL: https://ai.modelfold.online/v1/omni/audio/create

Authentication: every request must include the Authorization: Bearer <API_KEY> header.

Synchronous. Registers a voice preset and returns data.audioId immediately; no audio file is generated. Pass audioId in audio_ids of the video and character endpoints.

Returns data.audioId. Pass it in audio_ids of gemini-omni-video, google/gemini-omni-flash-1-1 and gemini-omni-character.

TIP

This endpoint is free.

Related Resources

• Model Marketplace — Explore all available models and capabilities
• Common API — Check account credits and usage

Request Parameters

Body (application/json)

Parameter	Type	Required	Description
audio_id	string	Yes	Enum voice ID, used to select a preset voice character. achernar - female, soft, high pitch achird - male, friendly, mid pitch algenib - male, raspy, low pitch algieba - male, easygoing, mid-low pitch alnilam - male, steady, mid-low pitch aoede - female, brisk, mid pitch autonoe - female, bright, mid pitch callirrhoe - female, easygoing, mid pitch charon - male, intellectual, low pitch despina - female, smooth, mid pitch enceladus - male, breathy, low pitch erinome - female, clear, mid pitch fenrir - male, lively, younger pitch gacrux - female, mature, mid pitch iapetus - male, clear, mid-low pitch kore - female, capable, mid pitch laomedeia - female, cheerful, mid-high pitch leda - female, young, mid-high pitch orus - male, steady, mid-low pitch puck - male, cheerful, mid pitch pulcherrima - genderless, forward, mid-high pitch rasalgethi - male, intellectual, mid pitch sadachbia - male, vivid, low pitch sadaltager - male, knowledgeable, mid pitch schedar - male, smooth, mid-low pitch sulafat - female, warm, mid pitch umbriel - male, smooth, low pitch vindemiatrix - female, gentle, mid pitch zephyr - female, bright, mid-high pitch zubenelgenubi - male, casual, mid-low pitch 示例：achernar。
name	string	Yes	Voice name. Maximum length: 210 characters.
voice_description	string	No	Voice characteristic description used to define timbre, style, speaking rate, emotion, and other traits. Maximum length: 20000 characters.
example_dialogue	string	No	Example dialogue, such as "Hello, I am Adam". Maximum length: 120 characters.

Request Example

curl -X POST "https://ai.modelfold.online/v1/omni/audio/create" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "audio_id": "achernar",
  "name": "achernar Narrator",
  "voice_description": "A calm, clear, and friendly male voice suitable for tech explainers and daily conversation.",
  "example_dialogue": "Hello, I am achernar"
}'

{
  "audio_id": "achernar",
  "name": "achernar Narrator",
  "voice_description": "A calm, clear, and friendly male voice suitable for tech explainers and daily conversation.",
  "example_dialogue": "Hello, I am achernar"
}

Response

200 — Request successful

参数	类型	必填	说明
code	integer	否	Status code of the request. The HTTP status is 200 even when the request fails, so always check this field: 200 means success; any other value means the request failed and msg describes the reason. Common values: 401 invalid or missing API key; 402 insufficient credits; 429 rate limit exceeded; 422 or 500 the request could not be processed (read msg and check your parameters before retrying).
data	object	否	—
data.audioId	string	否	—
data.name	string	否	—
msg	string	否	—

{
  "code": 200,
  "msg": "success",
  "data": {
    "audioId": "a8f1c2d3e4f5...",
    "name": "gentle female voice"
  }
}