Get S2S Time Status
curl --request GET \
--url https://secureai.hiperai.ai/api/external/speech/s2s/status \
--header 'Authorization: Bearer <token>'import requests
url = "https://secureai.hiperai.ai/api/external/speech/s2s/status"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://secureai.hiperai.ai/api/external/speech/s2s/status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"remaining_minutes": 38.2896,
"total_minutes": 45,
"used_minutes": 6.7104,
"has_time_remaining": true,
"next_renewal_date": "2025-12-01T12:55:35.721Z",
"non_renewable": false,
"request_id": "a8c307b4-c0c9-4b30-98db-5aced06c1cfe"
}{
"success": false,
"error": "Invalid API key",
"message": "The provided API key is invalid or has been revoked",
"request_id": "req-abc123"
}{
"success": false,
"error": "Invalid API key",
"message": "The provided API key is invalid or has been revoked",
"request_id": "req-abc123"
}{
"success": false,
"error": "Invalid API key",
"message": "The provided API key is invalid or has been revoked",
"request_id": "req-abc123"
}モデル & AI 生成
S2S 時間ステータスの取得
Retrieve the current Speech-to-Speech (S2S) time status for the billing user, including remaining time, total monthly limit, used time, and renewal information.
S2S Time Quotas:
- Quotas are based on the user’s license tier
- Time resets monthly based on the license assignment date
- Non-renewable trial licenses don’t auto-reset
GET
/
speech
/
s2s
/
status
Get S2S Time Status
curl --request GET \
--url https://secureai.hiperai.ai/api/external/speech/s2s/status \
--header 'Authorization: Bearer <token>'import requests
url = "https://secureai.hiperai.ai/api/external/speech/s2s/status"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://secureai.hiperai.ai/api/external/speech/s2s/status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"remaining_minutes": 38.2896,
"total_minutes": 45,
"used_minutes": 6.7104,
"has_time_remaining": true,
"next_renewal_date": "2025-12-01T12:55:35.721Z",
"non_renewable": false,
"request_id": "a8c307b4-c0c9-4b30-98db-5aced06c1cfe"
}{
"success": false,
"error": "Invalid API key",
"message": "The provided API key is invalid or has been revoked",
"request_id": "req-abc123"
}{
"success": false,
"error": "Invalid API key",
"message": "The provided API key is invalid or has been revoked",
"request_id": "req-abc123"
}{
"success": false,
"error": "Invalid API key",
"message": "The provided API key is invalid or has been revoked",
"request_id": "req-abc123"
}S2S 時間ステータスを取得
請求ユーザーの現在の Speech-to-Speech (S2S) 時間ステータスを取得します。エンドポイント
GET /speech/s2s/status
説明
残り時間、月間制限合計、使用時間、更新情報など、請求ユーザーの現在の Speech-to-Speech (S2S) 時間ステータスを取得します。S2S 時間の割り当て
- クォータはユーザーのライセンス層に基づいています
- 時間はライセンスの割り当て日に基づいて毎月リセットされます
- 更新不可の試用版ライセンスは自動リセットされません
認証
必須: API キーAuthorization: Bearer sk-your-api-key-here
クエリパラメータ
| パラメータ | タイプ | 必須 | 説明 |
|---|---|---|---|
user_id | 文字列 | いいえ | ステータスを確認するユーザー ID (デフォルトは API キー所有者) |
リクエストの例
curl -X GET "https://{customer.name}.hiperai.ai/api/external/speech/s2s/status?user_id=60a7c8f5e8b4f5001f7a8c23" \
-H "Authorization: Bearer sk-your-api-key-here"
JavaScript/Node.js
const response = await fetch('https://{customer.name}.hiperai.ai/api/external/speech/s2s/status?user_id=60a7c8f5e8b4f5001f7a8c23', {
method: 'GET',
headers: {
'Authorization': 'Bearer sk-your-api-key-here'
}
});
const data = await response.json();
console.log('Remaining minutes:', data.remaining_minutes);
console.log('Total minutes:', data.total_minutes);
console.log('Used minutes:', data.used_minutes);
パイソン
import requests
url = "https://{customer.name}.hiperai.ai/api/external/speech/s2s/status"
headers = {
"Authorization": "Bearer sk-your-api-key-here"
}
params = {
"user_id": "60a7c8f5e8b4f5001f7a8c23"
}
response = requests.get(url, headers=headers, params=params)
result = response.json()
print('Remaining minutes:', result['remaining_minutes'])
print('Total minutes:', result['total_minutes'])
print('Used minutes:', result['used_minutes'])
応答
成功の応答 (200)
{
"success": true,
"remaining_minutes": 38.2896,
"total_minutes": 45,
"used_minutes": 6.7104,
"has_time_remaining": true,
"next_renewal_date": "2025-12-01T12:55:35.721Z",
"non_renewable": false,
"request_id": "a8c307b4-c0c9-4b30-98db-5aced06c1cfe"
}
応答フィールド
| フィールド | タイプ | 説明 |
|---|---|---|
success | ブール値 | リクエストが成功した場合は常に true |
remaining_minutes | 番号 | 残りの S2S 時間 (分) |
total_minutes | 番号 | S2S の月間合計時間制限 |
used_minutes | 番号 | 今月の S2S 使用時間 |
has_time_remaining | ブール値 | ユーザーに S2S 時間が残っているかどうか |
next_renewal_date | 文字列|null | S2S 時間割り当てがいつリセットされるか (更新不可のライセンスの場合は無効) |
non_renewable | ブール値 | これが更新不可の試用版ライセンスであるかどうか |
request_id | 文字列 | 追跡用のリクエスト ID |
エラー応答
400 不正なリクエスト
{
"success": false,
"error": "Invalid user_id",
"message": "The specified user_id is invalid"
}
401 不正
{
"success": false,
"error": "Invalid API key",
"message": "The provided API key is invalid or has been revoked"
}
404 見つかりません
{
"success": false,
"error": "User not found",
"message": "The specified user_id does not exist"
}
500 内部サーバーエラー
{
"success": false,
"error": "Internal server error",
"message": "An unexpected error occurred"
}
注意事項
- S2S セッションを開始する前にこのエンドポイントをチェックして、十分な時間が利用可能であることを確認してください
user_idパラメータを使用すると、別のユーザーのステータスを確認できます (デフォルトは API キー所有者)- 時間割り当てはユーザーのライセンス層に基づきます
- 更新不可の試用版ライセンスには
non_renewable: trueおよびnext_renewal_date: nullが含まれます
承認
API key authentication using Bearer token format.
Example: Authorization: Bearer sk-your-api-key-here
クエリパラメータ
Optional user ID to check status for (defaults to API key owner)
例:
"60a7c8f5e8b4f5001f7a8c23"
レスポンス
S2S time status
例:
true
Remaining S2S time in minutes
例:
38.2896
Total monthly S2S time limit
例:
45
Used S2S time this month
例:
6.7104
Whether user has any remaining S2S time
例:
true
When the S2S time quota will reset (null for non-renewable licenses)
例:
"2025-12-01T12:55:35.721Z"
Whether this is a non-renewable trial license
例:
false
Request ID for tracking
例:
"a8c307b4-c0c9-4b30-98db-5aced06c1cfe"