Five-minute quickstart · API v1.10.0

Make your first typed Developer API request.

Install an official Arc en Ciel SDK and make a typed public Developer API request in five minutes, then reuse the same client in the safe sandbox.

Install an official SDK Try the sandbox Browse 265 operations

1. Install one official client

TypeScript / JavaScriptnpm install @arcenciel/sdk@1.1.0
Python 3.11+python3.11 -m pip install arcenciel==1.1.0

npm package · PyPI package · SDK guide

Current compatibility

Developer API
v1.10.0
Operations
265
SDK release
v1.1.0
Runtime base URL
https://arcenciel.io

Public catalogue reads need no credential. Private data and writes require a narrow API-key or OAuth scope.

2. Run a public catalogue read

TypeScript

import { ArcEnCielClient } from '@arcenciel/sdk'

const client = new ArcEnCielClient()
const page = await client.call(() =>
  client.models.searchModels({ search: 'landscape', limit: 5 })
)
console.log(page.data)

Python

from arcenciel import ArcEnCielClient

client = ArcEnCielClient()
page = client.call_sync(
    lambda: client.models.search_models_sync(search="landscape", limit=5)
)
print(page.data)

cURL

curl --fail-with-body --get 'https://arcenciel.io/api/models/search' \
  --data-urlencode 'search=landscape' \
  --data-urlencode 'limit=5'

Keep the X-Request-ID response header when you need support.

3. Switch to safe test mode

Set the SDK base URL to https://arcenciel.io/developers/sandbox and use aec_test_public. The Sandbox never persists production data or accepts live credentials.

Open the interactive workbench · Inspect the operation manifest