메인 콘텐츠로 건너뛰기
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 작업을 사용하며, 위의 플레이그라운드에는 일반 텍스트 채팅이 미리 입력되어 있습니다. 아래 내용은 제공자별 응답 제어를 통해 이미지를 생성하거나 편집하기 위해 generationConfig에 추가할 수 있는 Gemini 네이티브 필드를 설명합니다.
이미지 출력을 요청하려면 generationConfig.responseModalities를 ["IMAGE"]로 설정하고, 종횡비와 출력 크기를 제어하려면 generationConfig.imageConfig를 사용하세요.

​
Gemini 네이티브 요청 필드

필드유형필수설명
generationConfig.responseModalitiesarray예요청할 모달리티 배열입니다 (예: ["IMAGE"]).
generationConfig.imageConfigobject아니요이미지 설정 객체입니다.
generationConfig.imageConfig.aspectRatiostring아니요생성할 이미지의 종횡비입니다 (예: 1:1).
generationConfig.imageConfig.imageSizestring아니요출력 이미지 크기입니다 (예: 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
모델이 반환한 후보 응답입니다.
​
usageMetadata
object
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.

​
generationConfig
object

Generation configuration.

응답

Generated content candidates.

​
candidates
object[]

Candidate responses returned by the model.

​
usageMetadata
object

Token accounting metadata.