创建角色 (omni character)

POST

https://api.tokenhot.ai/v1/omni/character/create

Actual API Endpoint: POST https://api.tokenhot.ai/v1/omni/character/create

创建 Gemini Omni 角色，返回 characterId，用于 gemini-omni-video 的 character_ids 字段。

Request

Authorization

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

创建成功（同步返回）

Bodyapplication/json

🟠400

🟠401

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.tokenhot.ai/v1/omni/character/create' \
--header 'Content-Type: application/json' \
--data '{
    "descriptions": "A friendly dog-head figure character",
    "image_urls": [
        "https://your-host.com/character-reference.png"
    ],
    "character_name": "DogFigure"
}'

Response Example

200 - 成功示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "characterId": "87718052b9b1466e855a64d44dc78075",
        "characterName": "DogFigure",
        "imageUrl": "https://file.aiquickdraw.com/omniCharacter/1781668437709-oiish8l9tsi.png"
    }
}

查询视频任务

创建音色 (omni audio)