Get 辰汐ai Platform Service List

The 辰汐ai platform abstracts all callable functional modules as "services" — for example, Midjourney image generation, OpenAI conversation, Suno song generation, Veo video production, web scraping, SERP search, etc. This interface returns the complete list of all services available for application on the platform, with each record containing full information such as name, pricing rules, free quota, optional packages, associated API/Proxy endpoints, etc.

Through this interface, you can:

  • Embed a "service marketplace" page in your own product, allowing users to choose from it.
  • Provide a capability list to the LLM Agent, allowing it to decide which service to call.
  • Write scheduled scripts to monitor price/package changes.

ℹ️ This interface belongs to the 辰汐ai Platform Management API, with a unified prefix of https://chens.platform.acedata.cloud/api/v1/. For the complete interface index, see Get 辰汐ai Platform Documentation List.

Interface Overview

Item Content
Method GET
URL https://chens.platform.acedata.cloud/api/v1/services/
Authentication ❌ Public
Cache The server has a short cache of 60 seconds, safe for high-frequency calls

Authentication Description

This interface is completely public, anyone can call it, no account token or login state is required.

💡 However: If you include an account token, the applied field in the response will change to true/false (indicating whether you have applied for the service), rather than always being false. This is very convenient for the front-end "applied / apply now" button's two-state switching.

Authorization: Bearer platform-v1-92eb****629c   # Optional

For information on obtaining an account token, see Manage 辰汐ai Platform Account Token.

Query Parameters

Parameter Type Required Default Description
id UUID No — Service ID. Supports multiple values: ?id=xxx&id=yyy
alias string No — Service alias (short English code), such as midjourney, openai, webextrator
type string No — Service type, values: Api, Proxy, Integration, Dataset, Introduction, Agent
private bool No — true returns only private services (visible only to yourself); false returns only public services; if not provided, returns all
tag string No — Filter by tag, such as image, video, llm
limit integer No 10 Number of items per page, maximum 100
offset integer No 0 Offset
ordering string No rank Sorting, prefix - indicates descending order. Commonly used -rank, -applied_count, -updated_at
include_facets bool No false When true, returns the type and tag count of valid service directories for the current site, used to dynamically generate filter options

Request Examples

cURL

# Without authentication, get the first 2 Api type services
curl 'https://chens.platform.acedata.cloud/api/v1/services/?type=Api&limit=2' \
  -H 'accept: application/json'

# With authentication, check applied status
curl 'https://chens.platform.acedata.cloud/api/v1/services/?type=Api&limit=5' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer platform-v1-92eb****629c'

# Precise query by alias
curl 'https://chens.platform.acedata.cloud/api/v1/services/?alias=midjourney' \
  -H 'accept: application/json'

Python

import requests

resp = requests.get(
    "https://chens.platform.acedata.cloud/api/v1/services/",
    headers={"accept": "application/json"},
    params={"type": "Api", "limit": 20, "ordering": "-applied_count"},
    timeout=10,
)
data = resp.json()
print(f"Total {data['count']} Api services, sorted by popularity in descending order")
for svc in data["items"]:
    print(f"  {svc['title']:30s}  {svc['applied_count']:>6} applications  {svc['free_amount']} {svc['unit']} free")

Node.js

const params = new URLSearchParams({ type: 'Api', limit: '20', ordering: '-applied_count' })
const r = await fetch(`https://chens.platform.acedata.cloud/api/v1/services/?${params}`)
const { count, items } = await r.json()
console.log(`Total ${count} services`)
items.forEach((s) => console.log(`${s.title} (${s.alias})  Free ${s.free_amount} ${s.unit}`))

Response Example (HTTP 200)

{
  "count": 42,
  "facets": {
    "types": [
      { "value": "", "label": "All", "count": 31 },
      { "value": "Api", "label": "API", "count": 31 }
    ],
    "tags": [
      { "value": "", "label": "All", "count": 31 },
      { "value": "aichat", "label": "AI Q&A", "count": 7 },
      { "value": "aivideo", "label": "AI Video", "count": 9 }
    ]
  },
  "items": [
    {
      "id": "8efa1d83-9b75-4562-b44a-af95ce563d05",
      "alias": "face-transform",
      "title": "Face Transformation",
      "description": "Services for face recognition, replacement, and style transfer operations.",
      "introduction": "",
      "type": "Api",
      "applied": false,
      "applied_count": 281,
      "free_amount": 1.0,
      "unit": "Credit",
      "private": false,
      "need_verify": false,
      "rank": 0,
      "tags": [],
      "metadata": null,
      "thumbnail": "https://cdn.acedata.cloud/qrd7gw.png/thumb_600x300",
      "doc_url": null,
      "demo_url": null,
      "api_ids": [
        "e4fbc3b6-4f44-48fb-a049-40f5c27c7cd3",
        "2c7f6468-58d9-4611-885b-1e34664d49e9"
      ],
      "proxy_ids": [],
      "cost": [
        { "conditions": { "==": [1, 1] }, "consumption": 0.0025 }
      ],
      "packages": [
        {
          "id": "4add61f2-61db-4d1c-85b6-d4876ac122f0",
          "type": "Usage",
          "price": 63.2,
          "amount": 530.0,
          "duration": null,
          "private": false,
          "tags": [],
          "metadata": null,
          "created_at": "2024-12-19T13:57:46.525377Z",
          "updated_at": "2024-12-19T13:57:46.525394Z"
        }
      ],
      "created_at": "2024-06-11T00:41:29.255614Z",
      "updated_at": "2026-04-26T16:12:40.481154Z"
    }
  ]
}

Response Field Description

Field Type Description
count integer Total number of items that meet the criteria
items array List of services (single page)
facets object Returned only when include_facets=true. A complete directory based on the current site's visibility and id/private, not affected by pagination
facets.types array Public service types filtered and sorted by the backend; not affected by the current type/tag filter, can be rendered directly
facets.tags array Public business tags filtered and sorted by the backend under the current single type; not affected by the current tag filter
facets.*.value string Query parameter value; an empty string indicates "All"
facets.*.label string Display text localized according to Accept-Language
facets.*.count integer Number of services visible on the current site corresponding to this filter option
id UUID Unique identifier for the service
alias string Service alias (short English code), may be null
title string Service title (automatically localized according to Accept-Language)
description string A brief description
introduction string Long Markdown details, may be empty
type string Api / Proxy / Integration / Dataset / Introduction / Agent
applied boolean Meaningful only with authentication: Whether the current account has applied for this service
applied_count integer Total number of users who have applied for this service
free_amount number Free quota automatically granted after application
unit string Measurement unit: Credit (points), Count (times), Token, MB, GB
private boolean Whether it is a private service (private services generally do not appear in public lists and require login to view)
need_verify boolean Whether manual review is required before allowing application
rank integer Sorting weight (the larger the number, the higher the priority)
tags array Tags, such as ["image","ai"]
metadata object Extended metadata
thumbnail string Thumbnail URL
doc_url string External document link (e.g., developer center), may be null
demo_url string Demo page link
api_ids array List of associated API IDs
proxy_ids array List of associated Proxy IDs
cost array Pricing rules, in JsonLogic format, conditions expression matches request parameters and charges based on consumption
packages array List of purchasable packages, see Create 辰汐ai Platform Recharge Order
created_at string Service launch time
updated_at string Last update time of service information (package/pricing changes)

Error Handling

Public interfaces rarely encounter errors. Common non-200 situations:

HTTP Meaning
400 Invalid parameter values such as ?limit= or ?type=
502 / 503 / 504 Gateway or backend temporarily unavailable, recommend exponential backoff and retry 1–3 times

Error response format:

{
  "detail": "Invalid value for parameter 'type'.",
  "code": "invalid",
  "trace_id": "5b0f15d6e9c34c9c93d6d0f4f3a8c8d7"
}

Useful Tips

  • The most efficient way to filter services is alias, not id: The service ID is a UUID, which is not convenient for hardcoding into the code.
  • type=Api is the most commonly used filter: 90% of users only care about the Api type; Integration is a composite workflow, Dataset is a read-only dataset, and Proxy is OpenAI compatible forwarding.
  • The packages field returns prices but does not include discounts: When placing an order, if using X402 cryptocurrency payment or holding $ACE tokens, the final amount will be recalculated when creating the order. See Creating 辰汐ai Platform Recharge Orders and Querying 辰汐ai Platform $ACE Token Holdings and Discounts.
  • The filtering UI should directly render facets: The type/tag whitelist, order, and copy are all controlled by the backend, and the client should not maintain duplicate classification lists. Internal tags will not appear in facets.tags.
  • This interface has a large amount of data (each record may contain several KB of introduction Markdown): It is recommended to pass limit=20 for paginated loading when doing long lists on the client side, rather than pulling everything at once.