api.acedata.cloud, em métodos fortemente tipados, eliminando a necessidade de escrever manualmente HTTP, SSE, polling de tarefas, tratamento de erros e lógica de retry com backoff.
Este capítulo está organizado na ordem de integração real: primeiro, obtenha o API Token no console, depois escolha a linguagem e veja o capítulo correspondente, e por último, veja o polling de tarefas, respostas em streaming e o uso avançado de pagamentos em blockchain X402.
Repositório e Pacotes
- Código fonte do SDK (monorepo): https://github.com/AceDataCloud/SDK
- TypeScript:
@acedatacloud/sdk - Python:
acedatacloud - Go:
github.com/AceDataCloud/SDK/go - Cliente X402 (TypeScript):
@acedatacloud/x402-client - Cliente X402 (Python):
acedatacloud-x402
Matriz de Capacidades das Três Linguagens
Os recursos multimídia e o polling de tarefas do SDK Go estão atualmente em fase alpha (versão pseudov0.0.0-20260505072132-4a3d921f9bb4), a capacidade estável échat.completions. Para cenários multimídia, escolha preferencialmente TypeScript ou Python.
Quando usar SDK / MCP / HTTP nativo / X402
SDK e X402 não são mutuamente exclusivos: o SDK suporta simultaneamente o caminho “token” e o caminho “
paymentHandler”, veja mais em SDK + Gancho de Pagamento X402.
Solicitar API Token
Para usar o SDK, primeiro vá ao Console Ace Data Cloud - Lista de Aplicativos e solicite um API Token:
Se você ainda não estiver logado ou registrado, será redirecionado automaticamente para a página de login, convidando-o a se registrar e fazer login. Após o login ou registro, você será redirecionado de volta para a página atual.
Na primeira solicitação, haverá um crédito gratuito disponível, permitindo que você experimente gratuitamente os diversos serviços de IA oferecidos pelo Ace Data Cloud.
Copie o Token que você obteve, que será referenciado como {token} a seguir.
Variáveis de Ambiente Unificadas
Os SDKs das três linguagens lerão automaticamente a mesma variável de ambienteACEDATACLOUD_API_TOKEN, recomendando que você a export no shell, permitindo que o SDK a capture automaticamente:
- TypeScript:
new AceDataCloud({ apiToken: '{token}' }) - Python:
AceDataCloud(api_token="{token}") - Go:
adc.NewClient(adc.WithAPIToken("{token}"))
Nota: O repositório do projeto AceDataCloud convencionalmente usaACEDATACLOUD_API_KEY(em.env/ CI), mas esses três SDKs reconhecem apenasACEDATACLOUD_API_TOKEN. Se o seu ambiente tiver apenasACEDATACLOUD_API_KEY, passe-o explicitamente ao construir.
Exemplos Rápidos em 30 Segundos
As três seções de código fazem a mesma coisa: chamamgpt-4o-mini, pedindo que ele responda apenas com ADC_*_OK. Cada trecho inclui resultados reais de execução, que você pode reproduzir com seu próprio token.
TypeScript
O SDK atualmente declara a resposta comoResultado da execução do programa:Record<string, unknown>, em tempo de execução é um objeto JSON comum, que pode ser acessado diretamente por campo. Em projetos TS rigorosos, se você encontrar erros de tipo, pode temporariamente usaras any, ou consultar Polling de Tarefas e Respostas em Streaming do SDK para criar um wrapper tipado.
Python
O SDK Python atualmente retorna umResultado da execução do programa:dict, então useres["id"]em vez deres.id. Isso é diferente doopenai-python, e deve ser observado durante a migração.
Go
A resposta do SDK Go é uniformemente umResultado da execução do programa:map[string]any, não há struct de tipo forte, é necessário fazer a asserção de tipo manualmente. Todos os acessadores de recursos são encadeados:client.OpenAI().Chat().Completions().Create(...).
id, elapsed_ms e usage têm a mesma origem: através da autenticação do PlatformGateway → API compatível com OpenAI → gravação de registros de cobrança. O campo content é a saída real do modelo, usar o identificador fixo ADC_*_OK é para provar que a resposta não foi alterada pelo SDK.
Ordem de leitura recomendada
- Tutorial de integração do SDK TypeScript —— Código que pode ser executado após
npm install. - Tutorial de integração do SDK Python —— Três formas de uso: síncrono, assíncrono e em fluxo.
- Tutorial de integração do SDK Go —— Estilo Go de
context.Contexte fluxo de canal. - Polling de tarefas do SDK e resposta em fluxo —— Diferenças de unidade de TaskHandle, detalhes de implementação do SSE, retrocesso de tentativas.
- SDK + Ganchos de pagamento X402 —— Sem token, liquidação por chamada em cadeia.
Como verificar o saldo restante
Através do Console Ace Data Cloud - Lista de Aplicativos, você pode verificar o saldo restante da conta atual. Através do Console Ace Data Cloud - Histórico de Uso você pode verificar todo o histórico de uso e detalhes de cobrança.Saiba mais
- 📦 Código-fonte do SDK monorepo
- 🔌 Guia de integração X402
- 🛠 Tutorial de Servidores MCP
- 📊 Lista de serviços e preços

