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;
?>