Skip to content

Docs

Documentation développeur

AITREE parle l’API OpenAI. Avec la plupart des SDK, il suffit de changer base_url et api_key.

Obtenir une clé API

Authentification

Envoyez un token Bearer dans l’en-tête Authorization. Créez et gérez vos clés dans la console.

Authorization: Bearer $AITREE_API_KEY

Complétions de chat

Mêmes paramètres que /v1/chat/completions d’OpenAI, streaming compris.

curl https://aitree.ai/v1/chat/completions \
  -H "Authorization: Bearer $AITREE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash-0731",
    "stream": true,
    "messages": [{ "role": "user", "content": "用一句话解释什么是算力中转站" }]
  }'

Anthropic Messages

Les modèles Claude parlent aussi le protocole natif d’Anthropic : pointez la base_url du SDK officiel vers AITREE (sans /v1) et utilisez la même clé API.

import anthropic

client = anthropic.Anthropic(base_url="https://aitree.ai", api_key="YOUR_AITREE_KEY")

msg = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}],
)
print(msg.content[0].text)

Génération d’images

Identique à /v1/images/generations d’OpenAI ; renvoie des URL d’images. Facturé à l’appel ou au token selon le modèle.

curl https://aitree.ai/v1/images/generations \
  -H "Authorization: Bearer $AITREE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "a glowing compute tree at night, cinematic",
    "size": "1024x1024"
  }'

Génération de vidéos

Les vidéos sont des tâches asynchrones : POST /v1/video/generations renvoie un task_id ; interrogez GET /v1/video/generations/{id} jusqu’à ce que status vaille succeeded pour obtenir l’URL de la vidéo.

# 1. submit
curl https://aitree.ai/v1/video/generations \
  -H "Authorization: Bearer $AITREE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "model": "doubao-seedance-2-0-fast-260128", "prompt": "drone shot through a forest of light", "seconds": "5" }'

# 2. poll until status is "succeeded"
curl https://aitree.ai/v1/video/generations/$TASK_ID \
  -H "Authorization: Bearer $AITREE_API_KEY"

Lister les modèles

Découvrez les modèles actuellement accessibles avec votre clé.

curl https://aitree.ai/v1/models \
  -H "Authorization: Bearer $AITREE_API_KEY"

Clés et sécurité

Chaque clé peut avoir un plafond de dépense, une expiration, une liste de modèles autorisés et une liste d’IP autorisées. Si une clé est divulguée, désactivez-la dans la console et créez-en une nouvelle.

Erreurs

Les réponses d’erreur suivent le format OpenAI ; error.type en indique l’origine.

{
  "error": {
    "message": "insufficient user quota",
    "type": "new_api_error",
    "code": "insufficient_user_quota"
  }
}

Compatibilité

Fonctionne avec les SDK officiels d’OpenAI, LangChain, LlamaIndex, Cherry Studio, Open WebUI, Cursor et tout outil qui accepte une base_url personnalisée.

Documentation développeur · AITREE