Integration basics

#Base URL

All endpoints live under /v1 on this deployment’s own domain. There is no region selection — routing to upstream vendors happens behind the gateway.

#Authentication header

A single Authorization: Bearer header is the entire auth story. No signature, no timestamp, and no per-user header — anything beyond the bearer token that other gateways require does not exist here.

#Error envelope

Gateway-side rejections use the OpenAI-shaped envelope with type "xiaoxiang_error". Upstream errors are forwarded unchanged, async task endpoints answer with a flat body, and two cases carry no body at all — read the errors page before writing your parser.

HTTP/1.1 402 Payment Required
X-Oneapi-Request-Id: 2026091023...

{
  "error": {
    "message": "insufficient account balance, please top up to continue (request id: 2026091023...)",
    "type": "xiaoxiang_error",
    "code": "insufficient_user_quota"
  }
}

All five envelopes and the error-code table →

#Retry policy

Retry 429 and 5xx with exponential backoff, honoring Retry-After when present. Do not retry 4xx validation errors — the same body will fail again. For billable submissions, send an Idempotency-Key so a retry after a timeout replays the first result instead of starting a second job.

import time, requests

def call_with_backoff(url, headers, body, tries=5):
    for i in range(tries):
        r = requests.post(url, headers=headers, json=body)
        if r.status_code not in (429, 500, 502, 503, 504):
            return r
        # 429 and 413 have no JSON body — never parse before checking status.
        wait = int(r.headers.get("Retry-After", 2 ** i))
        time.sleep(wait)
    r.raise_for_status()

How idempotency keys work →

#Machine-readable spec

The same contract in two generated formats: OpenAPI for client generation, Postman and API tooling, and a single markdown file to paste into a coding agent. Both are rebuilt from these pages, so they cannot drift from what you are reading.

# Any OpenAPI generator works; this is the common one.
npx @openapitools/openapi-generator-cli generate \
  -i https://www.aisplice.store/openapi.json \
  -g python \
  -o ./gateway-client

#Endpoint overview

Every path accepts the OpenAI request body — vendor-specific parameters (anthropic tool_use, gemini thinking_config) pass through unchanged. Vendor-native and frozen legacy routes are listed separately on the compatibility page.