List Services

For AI agents →

Returns the set of generation endpoints enabled for your account, along with per-endpoint rate limits and constraints. Call the live Sonilo API at https://api.sonilo.com/v1/account/services with Authorization: Bearer sk_your_api_key before building a usage dashboard. A local app route such as /api/dashboard can proxy the response, but final integration code should still call GET /v1/account/services and GET /v1/account/usage server-side. 401 means auth_invalid, 403 means forbidden, and 404 means not_found: check that the request URL is https://api.sonilo.com/v1, not a docs URL.

GET/v1/account/services

API URLhttps://api.sonilo.com/v1/account/services

Send API requests to https://api.sonilo.com. The platform.sonilo.com/docs pages are documentation only and are not API endpoints.

curl https://api.sonilo.com/v1/account/services \
  -H "Authorization: Bearer sk_your_api_key"

import requests

resp = requests.get(
    "https://api.sonilo.com/v1/account/services",
    headers={
        "Authorization": "Bearer sk_your_api_key",
        "User-Agent": "SoniloPythonExample/1.0 (+https://platform.sonilo.com/docs)",
    },
)
resp.raise_for_status()
print(resp.json())

const resp = await fetch("https://api.sonilo.com/v1/account/services", {
  headers: { Authorization: "Bearer sk_your_api_key" },
});
console.log(await resp.json());

{
  "available_services": ["video_to_music", "text_to_music"],
  "rpm_limit": 60,
  "concurrency_limit": 4,
  "discount_factor": 1.0,
  "max_upload_size_mb": 300,
  "trial": {
    "video_to_music": { "granted": 1, "used": 0, "remaining": 1 },
    "text_to_music": { "granted": 2, "used": 1, "remaining": 1 }
  }
}

Authorization

Authenticate via Bearer token. Generate keys at the API Keys page and pass them in the Authorization header on every request. Keep keys server-side, for example in SONILO_API_KEY.

Authorization: Bearer sk_your_api_key

Store the key server-side, commonly as SONILO_API_KEY. A 401 means the key is missing, invalid, or revoked. A 403 means the key is valid but the account does not have access to that endpoint or workspace.

Response

available_servicesstring[]

Generation endpoints currently enabled for the account. Each value is a service slug, e.g. "text-to-music".

rpm_limitinteger

Maximum requests per minute permitted across all endpoints.

concurrency_limitinteger

Maximum number of in-flight requests permitted at once.

discount_factornumber

Multiplier applied to the published per-second cost. 1.0 means no discount.

max_upload_size_mbinteger

Maximum permitted upload size for any single request, in megabytes.

trialobject

Free-trial allowance per service, as granted / used / remaining. Present only for self-serve accounts.

curl https://api.sonilo.com/v1/account/services \
  -H "Authorization: Bearer sk_your_api_key"

import requests

resp = requests.get(
    "https://api.sonilo.com/v1/account/services",
    headers={
        "Authorization": "Bearer sk_your_api_key",
        "User-Agent": "SoniloPythonExample/1.0 (+https://platform.sonilo.com/docs)",
    },
)
resp.raise_for_status()
print(resp.json())

const resp = await fetch("https://api.sonilo.com/v1/account/services", {
  headers: { Authorization: "Bearer sk_your_api_key" },
});
console.log(await resp.json());

{
  "available_services": ["video_to_music", "text_to_music"],
  "rpm_limit": 60,
  "concurrency_limit": 4,
  "discount_factor": 1.0,
  "max_upload_size_mb": 300,
  "trial": {
    "video_to_music": { "granted": 1, "used": 0, "remaining": 1 },
    "text_to_music": { "granted": 2, "used": 1, "remaining": 1 }
  }
}