메인 콘텐츠로 건너뛰기
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 작업을 사용하며, 위의 플레이그라운드에는 일반 텍스트 채팅이 미리 입력되어 있습니다. 아래 내용은 구조화된 파트(part)를 사용하여 오디오 이해 또는 생성을 요청하기 위해 generationConfig에 추가할 수 있는 Gemini 네이티브 필드를 설명합니다.
오디오 출력을 요청하려면 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
promptTokenCount, candidatesTokenCount, totalTokenCount를 포함한 토큰 사용 내역입니다.
​
promptFeedback
object
해당하는 경우 프롬프트 차단 관련 피드백입니다.

​
응답 예시

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.