Skip to main content
Ace Data Cloud ofrece SDK oficiales en tres lenguajes: TypeScript / Python / Go, que encapsulan capacidades como chat completions, imágenes, video, música, búsqueda, x402, etc., en métodos de tipo fuerte, eliminando la necesidad de manejar manualmente HTTP, SSE, sondeos de tareas, manejo de errores y retrocesos de reintentos. Este capítulo está organizado en el orden de acceso real: primero obtén el API Token en la consola, luego selecciona el lenguaje y consulta el capítulo correspondiente, y finalmente revisa el sondeo de tareas, respuestas en streaming y el uso avanzado de pagos en la cadena X402.

Repositorio y paquetes

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 falsa v0.0.0-20260505072132-4a3d921f9bb4), la capacidad estable es chat.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 entorno ACEDATACLOUD_API_TOKEN, se recomienda usar export en el shell para que el SDK la recoja automáticamente:
También puedes pasarla explícitamente al construir el cliente, los nombres de los parámetros correspondientes en los tres lenguajes son:
  • 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 usar ACEDATACLOUD_API_KEY (en .env / CI), pero estos tres SDK solo reconocen ACEDATACLOUD_API_TOKEN. Si en tu entorno solo tienes ACEDATACLOUD_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 a gpt-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 como 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 temporalmente as any, o consultar Sondeo de tareas y respuestas en streaming del SDK para crear un envoltorio tipado personalizado.
Resultados de la ejecución del programa:

Python

El SDK de Python actualmente devuelve un dict, por lo que se usa res["id"] en lugar de res.id. Esto es diferente de openai-python, así que hay que tener cuidado al migrar.
Resultado de la ejecución del programa:

Go

La respuesta del SDK de Go es unificada como 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(...).
Resultado de la ejecución del programa:
En las respuestas de los tres lenguajes, 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

  1. Tutorial de integración del SDK de TypeScript —— Código que se puede ejecutar después de npm install.
  2. Tutorial de integración del SDK de Python —— Tres métodos: sincrónico, asincrónico y en flujo.
  3. Tutorial de integración del SDK de Go —— Estilo de Go con context.Context y flujo de canales.
  4. Polling de tareas del SDK y respuestas en flujo —— Diferencias en unidades de TaskHandle, detalles de implementación de SSE, retroceso en reintentos.
  5. 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