Saltar al contenido principal
POST
/
v1
/
chat
/
completions
Create chat completion
curl --request POST \
  --url https://api.dgrid.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "openai/gpt-4o",
  "messages": [
    {
      "role": "user",
      "content": "What is the meaning of life?"
    }
  ]
}
'
{
  "id": "<string>",
  "object": "<string>",
  "created": 123,
  "model": "<string>",
  "choices": [
    {
      "index": 123,
      "message": {
        "role": "<string>",
        "content": "<string>",
        "reasoning_content": "<string>",
        "tool_calls": [
          {}
        ]
      },
      "finish_reason": "<string>"
    }
  ],
  "usage": {
    "prompt_tokens": 123,
    "completion_tokens": 123,
    "total_tokens": 123,
    "prompt_tokens_details": {
      "cached_tokens": 123,
      "text_tokens": 123,
      "audio_tokens": 123,
      "image_tokens": 123
    },
    "completion_tokens_details": {
      "text_tokens": 123,
      "audio_tokens": 123,
      "reasoning_tokens": 123
    }
  },
  "system_fingerprint": "<string>"
}
Esta página usa la misma operación chat/completions que Crear finalización de chat, con el playground de arriba rellenado previamente para el esquema de chat genérico. Las notas a continuación describen cómo usar este endpoint para solicitar generación de imágenes impulsada por Gemini desde un cliente compatible con OpenAI.
Incluya un modelo de generación de imágenes en model (como gemini-2.0-flash-preview-image-generation), configure stream según lo necesite y proporcione su prompt mediante messages. Opcionalmente también puede incluir contents para añadir contexto multimodal adicional al estilo Gemini junto con messages.

Notas específicas del proveedor

CampoTipoObligatorioDescripción
modelstringIdentificador del modelo de generación de imágenes, por ejemplo gemini-2.0-flash-preview-image-generation.
messages[].contentstringTexto del prompt que describe la imagen deseada.
contentsarrayNoMatriz opcional de contenido al estilo Gemini para contexto multimodal adicional; no forma parte del esquema estándar de chat de OpenAI.
El campo contents es una extensión de DGrid sobre el esquema estándar de chat completions. Le permite pasar parts nativas de Gemini (como inlineData) junto con la matriz messages al estilo OpenAI cuando el modelo de destino lo admite.

Ejemplo: solicitar una imagen

{
  "model": "gemini-2.0-flash-preview-image-generation",
  "stream": false,
  "messages": [
    {
      "role": "user",
      "content": "Generate an image of a futuristic city skyline at sunset."
    }
  ]
}

Campos de respuesta

La respuesta sigue la forma estándar de chat completions. La imagen generada se incrusta directamente en el contenido del mensaje del asistente:
choices
array
Entradas de elección devueltas.
usage
object
Resumen del uso de tokens.

Ejemplo de respuesta

200
{
  "id": "chatcmpl-abc123",
  "model": "gemini-2.0-flash-preview-image-generation",
  "object": "chat.completion",
  "created": 1719859200,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "![generated image](data:image/png;base64,<base64-encoded-image-bytes>)"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 0,
    "total_tokens": 12
  }
}

Autorizaciones

Authorization
string
header
requerido

Your DGrid API key. All endpoints use Authorization: Bearer <DGRID_API_KEY>.

Cuerpo

application/json
model
string
requerido

Target model ID in provider/model-name format.

Ejemplo:

"openai/gpt-4o"

messages
object[]
requerido

Conversation message list.

temperature
number
predeterminado:1

Sampling temperature.

top_p
number
predeterminado:1

Nucleus sampling value.

n
integer
predeterminado:1

Number of choices to generate.

stream
boolean
predeterminado:false

Enable SSE streaming.

max_tokens
integer

Maximum token count.

max_completion_tokens
integer

Max completion-only tokens.

presence_penalty
number
predeterminado:0

Presence penalty.

frequency_penalty
number
predeterminado:0

Frequency penalty.

logit_bias
object

Token bias configuration.

stop

Stop sequence string or array.

tools
object[]

Tool definitions.

tool_choice

Tool selection behavior. Defaults to auto.

response_format
object

Response schema or JSON mode config.

seed
integer

Deterministic seed.

user
string

End-user identifier.

Respuesta

Chat completion result.

id
string

Completion identifier.

object
string

Always chat.completion.

created
integer

Creation timestamp.

model
string

Model that served the request.

choices
object[]

Returned choices.

usage
object

Token usage breakdown.

system_fingerprint
string