Saltar al contenido principal
La referencia API de DGrid está organizada en tres superficies de API, cada una con su propio modelo de autenticación y propósito:

Model API

Endpoints compatibles con OpenAI, Claude y Gemini para chat, completions, embeddings, imágenes, audio y moderación.

API de gestión

Gestione claves Model API mediante programación y consulte saldos con una clave API de gestión.

x402 API

Acceso de inferencia de pago por uso mediante el protocolo de pago x402, sin saldo de cuenta prefinanciado.
Para recibir eventos en su endpoint HTTPS, consulte la guía Webhook. Para correo y Lark, consulte Notificaciones.
Cada página de referencia de Model API incluye un playground interactivo: introduzca su clave API y parámetros, y luego pulse Send para probar el endpoint en vivo en https://api.dgrid.ai.

​
Model API

La Model API le ofrece un único gateway hacia más de 200 modelos de IA líderes. Cada endpoint es compatible con un estándar del ecosistema, ya sea OpenAI, Claude o Gemini, para que sus SDK y herramientas existentes funcionen sin modificaciones. Para conciliar costos a nivel de solicitud, guarde el encabezado de respuesta DGrid-Request-ID y use Obtener detalles de facturación de una solicitud para recuperar uso de tokens, precios y costos en USD.

​
URL base

​
Autenticación

Todos los endpoints de Model API se autentican con un token Bearer:
El endpoint compatible con Claude POST /v1/messages requiere además:
Obtenga su clave siguiendo la guía de creación de claves, o use la superficie de Claves API de gestión para gestionar programáticamente el ciclo de vida de las claves.

​
Nomenclatura de modelos

El parámetro model usa el formato provider/model-name, por ejemplo openai/gpt-4o, de forma consistente en todos los modelos compatibles con DGrid. Llame a Listar modelos para descubrir los identificadores de modelos disponibles para su clave.

​
Familias de endpoints

​
Prácticas recomendadas

  1. Guarde la clave API de DGrid en el servidor y nunca la exponga en clientes públicos ni en repositorios.
  2. Prefiera el formato compatible con OpenAI cuando quiera la mayor compatibilidad posible de SDK con el menor esfuerzo de migración.
  3. Use formatos nativos del proveedor solo cuando necesite funciones de carga útiles específicas del proveedor, como las parts multimodales de Gemini o las cargas de tools de Claude.
  4. Mantenga sincronizados los ejemplos de solicitud y respuesta con la familia de modelos de destino, ya que los nombres de parámetros varían entre los estilos de OpenAI, Claude y Gemini.

​
API de gestión

Las claves API de gestión son credenciales administrativas para gestionar el ciclo de vida de las claves Model API y consultar el saldo de la cuenta. No pueden llamar a endpoints de inferencia de Model API. Consulte Claves API de gestión para crear claves y conocer los límites de autenticación y los endpoints de su ciclo de vida. Use Consultar el saldo de la cuenta para obtener los saldos total, de suscripción y recargado con una clave API de gestión.

​
x402 API

La x402 API es el modo de acceso de inferencia de pago por uso de DGrid. En lugar de crear una cuenta o prefinanciar un saldo, las solicitudes se autorizan y liquidan por llamada mediante el protocolo de pago x402, lo que resulta ideal para agentes autónomos e integraciones bajo demanda. Consulte x402 API para el flujo de pago y Referencia de x402 API para los detalles de los endpoints.