Bases de l'intégration

#URL de base

Tous les endpoints se trouvent sous /v1, sur le domaine propre à ce déploiement. Il n'y a pas de choix de région — le routage vers les fournisseurs en amont se fait derrière la passerelle.

#En-tête d'authentification

Un seul en-tête Authorization: Bearer suffit pour toute l'authentification. Pas de signature, pas d'horodatage, pas d'en-tête par utilisateur — rien de ce qu'exigent d'autres passerelles au-delà du jeton bearer n'existe ici.

#Enveloppe d'erreur

Les rejets côté passerelle utilisent l'enveloppe au format OpenAI avec le type "xiaoxiang_error". Les erreurs en amont sont transmises telles quelles, les endpoints de tâches asynchrones répondent avec un corps plat, et deux cas n'ont aucun corps — lisez la page des erreurs avant d'écrire votre parseur.

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"
  }
}

Les cinq enveloppes et la table des codes d'erreur →

#Politique de nouvelle tentative

Réessayez les 429 et 5xx avec un backoff exponentiel, en respectant Retry-After s'il est présent. Ne réessayez pas les erreurs de validation 4xx — le même corps échouera à nouveau. Pour les soumissions facturables, envoyez une Idempotency-Key : une nouvelle tentative après un délai d'expiration rejouera le premier résultat au lieu de lancer un second traitement.

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()

Fonctionnement des clés d'idempotence →

#Spécification lisible par machine

Le même contrat dans deux formats générés : OpenAPI pour la génération de clients, Postman et les outils API, et un fichier markdown unique à coller dans un agent de code. Les deux sont reconstruits à partir de ces pages : ils ne peuvent pas diverger de ce que vous lisez.

# 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

#Vue d'ensemble des endpoints

Chaque chemin accepte le corps de requête OpenAI — les paramètres propres aux fournisseurs (anthropic tool_use, gemini thinking_config) sont transmis tels quels. Les routes natives des fournisseurs et les routes historiques figées sont listées séparément sur la page de compatibilité.