Skip to content

Docs

Documentação para desenvolvedores

A AITREE fala a API da OpenAI. Na maioria dos SDKs, basta trocar base_url e api_key.

Obter chave de API

Autenticação

Envie um token Bearer no cabeçalho Authorization. Crie e gerencie chaves no console.

Authorization: Bearer $AITREE_API_KEY

Chat Completions

Mesmos parâmetros do /v1/chat/completions da OpenAI, incluindo streaming.

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

Os modelos Claude também falam o protocolo nativo da Anthropic: aponte o base_url do SDK oficial para a AITREE (sem /v1) e use a mesma chave de 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)

Geração de imagens

Igual ao /v1/images/generations da OpenAI; retorna URLs das imagens. Cobrado por chamada ou por token, conforme o modelo.

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

Geração de vídeo

Vídeos são tarefas assíncronas: POST /v1/video/generations retorna um task_id; consulte GET /v1/video/generations/{id} até que status seja succeeded para obter a URL do vídeo.

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

Listar modelos

Descubra os modelos disponíveis no momento para sua chave.

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

Chaves e segurança

Cada chave pode ter limite de gastos, validade, lista de modelos permitidos e lista de IPs permitidos. Se uma chave vazar, desative-a no console e crie uma nova.

Erros

As respostas de erro seguem o formato da OpenAI; error.type identifica a origem.

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

Compatibilidade

Funciona com os SDKs oficiais da OpenAI, LangChain, LlamaIndex, Cherry Studio, Open WebUI, Cursor e qualquer outra ferramenta que aceite um base_url personalizado.

Documentação para desenvolvedores · AITREE