API + MCP

Gere 3D via API ou por agentes MCP

Conecte a AivanaLabs 3D ao Claude Desktop, Cursor, seu backend ou qualquer agente. Uma API key, dois transportes: REST e MCP.

REST API

Auth: Authorization: Bearer av3d_...

MCP Server

Streamable HTTP · protocolo 2025-03-26 · 3 tools

1. Crie sua API key

Entre em Configurações, seção “API & MCP”, e clique em Nova chave. A chave começa com av3d_ e é mostrada uma única vez. Créditos são debitados do dono da chave.

2. Endpoints REST

GET/modelsLista modelos disponíveis, com custo em créditos e inputs aceitos. Público (sem auth).

POST/generateCria uma geração 3D. Debita créditos e retorna { id, status }.

GET/generations/{id}Retorna status da geração e, quando pronta, output_glb_url.

# Exemplo: gerar 3D a partir de imagem
curl -X POST 'https://pyvumhfqhilqdebqlyhv.supabase.co/functions/v1/api-v1/generate' \
  -H 'Authorization: Bearer av3d_XXXX' \
  -H 'Content-Type: application/json' \
  -d '{"image_url":"https://exemplo.com/foto.jpg","model_id":"tripo3d/tripo/v2.5"}'

# {"id":"...", "status":"processing", "credits_charged":4}

# Depois:
curl 'https://pyvumhfqhilqdebqlyhv.supabase.co/functions/v1/api-v1/generations/<id>' \
  -H 'Authorization: Bearer av3d_XXXX'

Códigos: 200 ok · 401 chave inválida ou revogada · 402 créditos insuficientes · 404 não encontrado · 502 erro no provedor.

3. MCP Server — Claude Desktop

Adicione ao claude_desktop_config.json:

{
  "mcpServers": {
    "aivanalabs3d": {
      "url": "https://pyvumhfqhilqdebqlyhv.supabase.co/functions/v1/mcp-server",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer av3d_XXXX"
      }
    }
  }
}

Tools expostos: generate_3d, check_job, list_models.