이미지 생성 / 편집

Gemini 기본 API로 이미지를 생성하거나 프롬프트로 참조 이미지를 편집합니다.

POST/v1beta/models/{model}:generateContent

프롬프트로 이미지를 생성하거나 같은 요청에 참조 이미지를 포함해 편집합니다.

인증

bearerAuth

인증Bearer <token>

전달 위치: header

경로 매개변수

model*string

플랫폼 이미지 모델 ID.

요청 본문

application/json

TypeScript 타입 정의

TypeScript에서 request body 타입을 사용하세요.

contents*array<>

현재 입력과 선택적 기록을 순서대로 전달하세요. 다중 턴 편집 시 각 부분의 thoughtSignature를 포함한 이전 모델의 content를 그대로 기록에 추가하세요.

항목1 <= items

generationConfig?

이미지 출력 설정.

응답 본문

`application/json`

curl -X POST "https://example.com/v1beta/models/MODEL_ID:generateContent" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "부드러운 창빛과 단순한 배경을 살려 창턱 위 주황색 도자기 꽃병 사진을 생성하세요."
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": [
        "IMAGE"
      ],
      "imageConfig": {
        "aspectRatio": "1:1"
      }
    }
  }'

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "BASE64_BYTES"
            },
            "thoughtSignature": "THOUGHT_SIGNATURE"
          }
        ]
      },
      "finishReason": "STOP"
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 23,
    "candidatesTokenCount": 1206,
    "totalTokenCount": 1925,
    "trafficType": "ON_DEMAND",
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 23
      }
    ],
    "candidatesTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 86
      },
      {
        "modality": "IMAGE",
        "tokenCount": 1120
      }
    ],
    "thoughtsTokenCount": 696
  },
  "modelVersion": "MODEL_ID",
  "createTime": "2026-11-06T18:28:55.590821Z",
  "responseId": "RESPONSE_ID"
}

Google Gemini 이미지 생성 및 편집 가이드이미지 요청, 응답 및 다중 턴 편집을 확인하세요.

인증

경로 매개변수

요청 본문

응답 본문

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`