Docs

Documentazione per sviluppatori

AITREE parla l’API di OpenAI. Con la maggior parte degli SDK ti basta cambiare base_url e api_key.

Autenticazione

Invia un token Bearer nell’header Authorization. Crea e gestisci le chiavi dalla console.

Authorization: Bearer $AITREE_API_KEY

Completamenti chat

Stessi parametri di /v1/chat/completions di OpenAI, streaming incluso.

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

I modelli Claude supportano anche il protocollo nativo di Anthropic: punta la base_url dell’SDK ufficiale su AITREE (senza /v1) e usa la stessa chiave 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)

Generazione di immagini

Come /v1/images/generations di OpenAI; restituisce gli URL delle immagini. Fatturazione a chiamata o a token a seconda del modello.

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

Generazione di video

I video sono task asincroni: POST /v1/video/generations restituisce un task_id; interroga GET /v1/video/generations/{id} finché status non è succeeded per ottenere l’URL del video.

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

Elenco modelli

Scopri i modelli attualmente disponibili per la tua chiave.

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

Chiavi e sicurezza

Ogni chiave può avere un limite di spesa, una scadenza e un elenco di modelli e IP consentiti. Se una chiave viene compromessa, disattivala dalla console e creane una nuova.

Errori

Le risposte di errore seguono il formato OpenAI; error.type ne indica l’origine.

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

Compatibilità

Funziona con gli SDK ufficiali di OpenAI, LangChain, LlamaIndex, Cherry Studio, Open WebUI, Cursor e qualsiasi strumento che accetti una base_url personalizzata.