Claim a fresh business session on an active lease

POST

/v1/realtime-leases/{id}/sessions

Authoritative authentication, entitlement, owner, expiry, and binding checks are performed by session-orchestrator. Rejected or drifted leases are never mapped to the old per-session transport.

请求参数

Path 参数

Body 参数application/json必填

示例

{
    "binding": {
        "clientInstanceID": "voice-device-001",
        "endpointHost": "api.onesay.io",
        "endpointRegion": "cn-hongkong",
        "networkFingerprint": "sha256:network-safe-fingerprint",
        "proxyFingerprint": "sha256:proxy-safe-fingerprint",
        "configVersion": "realtime-lease-v1"
    },
    "session": {
        "workflow": "dictation",
        "capabilitySnapshot": {
            "allowsRealtime": true,
            "allowsRefine": true,
            "allowsInsert": true
        },
        "providerRoute": {
            "asrProvider": "aliyun.realtime.asr",
            "refineProvider": "aliyun.refine"
        },
        "recognitionPreferences": {
            "languageVariants": {
                "english": "en-US",
                "chinese": "zh-CN",
                "spanish": "es-MX",
                "french": "fr-FR",
                "portuguese": "pt-PT"
            }
        },
        "speechProcessingPreferences": {
            "autoPunctuation": true,
            "removeFillers": false,
            "autoFormattingEnabled": true
        },
        "expressionContext": {
            "personalStyle": {
                "preference": "off",
                "customInstruction": "",
                "styleSamples": ""
            },
            "fallbackTone": "natural"
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/realtime-leases//sessions' \
--header 'Content-Type: application/json' \
--data '{
    "binding": {
        "clientInstanceID": "voice-device-001",
        "endpointHost": "api.onesay.io",
        "endpointRegion": "cn-hongkong",
        "networkFingerprint": "sha256:network-safe-fingerprint",
        "proxyFingerprint": "sha256:proxy-safe-fingerprint",
        "configVersion": "realtime-lease-v1"
    },
    "session": {
        "workflow": "dictation",
        "capabilitySnapshot": {
            "allowsRealtime": true,
            "allowsRefine": true,
            "allowsInsert": true
        },
        "providerRoute": {
            "asrProvider": "aliyun.realtime.asr",
            "refineProvider": "aliyun.refine"
        },
        "recognitionPreferences": {
            "languageVariants": {
                "english": "en-US",
                "chinese": "zh-CN",
                "spanish": "es-MX",
                "french": "fr-FR",
                "portuguese": "pt-PT"
            }
        },
        "speechProcessingPreferences": {
            "autoPunctuation": true,
            "removeFillers": false,
            "autoFormattingEnabled": true
        },
        "expressionContext": {
            "personalStyle": {
                "preference": "off",
                "customInstruction": "",
                "styleSamples": ""
            },
            "fallbackTone": "natural"
        }
    }
}'

返回响应

🟢201成功

application/json

Fresh business session created on the lease.

Bodyapplication/json

示例

{
    "endpoint": "POST /v1/realtime-leases/{id}/sessions",
    "lease": {
        "id": "22222222-2222-4222-8222-222222222222",
        "userID": "local-user-001",
        "binding": {
            "clientInstanceID": "voice-device-001",
            "endpointHost": "api.onesay.io",
            "endpointRegion": "cn-hongkong",
            "networkFingerprint": "sha256:network-safe-fingerprint",
            "proxyFingerprint": "sha256:proxy-safe-fingerprint",
            "configVersion": "realtime-lease-v1"
        },
        "status": "active",
        "createdAt": "2026-07-10T12:00:00Z",
        "lastUsedAt": "2026-07-10T12:00:00Z",
        "expiresAt": "2026-07-10T12:02:00Z"
    },
    "session": {
        "id": "11111111-1111-1111-1111-111111111111",
        "userID": "local-user-001",
        "workflow": "dictation",
        "status": "created",
        "capabilitySnapshot": {
            "allowsRealtime": true,
            "allowsRefine": true,
            "allowsInsert": true
        },
        "providerRoute": {
            "asrProvider": "aliyun.realtime.asr",
            "refineProvider": "aliyun.refine"
        },
        "createdAt": "2026-04-01T16:19:40Z",
        "startedAt": "2026-04-01T16:19:45Z",
        "endedAt": "2026-04-01T16:20:00Z",
        "recordingDurationSeconds": 18.4,
        "partialTranscript": "hey can you help me rewrite",
        "finalTranscript": "hey can you help me rewrite this note",
        "refinedText": "Could you help me rewrite this note?",
        "billingStatus": {
            "state": "quota_consumed",
            "quotaSource": "pro",
            "consumedSeconds": 18.4,
            "updatedAt": "2026-04-01T16:20:00Z"
        },
        "privacyFlags": {
            "values": [
                "audit_trail_recorded"
            ]
        }
    },
    "reused": true
}

🟠401没有权限

🟠403禁止访问

🟠409

🟠410记录不存在

修改于 2026-08-26 04:04:36

Revoke a realtime lease

Validate a session against an active realtime lease