Repositorio y paquetes
- Código fuente del 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 en tres lenguajes
Los recursos multimedia y el sondeo de tareas del SDK de Go están actualmente en fase alpha (versión falsav0.0.0-20260505072132-4a3d921f9bb4), la capacidad estable eschat.completions. Para escenarios multimedia, se recomienda elegir TypeScript o Python.
Cuándo usar SDK / MCP / HTTP nativo / X402
SDK y X402 no son mutuamente excluyentes: el SDK admite simultáneamente “ruta de token” y “ruta
paymentHandler”, ver SDK + gancho de pago X402.
Solicitar API Token
Para usar el SDK, primero ve a Consola de Ace Data Cloud - Lista de aplicaciones y solicita un API Token:
Si aún no has iniciado sesión o registrado, serás redirigido automáticamente a la página de inicio de sesión que te invita a registrarte e iniciar sesión, después de iniciar sesión, serás redirigido automáticamente a la página actual.
Al solicitar por primera vez, recibirás un crédito gratuito que te permitirá experimentar de forma gratuita con varios servicios de IA que ofrece Ace Data Cloud.
Copia el Token que obtuviste, que a continuación se denominará {token}.
Variables de entorno unificadas
Los SDK de los tres lenguajes leerán automáticamente la misma variable de entornoACEDATACLOUD_API_TOKEN, se recomienda usar export en el shell para que el SDK la recoja automáticamente:
- TypeScript:
new AceDataCloud({ apiToken: '{token}' }) - Python:
AceDataCloud(api_token="{token}") - Go:
adc.NewClient(adc.WithAPIToken("{token}"))
Nota: En el repositorio del proyecto AceDataCloud, se ha convenido en usarACEDATACLOUD_API_KEY(en.env/ CI), pero estos tres SDK solo reconocenACEDATACLOUD_API_TOKEN. Si en tu entorno solo tienesACEDATACLOUD_API_KEY, por favor, pásalo explícitamente al construir.
Ejemplos de 30 segundos
Las siguientes tres secciones de código hacen lo mismo: llaman agpt-4o-mini y le piden que responda solo con ADC_*_OK. Cada sección incluye resultados de ejecución reales, que puedes reproducir con tu propio token.
TypeScript
El SDK actualmente declara la respuesta comoResultados de la ejecución del programa:Record<string, unknown>, en tiempo de ejecución es un objeto JSON normal, que se puede acceder directamente por campo. En proyectos estrictos de TS, si encuentras errores de tipo, puedes usar temporalmenteas any, o consultar Sondeo de tareas y respuestas en streaming del SDK para crear un envoltorio tipado personalizado.
Python
El SDK de Python actualmente devuelve unResultado de la ejecución del programa:dict, por lo que se usares["id"]en lugar deres.id. Esto es diferente deopenai-python, así que hay que tener cuidado al migrar.
Go
La respuesta del SDK de Go es unificada comoResultado de la ejecución del programa:map[string]any, no hay estructuras de tipo fuerte, se necesita hacer afirmaciones de tipo. Todos los accesores de recursos son cadenas de métodos:client.OpenAI().Chat().Completions().Create(...).
id, elapsed_ms, y usage provienen de manera consistente: autenticación a través de PlatformGateway → API compatible con OpenAI → registro de facturación. El campo content es la salida real del modelo, usar la identificación fija ADC_*_OK es para demostrar que la respuesta no ha sido alterada por el SDK.
Orden de lectura recomendado
- Tutorial de integración del SDK de TypeScript —— Código que se puede ejecutar después de
npm install. - Tutorial de integración del SDK de Python —— Tres métodos: sincrónico, asincrónico y en flujo.
- Tutorial de integración del SDK de Go —— Estilo de Go con
context.Contexty flujo de canales. - Polling de tareas del SDK y respuestas en flujo —— Diferencias en unidades de TaskHandle, detalles de implementación de SSE, retroceso en reintentos.
- SDK + ganchos de pago X402 —— Sin token, liquidación en cadena según la llamada.
Cómo ver el saldo restante
A través de Consola de Ace Data Cloud - Lista de aplicaciones, se puede ver el saldo restante de la cuenta actual. A través de Consola de Ace Data Cloud - Historial de uso se puede ver todo el historial de uso y detalles de facturación.Más información
- 📦 Código fuente del SDK monorepo
- 🔌 Guía de integración X402
- 🛠 Tutoriales de servidores MCP
- 📊 Lista de servicios y precios

