ℹ️ Esta interfaz pertenece a la API de administración de la plataforma AceDataCloud, con el prefijo unificado https://platform.acedata.cloud/api/v1/. Para el índice completo de interfaces, consulte Obtener la lista de documentos de la plataforma AceDataCloud.
Token de cuenta vs credenciales de API
Los dos tipos de claves que los principiantes confunden con mayor facilidad; revíselos claramente primero:
Si solo quiere probar GPT-4.1, lo que necesita son credenciales de API, no un token de cuenta.
Si desea escribir scripts de automatización para gestionar recargas, ver facturas mensuales o distribuir credenciales en lote a miembros del equipo, entonces use un token de cuenta.
Crear con un clic en la consola (recomendado)
- Inicie sesión en https://platform.acedata.cloud.
- Vaya a la barra lateral → «Desarrollador» → «Account Token».
- Haga clic en el botón «Crear» en la esquina superior derecha para obtener inmediatamente un token
platform-v1-..., haga clic en el botón de copiar y guárdelo en el gestor de contraseñas.
⚠️ Las respuestas actuales de creación, lista y detalles devuelven el token en texto plano. Trate toda la respuesta como un secreto; no la escriba en registros, plataformas de análisis o almacenamiento persistente del frontend; el cliente tampoco debe depender de que la lista conserve la devolución en texto plano a largo plazo.
Crear un token de cuenta mediante API
Resumen de la interfaz
Explicación de autenticación (el problema del huevo y la gallina)
¿De dónde viene el primer token? La respuesta es desde la consola: después de iniciar sesión en el navegador, la consola llama aFormato de los encabezados de solicitud:POST /platform-tokens/autenticándose con JWT y le entrega el primer token. Después, puede usar cualquier token existenteplatform-v1-...para crear más.
Ejemplo de solicitud
Respuesta (HTTP 201)
Descripción de campos
Obtener la lista de tokens de cuenta
Resumen de la interfaz
Parámetros de consulta obligatorios
⚠️ Debe incluirCómo obtener?user_id=<your_user_id>. Motivo: la interfaz de lista realiza una verificación de permisos por objeto sobre los resultados paginados; si no se incluyeuser_id, el primer objeto que no le pertenezca será rechazado y devolverá403 permission_denied.
user_id:
- Abra https://auth.acedata.cloud/user/profile en el navegador; la parte superior de la página muestra el UUID completo.
- O complete directamente el campo
user_iddel valor devuelto porPOST /platform-tokens/.
Parámetros de consulta
Ejemplo de solicitud
Respuesta (HTTP 200)
La respuesta paginada de esta interfaz utilizacount+items. Otras interfaces de plataforma pueden utilizar estructuras diferentes; consulte la documentación correspondiente y la respuesta real.
Obtener detalles del token de cuenta
HTTP 200.
Eliminar token de cuenta
- Si tiene éxito, devuelve
HTTP 204 No Content, sin cuerpo de respuesta. - Después de eliminarlo, el token queda inmediatamente invalidado, y todos los servicios que lo estén utilizando recibirán
401de inmediato. - Consultar de nuevo este
iddevolverá404.
⚠️ La eliminación es irreversible. Si sospecha que el token se ha filtrado, puede crear primero uno nuevo, cambiar el lado de negocio y luego eliminar el antiguo.
Operaciones no compatibles
Referencia rápida de códigos de error
Formato unificado de respuesta de error:
trace_id al servicio de atención al cliente o inclúyalo en el ticket para localizar rápidamente los registros.
Ejemplo de código completo
Python
Node.js
Uso en otras API de plataforma
Coloque directamenteplatform-v1-... en el encabezado Authorization: Bearer ... para llamar a cualquier interfaz de plataforma que requiera autorización:
Es completamente diferente de las credenciales API hexadecimales de 32 caracteres utilizadas por las interfaces de negociohttps://api.acedata.cloud/**(OpenAI, Midjourney, Suno, Veo, etc.). No las mezcle: escribir un token de cuenta en una interfaz de negocio resultará en401, y viceversa.
Interfaces relacionadas
- Obtener la lista de solicitudes de servicios de la plataforma AceDataCloud — utilizar el token de la cuenta para ver qué servicios ha solicitado
- Crear credenciales de API de la plataforma AceDataCloud — utilizar el token de la cuenta para emitir credenciales de 32 caracteres para la API empresarial
- Obtener los registros de llamadas a la API de la plataforma AceDataCloud — consultar cuentas y solucionar errores
- Obtener la lista de pedidos de la plataforma AceDataCloud — consultar el historial de recargas

