Passer au contenu 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>"
}
Cette page utilise la même opération chat/completions que Créer une complétion de chat, avec le playground ci-dessus prérempli pour le schéma de chat générique. Les notes ci-dessous décrivent comment utiliser ce point de terminaison pour demander une génération d’image pilotée par Gemini depuis un client compatible OpenAI.
Incluez un modèle de génération d’image dans model (tel que gemini-2.0-flash-preview-image-generation), définissez stream selon vos besoins, puis fournissez votre prompt via messages. Vous pouvez aussi inclure contents pour ajouter un contexte multimodal de style Gemini en plus de messages.

Notes spécifiques au fournisseur

ChampTypeRequisDescription
modelstringOuiIdentifiant de modèle de génération d’image, par exemple gemini-2.0-flash-preview-image-generation.
messages[].contentstringOuiTexte du prompt décrivant l’image souhaitée.
contentsarrayNonTableau de contenu facultatif de style Gemini pour un contexte multimodal supplémentaire, non inclus dans le schéma de chat OpenAI standard.
Le champ contents est une extension DGrid superposée au schéma standard chat completions. Il vous permet de transmettre des parts natives Gemini (comme inlineData) en plus du tableau messages de style OpenAI lorsque le modèle cible le prend en charge.

Exemple : demander une image

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

Champs de réponse

La réponse suit la forme standard chat completions. L’image générée est directement intégrée dans le contenu du message assistant :
choices
array
Éléments de choix renvoyés.
usage
object
Résumé d’utilisation des tokens.

Exemple de réponse

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
  }
}

Autorisations

Authorization
string
header
requis

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

Corps

application/json
model
string
requis

Target model ID in provider/model-name format.

Exemple:

"openai/gpt-4o"

messages
object[]
requis

Conversation message list.

temperature
number
défaut:1

Sampling temperature.

top_p
number
défaut:1

Nucleus sampling value.

n
integer
défaut:1

Number of choices to generate.

stream
boolean
défaut:false

Enable SSE streaming.

max_tokens
integer

Maximum token count.

max_completion_tokens
integer

Max completion-only tokens.

presence_penalty
number
défaut:0

Presence penalty.

frequency_penalty
number
défaut: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.

Réponse

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