すべてのプロダクト
Search

このプロダクト

    Intelligent Media Services:API リファレンス

    ドキュメントセンター

    Intelligent Media Services:API リファレンス

    最終更新日:Aug 28, 2026

    リアルタイム対話型 AI は、トークン生成、メッセージング、およびエージェントインスタンス管理のために、次の API 操作を提供します。

    getRtcAuthToken

    リアルタイムコミュニケーション (RTC) 通話用のトークンを生成します。

    使用上の注意

    • リクエストプロトコル：HTTP または HTTPS

    • リクエストパス：/api/v2/aiagent/getRtcAuthToken

    • 認可の要否：はい

    • リクエストメソッド：POST

    • Content-Type：JSON

    • 必須の設定：biz.live_mic.app_id および biz.live_mic.app_key

    リクエストパラメーター

    Name

    データ型

    必須

    Example

    Description

    user_id

    String

    Yes

    userid****

    ユーザー ID。

    channel_id

    String

    No

    channelid****

    チャネル ID。

    説明

    このパラメーターを指定しない場合、サーバーは 32 文字の UUID (ハイフンなし) を生成します。

    レスポンスパラメーター

    Name

    データ型

    Example

    Description

    code

    整数

    200

    返される HTTP ステータスコード。

    rtc_auth_token

    String

    eyJnc2xiIjp****

    RTC トークン。

    channel_id

    String

    channelid****

    使用されるチャネル ID。

    timestamp

    Long

    1700000000

    有効期限。単位：秒。デフォルトでは、トークンの有効期間は 24 時間です。

    例

    リクエスト例

    {
    "user_id": "usertid****",
    "channel_id":"channelid****"
}

    成功レスポンス例

    {
    "code": 200,
    "rtc_auth_token": "eyJnc2xiIjp****",
    "channel_id": "channelid****",
    "timestamp": 1700000000
}

    generateMessageChatToken

    インタラクティブメッセージングに必要なトークンを生成します。

    使用上の注意

    • リクエストプロトコル：HTTP または HTTPS

    • リクエストパス：/api/v2/aiagent/generateMessageChatToken

    • 認可の要否：はい

    • リクエストメソッド：POST

    • Content-Type：JSON

    • 必須の設定：biz.openapi.access.key および biz.openapi.access.secret

    リクエストパラメーター

    Name

    データ型

    必須

    Example

    Description

    ai_agent_id

    String

    Yes

    19de81b3b3d94abda22****

    エージェント ID。

    user_id

    String

    Yes

    userid****

    ユーザー ID。

    最大 64 文字で、英字、数字、アンダースコア (_) のみを使用できます。

    role

    String

    No

    admin

    ロール。このパラメーターを admin に設定すると、ユーザーは管理関連の API 操作を呼び出せます。デフォルトでは、このパラメーターは空です。

    expire

    整数

    No

    3600

    タイムアウト期間。単位：秒。デフォルト値：3600。

    region

    String

    Yes

    cn-shanghai

    エージェントが配置されているリージョン。詳細については、「エンドポイント」をご参照ください。

    レスポンスパラメーター

    Name

    データ型

    Example

    Description

    code

    整数

    200

    返される HTTP ステータスコード。

    message

    String

    success

    結果メッセージ。

    request_id

    String

    7B117AF5-2A16-412C-B127-****

    リクエスト ID。

    app_id

    String

    ****

    アプリケーション ID。

    token

    String

    acet****

    生成されたトークン。

    user_id

    String

    userid****

    ユーザー ID。

    nonce

    String

    AK-****

    トークンの生成に使用されるノンス。

    role

    String

    admin

    トークンの生成に使用されるロール。

    timestamp

    Long

    1700000000

    有効期限。単位：秒。有効期限 = 現在時刻 + 有効期間。

    app_sign

    String

    H4sIAAAAAAAE****

    アプリケーション署名。

    例

    リクエスト例

    {
    "user_id": "userid****",
    "ai_agent_id":"19de81b3b3d94abda22******",
    "role":"admin",
    "expire":1800,
    "region":"cn-shanghai"
}

    成功レスポンス例

    {
    "code": 200,
    "message": "success",
    "role": "admin",
    "user_id": "userid****",
    "app_id": "****",
    "nonce": "AK-****",
    "request_id": "7B117AF5-2A16-412C-B127-****",
    "token": "acet****",
    "timestamp": 1700000000,
    "app_sign": "H4sIAAAAAAAE****",
}

    describeAIAgentInstance

    エージェントインスタンスの詳細を照会します。

    使用上の注意

    • リクエストプロトコル：HTTP または HTTPS

    • リクエストパス：/api/v2/aiagent/describeAIAgentInstance

    • 認可の要否：はい

    • リクエストメソッド：POST

    • Content-Type：JSON

    • 必須の設定：biz.openapi.access.key および biz.openapi.access.secret

    リクエストパラメーター

    Name

    データ型

    必須

    Example

    Description

    user_id

    String

    Yes

    userid****

    ユーザー ID。

    ai_agent_instance_id

    String

    Yes

    39f8e0bc005e4f309379701645f4****

    エージェントインスタンスの ID。

    region

    String

    Yes

    cn-shanghai

    エージェントが配置されているリージョン。詳細については、「エンドポイント」をご参照ください。

    レスポンスパラメーター

    Name

    データ型

    Example

    Description

    code

    整数

    200

    返される HTTP ステータスコード。

    message

    String

    success

    結果メッセージ。

    request_id

    String

    7B117AF5-2A16-412C-B127-****

    リクエスト ID。

    call_log_url

    String

    https://example.com/call_logs/12345

    通話ログの URL。

    runtime_config

    String

    {"VoiceChat":{"AgentUserId":"voice_agent_001","ChannelId":"voice_channel_001","AuthToken":"your_voice_chat_auth_token"}}

    エージェントのランタイム設定です。

    詳細については、「AIAgentRuntimeConfig」をご参照ください。

    status

    String

    Finished

    エージェントのステータス。

    有効な値：

    • Finished

    • Executing

    template_config

    String

    {"VoiceChat": {"AppId": "your_voice_chat_app_id"}}

    エージェント通話を設定するためのテンプレート設定。詳細については、「AIAgentTemplateConfig」をご参照ください。

    user_data

    String

    {"Email":"johndoe@example.com","Preferences":{"Language":"en"}}

    カスタムユーザーデータ。

    agent_config

    String

    {"xxx":"xx"}

    エージェントテンプレート設定とコンソール設定をマージした設定です。空の場合、デフォルトのコンソール設定が使用されます。詳細については、「AIAgentConfig」をご参照ください。

    例

    リクエスト例

    {
    "user_id":"userid****",
    "ai_agent_instance_id": "39f8e0bc005e4f309379701645f4****",
    "region":"cn-shanghai"
}

    成功レスポンス例

    {
    "code": 200,
    "message": "success",
    "request_id": "7B117AF5-2A16-412C-B127-****",
    "agent_config": "{\"VoiceChat\": {\"AppId\": \"your_voice_chat_app_id\"}}",
    "template_config": "{\"VoiceChat\": {\"AppId\": \"your_voice_chat_app_id\"}}",
    "call_log_url": "https://example.com/call_logs/12345",
    "user_data": "{\"user_id\": \"test\"}",
    "runtime_config": "{\"VoiceChat\":{\"AgentUserId\":\"voice_agent_001\",\"ChannelId\":\"voice_channel_001\",\"AuthToken\":\"your_voice_chat_auth_token\"}}",
    "status": "Finished"
}