Gemini Omni Character 生角色

本页由 ModelFold 文档站根据上游官方 OpenAPI 文档同步生成。接口路径、参数、示例与官方保持一致；品牌与 API 域名已替换为 ModelFold。

接口

POST /omni/character/create

完整 URL: https://ai.modelfold.online/v1/omni/character/create

鉴权：所有请求都需要 Authorization: Bearer <API_KEY> 请求头。

• image_urls 支持 1–2 张（索引 0 为肖像，索引 1 为可选全身图），单张不超过 20MB。
• audio_ids 需来自 gemini-omni-audio 接口

创建任务

调用该接口可创建一个新的角色

TIP

本接口免费。

相关资源

• 模型市场 — 浏览全部可用模型与能力
• 通用 API — 查看账户积分与调用情况

请求参数

请求体 (application/json)

参数	类型	必填	说明
descriptions	string	是	角色描述，用于说明角色的外观、身份、风格、服饰或性格设定。 示例：一个银白短发、身穿未来风机能夹克的年轻女性角色，冷静、敏捷，具有赛博朋克气质。。
image_urls	array<string>	是	角色参考图片 URL 数组。支持最多 2 张图片。索引 0 为头像图片，索引 1 为全身图片。全身图片为可选，但如果提供，则索引 0 处必须存在头像图片。 图片限制： - 每张图片大小不得超过 20MB - 请使用可公开访问的图片 URL
audio_ids	array<string>	否	由 gemini-omni-audio 接口生成的音频 ID 数组。可用于为角色补充声音特征、语气或人设参考。
character_name	string	否	角色名称

请求示例

curl -X POST "https://ai.modelfold.online/v1/omni/character/create" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "descriptions": "一个银白短发、身穿未来风机能夹克的年轻女性角色，冷静、敏捷，具有赛博朋克气质。",
  "image_urls": [
    "https://example.com/assets/character-reference.png"
  ],
  "audio_ids": [
    "audio_01hx8p0demo"
  ],
  "character_name": "珍妮"
}'

{
  "descriptions": "一个银白短发、身穿未来风机能夹克的年轻女性角色，冷静、敏捷，具有赛博朋克气质。",
  "image_urls": [
    "https://example.com/assets/character-reference.png"
  ],
  "audio_ids": [
    "audio_01hx8p0demo"
  ],
  "character_name": "珍妮"
}

响应

200 — 请求成功

参数	类型	必填	说明
code	integer	否	请求状态码。请求失败时 HTTP 状态仍为 200，请始终以本字段判断：200 表示成功，其他值均表示失败，原因见 msg。常见值：401 API key 无效或缺失；402 积分不足；429 超出频率限制；422 或 500 请求未能处理（请先查看 msg、检查参数，再决定是否重试）。
data	object	否	—
data.characterName	string	否	—
data.imageUrl	string	否	—
data.characterId	string	否	—
data.bodyImageUrl	string	否	—
msg	string	否	—

{
  "code": 200,
  "msg": "success",
  "data": {
    "characterId": "b09dbf56...",
    "characterName": "可爱角色",
    "imageUrl": "https://xx.com/profile.png",
    "bodyImageUrl": "https://xx.com/body.png"
  }
}