文章总结: 本文档详细介绍了AceDataCloud平台查询API剩余额度的完整流程,包括获取申请ID、创建永久有效的账户令牌,以及通过GET请求查询剩余额度的具体API接口格式。文档提供了curl命令示例及Python、Node.js、Java、PHP等多种编程语言的实现代码,并说明响应结果中remaining_amount字段即为剩余额度值。 综合评分: 78 文章分类: 技术标准,解决方案
Ace Data Cloud 平台剩余额度查询
进击的Coder
2026年6月23日 23:54 江苏
在小说阅读器读本章
去阅读
由于 Ace Data Cloud 平台的大多数 API 都是按额度收费的,因此在对接 API 后,为了防止 API 额度突然耗尽而给贵平台造成业务中断或损失,Ace Data Cloud 平台开放了接口用于查询剩余额度。通过这一接口,贵平台可以在检测到额度不足时及时进行充值,确保业务的连续性。
本文档将介绍如何对接查询剩余额度的接口。
查看申请 ID
首先,需要了解 Ace Data Cloud 平台的每个 API 服务都对应一个“申请”实例。每个“申请”实例都有自己的 ID、密钥、剩余额度等信息,您可以在 https://platform.acedata.cloud/console/applications ,或者识别下方二维码:
然后查看您所有的申请列表。
接下来,如果要查询某个申请的剩余额度,需要将对应的申请 ID 复制下来。
例如,假设您想查询“Midjourney API”的剩余额度,您可以将该 ID 复制并记录为application_id。
创建账户令牌
Ace Data Cloud 平台提供了「账户令牌」(旧称「平台令牌」)机制,方便开发者通过 API 查询 Ace Data Cloud 账户信息,如订单列表、申请列表、分销信息、调用记录等。这其中自然也包括查询剩余额度的功能。该令牌的功能类似于登录 Ace Data Cloud 平台后的用户 token,登录后可以基于它查看账户下的申请列表、订单列表、调用记录等信息。但与用户 token 不同的是,账户令牌的有效期是永久的,而用户 token 则会在一段时间后失效(失效后需要重新登录)。
因此,通过账户令牌,您可以方便地获取 Ace Data Cloud 平台的账户信息。
首先,您需要在 https://platform.acedata.cloud/console/platform-tokens 创建一个账户令牌,如图所示:
复制该「账户令牌」,并记录为token。
额度查询
有了上述的application_id和token后,您就可以构造 URL 来查询剩余额度了。额度查询的 API 格式如下:
-
请求方式:GET
-
请求 URL:https://platform.acedata.cloud/api/v1/applications/{application_id}
-
请求 Headers:
-
accept:
application/json -
authorization:
Bearer {token}
CURL 请求代码如下:
curl -X GET \
-H "accept: application/json" \
-H "authorization: Bearer {token}" \
"https://platform.acedata.cloud/api/v1/applications/{application_id}"
如 token 为 platform-v1-5b8fbef60bc547098034db3e9f36a623731c490abe854f72972a0a3473b4c56b,application_id 为 107f8d0f-e465-4a7e-a49e-d633d26f7aa2,那么命令如下:
curl -X GET \
-H "accept: application/json" \
-H "authorization: Bearer platform-v1-5b8fbef60bc547098034db3e9f36a623731c490abe854f72972a0a3473b4c56b" \
"https://platform.acedata.cloud/api/v1/applications/107f8d0f-e465-4a7e-a49e-d633d26f7aa2"
请将{application_id}替换为实际的应用程序 ID,并将{token}替换为有效的账户令牌。
该 CURL 命令将发送 GET 请求到指定的 URL,并在请求头中包含所需的accept和authorization信息。
示例结果如下:
{
"id": "107f8d0f-e465-4a7e-a49e-d633d26f7aa2",
"service_id": "d87e5e99-b797-4ade-9e73-b896896b0461",
"remaining_amount": 493.2210000000001,
"used_amount": 21.778999999999996,
"service": {
...
},
"user_id": "b87f67c1-b04f-4332-99a1-7a5e651331c6",
"created_at": "2024-05-30T14:41:20.052849Z",
"updated_at": "2024-08-16T07:51:15.603207Z",
"tags": null,
"expired_at": null,
"type": "Usage",
"metadata": null
}
其中,JSON 结果的remaining_amount即为剩余额度。
对于其他编程语言,只需将 CURL 命令改写为相应的语言格式即可。如果在改写时遇到困难,可以使用https://curlconverter.com/工具将 CURL 命令转换为其他语言。
如 Python 语言:
import requests
url = "https://platform.acedata.cloud/api/v1/applications/{application_id}"
headers = {
"accept": "application/json",
"authorization": "Bearer {token}"
}
response = requests.get(url, headers=headers)
print(response.json())
如 Node.js 语言:
import axios from "axios";
const url =
"https://platform.acedata.cloud/api/v1/applications/{application_id}";
const headers = {
accept: "application/json",
authorization: "Bearer {token}",
};
axios
.get(url, { headers })
.then((response) => {
console.log(response.data);
})
.catch((error) => {
console.error(error);
});
如 Java 语言:
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import java.io.IOException;
public class Main {
public static void main(String[] args) {
OkHttpClient client = new OkHttpClient();
String url = "https://platform.acedata.cloud/api/v1/applications/{application_id}";
String token = "{token}";
Request request = new Request.Builder()
.url(url)
.addHeader("accept", "application/json")
.addHeader("authorization", "Bearer " + token)
.build();
try {
Response response = client.newCall(request).execute();
String responseData = response.body().string();
System.out.println(responseData);
} catch (IOException e) {
e.printStackTrace();
}
}
}
如 PHP 语言:
<?php
$url = 'https://platform.acedata.cloud/api/v1/applications/{application_id}';
$token = '{token}';
$headers = array(
'accept: application/json',
'authorization: Bearer ' . $token
);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>
免责声明:
本文所载程序、技术方法仅面向合法合规的安全研究与教学场景,旨在提升网络安全防护能力,具有明确的技术研究属性。
任何单位或个人未经授权,将本文内容用于攻击、破坏等非法用途的,由此引发的全部法律责任、民事赔偿及连带责任,均由行为人独立承担,本站不承担任何连带责任。
本站内容均为技术交流与知识分享目的发布,若存在版权侵权或其他异议,请通过邮件联系处理,具体联系方式可点击页面上方的联系我。
本文转载自:进击的Coder 《Ace Data Cloud 平台剩余额度查询》
版权声明
本站仅做备份收录,仅供研究与教学参考之用。
读者将信息用于其他用途的,全部法律及连带责任由读者自行承担,本站不承担任何责任。











评论