跳轉到主要內容
POST
/
v1
/
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 原生欄位，以便透過結構化 parts 請求音訊理解或音訊生成。
請將 generationConfig.responseModalities 設為 ["AUDIO"] 以要求音訊輸出，並設定 generationConfig.speechConfig.voiceConfig.prebuiltVoiceConfig.voiceName 來選擇生成語音時要使用的預建聲音。

​
Gemini 原生請求欄位

欄位類型必填說明
generationConfig.responseModalitiesarray是要求的回應模態，例如 ["AUDIO"]。
generationConfig.speechConfigobject否語音設定物件。
generationConfig.speechConfig.voiceConfigobject否聲音設定包裝物件。
generationConfig.speechConfig.voiceConfig.prebuiltVoiceConfigobject否預建聲音設定。
generationConfig.speechConfig.voiceConfig.prebuiltVoiceConfig.voiceNamestring否預建聲音名稱，例如 Kore。
當你需要音訊輸出時，請在 model 路徑參數中使用具備文字轉語音能力的模型，例如 gemini-2.5-flash-preview-tts。

​
範例：請求語音音訊

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Say cheerfully: Have a wonderful day!" }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": ["AUDIO"],
    "speechConfig": {
      "voiceConfig": {
        "prebuiltVoiceConfig": {
          "voiceName": "Kore"
        }
      }
    }
  }
}

​
回應欄位

回應遵循標準 generateContent 結構。當要求音訊輸出時，回傳的 parts 會包含內嵌音訊資料而非文字：
​
candidates
array
模型回傳的候選回應。
​
usageMetadata
object
Token 計量資訊，包括 promptTokenCount、candidatesTokenCount 與 totalTokenCount。
​
promptFeedback
object
在適用情況下的 prompt 阻擋回饋資訊。

​
回應範例

200
{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "inlineData": {
              "mimeType": "audio/L16;codec=pcm;rate=24000",
              "data": "<base64-encoded-audio-bytes>"
            }
          }
        ]
      },
      "finishReason": "STOP",
      "safetyRatings": []
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 10,
    "candidatesTokenCount": 0,
    "totalTokenCount": 10
  }
}

授權

​
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.

​
generationConfig
object

Generation configuration.

回應

Generated content candidates.

​
candidates
object[]

Candidate responses returned by the model.

​
usageMetadata
object

Token accounting metadata.