Gemini 原生格式 - DGrid AI Docs

Generate content (Gemini)

curl --request POST \
  --url https://api.dgrid.ai/v1/models/{model}:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Hello from DGrid."
        }
      ]
    }
  ]
}
'

{
  "candidates": [
    {
      "content": {
        "role": "<string>",
        "parts": [
          {}
        ]
      },
      "finishReason": "<string>",
      "safetyRatings": [
        {}
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 123,
    "candidatesTokenCount": 123,
    "totalTokenCount": 123
  }
}

POST

models

{model}

:generateContent

Generate content (Gemini)

curl --request POST \
  --url https://api.dgrid.ai/v1/models/{model}:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Hello from DGrid."
        }
      ]
    }
  ]
}
'

{
  "candidates": [
    {
      "content": {
        "role": "<string>",
        "parts": [
          {}
        ]
      },
      "finishReason": "<string>",
      "safetyRatings": [
        {}
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 123,
    "candidatesTokenCount": 123,
    "totalTokenCount": 123
  }
}

本頁使用與生成內容（Gemini）相同的 generateContent 操作，上方 playground 已預先填入純文字對話範例。以下說明可加入 generationConfig 的 Gemini 原生欄位，以便透過供應商特定的回應控制來生成或編輯圖像。

請將 generationConfig.responseModalities 設為 ["IMAGE"] 以要求圖像輸出，並使用 generationConfig.imageConfig 控制長寬比與輸出尺寸。

Gemini 原生請求欄位

欄位	類型	必填	說明
`generationConfig.responseModalities`	array	是	要求的模態陣列，例如 `["IMAGE"]`。
`generationConfig.imageConfig`	object	否	圖像設定物件。
`generationConfig.imageConfig.aspectRatio`	string	否	生成圖像的長寬比，例如 `1:1`。
`generationConfig.imageConfig.imageSize`	string	否	輸出圖像尺寸，例如 `1024x1024`。

請在 model 路徑參數中使用具備圖像生成能力的模型，例如 gemini-2.0-flash-preview-image-generation。

範例：生成圖像

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "A photorealistic image of a corgi wearing sunglasses on a beach." }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": ["IMAGE"],
    "imageConfig": {
      "aspectRatio": "1:1",
      "imageSize": "1024x1024"
    }
  }
}

回應欄位

回應遵循標準 generateContent 結構。當要求圖像輸出時，回傳的 parts 會包含內嵌圖像資料：

candidates

array

模型回傳的候選回應。

顯示 candidate properties

content

object

生成內容物件。

顯示 content properties

role

string

生成內容區塊中回傳的角色，通常為 model。

parts

array

回傳的內容 parts。對於圖像輸出，每個 part 都會包含 inlineData 物件，其中含有 mimeType（例如 image/png）與 base64 編碼的 data。

finishReason

string

完成原因字串，例如 STOP。

safetyRatings

array

安全評估結果。

usageMetadata

object

Token 使用中繼資料，包括 promptTokenCount、candidatesTokenCount 與 totalTokenCount。

回應範例

200

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "<base64-encoded-image-bytes>"
            }
          }
        ]
      },
      "finishReason": "STOP",
      "safetyRatings": []
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 14,
    "candidatesTokenCount": 0,
    "totalTokenCount": 14
  }
}

授權

Authorization

string

header

必填

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

路徑參數

model

string

必填

Target model ID, such as gemini-1.5-pro.

主體

application/json

contents

object[]

Input content array with role and parts.

Show child attributes

generationConfig

object

Generation configuration.

Show child attributes

回應

Generated content candidates.

candidates

object[]

Candidate responses returned by the model.

Show child attributes

usageMetadata

object

Token accounting metadata.

Show child attributes

建立引擎嵌入

OpenAI 對話格式

⌘I

​Gemini 原生請求欄位

​範例：生成圖像

​回應欄位

​回應範例

授權

路徑參數

主體

回應

Gemini 原生請求欄位

範例：生成圖像

回應欄位

回應範例