Skip to content

Docs

Документация для разработчиков

AITREE поддерживает OpenAI API. В большинстве SDK достаточно поменять base_url и api_key.

Получить API-ключ

Аутентификация

Передавайте Bearer-токен в заголовке Authorization. Ключи создаются и управляются в консоли.

Authorization: Bearer $AITREE_API_KEY

Chat Completions

Те же параметры, что и в OpenAI /v1/chat/completions, включая потоковую передачу.

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

Модели Claude также поддерживают нативный протокол Anthropic: укажите в base_url официального SDK адрес AITREE (без /v1) и используйте тот же 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)

Генерация изображений

Как в OpenAI /v1/images/generations; возвращает URL изображений. Оплата за вызов или за токены — в зависимости от модели.

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

Генерация видео

Видео создаётся асинхронно: POST /v1/video/generations возвращает task_id; опрашивайте GET /v1/video/generations/{id}, пока status не станет succeeded, — тогда вы получите URL видео.

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

Список моделей

Узнайте, какие модели сейчас доступны для вашего ключа.

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

Ключи и безопасность

Для каждого ключа можно задать лимит расходов, срок действия, белый список моделей и белый список IP. Если ключ утёк, отключите его в консоли и создайте новый.

Ошибки

Ответы об ошибках имеют формат OpenAI; поле error.type указывает источник.

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

Совместимость

Работает с официальными SDK OpenAI, LangChain, LlamaIndex, Cherry Studio, Open WebUI, Cursor и любыми клиентами, которые поддерживают собственный base_url.

Документация для разработчиков · AITREE