Retrieve qiyaov Platform Service Details

Retrieve complete information for a single service by service ID (UUID) or alias—more comprehensive fields than returned by Retrieve qiyaov Platform Service List, additionally expanding associated objects such as apis, proxies, datasets, and packages. Suitable for scenarios such as service detail pages, pricing comparison pages, Agent tool descriptions, and more.

ℹ️ This API belongs to the qiyaov Platform Management API, with the unified prefix https://api17.platform.acedata.cloud/api/v1/. For the complete API index, see Retrieve qiyaov Platform Document List.

¶ API Overview

Item	Content
Method	`GET`
URL	`https://api17.platform.acedata.cloud/api/v1/services/{service_id}`
Authentication	❌ Public

/services/{id} and /services/{id}/ are both currently available; examples consistently use the form without a trailing slash.

¶ Authentication Description

This API is completely public. However, after including an account token, the applied field in the response will reflect the actual application status of the current account, otherwise it will always be false.

For how to obtain an account token, see Manage qiyaov Platform Account Tokens.

¶ Path Parameters

Parameter	Type	Required	Description
`service_id`	UUID / string	✅	Service ID (UUID) or alias (such as `midjourney`, `openai`, `webextrator`, etc.)

¶ Request Examples

¶ cURL

# 按 UUID 查询
curl 'https://api17.platform.acedata.cloud/api/v1/services/8efa1d83-9b75-4562-b44a-af95ce563d05' \
  -H 'accept: application/json'

# 按 alias 查询
curl 'https://api17.platform.acedata.cloud/api/v1/services/midjourney' \
  -H 'accept: application/json'

# 带账户令牌看 applied 状态
curl 'https://api17.platform.acedata.cloud/api/v1/services/midjourney' \
  -H 'accept: application/json' \
  -H "authorization: Bearer ${PLATFORM_TOKEN}"

¶ Python

import os
import requests

resp = requests.get(
    "https://api17.platform.acedata.cloud/api/v1/services/midjourney",
    headers={
        "accept": "application/json",
        "authorization": f"Bearer {os.environ['PLATFORM_TOKEN']}",
    },
    timeout=10,
)
svc = resp.json()
print(f"服务: {svc['title']} ({svc['alias']})")
print(f"已申请: {svc['applied']}, 免费额度: {svc['free_amount']} {svc['unit']}")
print(f"API 数: {len(svc['apis'])}, 套餐数: {len(svc['packages'])}")
for pkg in svc["packages"]:
    print(f"  ¥{pkg['price']:>7.2f}  ->  {pkg['amount']} {svc['unit']}")

¶ Node.js

const r = await fetch('https://api17.platform.acedata.cloud/api/v1/services/midjourney', {
  headers: { accept: 'application/json' },
})
const svc = await r.json()
console.log(`${svc.title} - 套餐 ${svc.packages.length} 个 - API ${svc.apis.length} 个`)

¶ Response Example (HTTP 200)

{
  "id": "8efa1d83-9b75-4562-b44a-af95ce563d05",
  "alias": "face-transform",
  "title": "人脸变换",
  "description": "人脸识别、替换和风格转换等操作服务。",
  "introduction": "...长文 Markdown...",
  "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 }
  ],
  "apis": [
    {
      "id": "e4fbc3b6-4f44-48fb-a049-40f5c27c7cd3",
      "name": "Face Analyze API",
      "title": "五官定位 API",
      "path": "/face/analyze",
      "stage": "Stable",
      "cost": [ { "conditions": { "==": [1, 1] }, "consumption": 0.0025 } ]
    }
  ],
  "proxies": [],
  "datasets": [],
  "packages": [
    {
      "id": "4add61f2-61db-4d1c-85b6-d4876ac122f0",
      "type": "Usage",
      "price": 63.2,
      "amount": 530.0,
      "duration": null,
      "private": false
    }
  ],
  "created_at": "2024-06-11T00:41:29.255614Z",
  "updated_at": "2026-04-26T16:12:40.481154Z"
}

¶ Response Field Descriptions

In addition to all fields in the list API, the detail API additionally expands:

Field	Type	Description
`apis`	array	Complete list of associated API objects (each entry includes `id`, `name`, `title`, `path`, `stage`, `cost`)
`proxies`	array	Complete list of associated Proxy objects
`datasets`	array	Associated datasets (if `type=Dataset`)
`packages`	array	Package list, including `type` (`Usage`/`Period`), `price`, `amount`, `duration`

For definitions of the remaining fields, see Retrieve qiyaov Platform Service List → Response Field Descriptions.

¶ Error Handling

HTTP	code	Meaning
404	`not_found`	`service_id` (UUID or alias) does not exist
500	—	Usually caused by mistakenly adding a trailing slash to the URL; remove it and retry

¶ Practical Tips

alias > UUID: Hardcoding alias (such as midjourney) into code is more stable; UUIDs change when migrating environments.
The apis field does not include the OpenAPI definition: The complete OpenAPI 3.0 Schema is available in the Retrieve qiyaov Platform API Details API.
Retrieve a service's "complete capabilities": Use this API to obtain api_ids, then call /apis/{api_id} one by one to retrieve details.
If applied=true, you can directly create API credentials to obtain the 32-character Token required to call business APIs, without needing to apply again.