> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Gemini API: 답변, 근거 출처, 상품 카드

> Google Gemini에 질문하고 답변, 근거 출처, 상품, 장소, 동영상을 받습니다.

`GEMINI`는 Google Gemini에 묻고, 답변과 그 근거가 된 출처를 반환합니다.

| | |
| - | - |
| taskType | `GEMINI` |
| 읽는 필드 | `prompt` (없으면 `query`) |
| 크레딧 | 1.25 |
| 국가 | 선택, 기본값 `US`. `CN`은 미국 출구에서 베이징 기기 위치로 묻습니다. |
| 위치 | `payload.location`을 받습니다. [지역과 위치](/ko/engines/capacity.md)를 참고하세요. |

## 요청

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "GEMINI", "payload": { "prompt": "best CRM for a small team", "country": "US" } }'
```

## 응답

| 필드 | 타입 | 설명 |
| - | - | - |
| `text` | string | 답변. 항상 있습니다. |
| `sources` | array | 근거 출처: `position`, `url`, `label`, `description`, `confidence_level`(0-100). 항상 있습니다. |
| `model` | string | Gemini가 답변에 쓴 모델(알 수 있을 때). |
| `markdown` | string | Markdown 답변. `include.markdown`일 때만. |
| `shoppingCards` | array | 답변 안에 그린 상품 카드: `title`, `position`, `price`(`value`, `currency`, `raw`), `store`, `rating`, `reviews`, `thumbnail`, `productLink`. |
| `inlineProducts` | array | 답변 안에 링크된 상품 이름: `title`, `position`, `productLink`. |
| `map` | array | 답변에 나온 장소: `name`, `position`, `placeId`, `location`, `phoneNumber`, `url`, `mapsUrl`, `reviews`, `category`. |
| `videos` | array | YouTube 카드: `title`, `url`, `medium`, `thumbnail`, `source`, `duration`. |
| `images` | array | 답변과 함께 나온 이미지. |
| `weather` | object | 답변에 날씨 위젯이 나올 때의 Gemini 날씨 위젯. |
| `rawResponse` | array | 스트림 프레임. `include.rawResponse`일 때만. |

상품, 장소, 동영상, 날씨 필드는 답변에 나올 때만 실립니다.

예시:

```json theme={"theme":"css-variables"}
{
  "text": "For a small team, HubSpot CRM and Pipedrive are strong choices ...",
  "sources": [
    { "position": 1, "url": "https://www.example.com/crm-guide", "label": "CRM guide for small teams", "confidence_level": 87 }
  ],
  "model": "...",
  "shoppingCards": [
    {
      "title": "Acme Desk Phone",
      "position": 1,
      "price": { "value": 249.99, "currency": "$", "raw": "$249.99" },
      "store": "Northwind Electronics",
      "rating": 4.7,
      "reviews": "14292",
      "thumbnail": "https://...",
      "productLink": "https://google.com/search?...&ibp=oshop..."
    }
  ]
}
```

카드 이름은 `text`에도 남고, 문장 속 상품 링크는 Google 상품 페이지를 가리킵니다. YouTube 카드는 Gemini가 그린 자리에 링크된 썸네일로 `text`와 `markdown`에 나옵니다. Gemini가 계산을 위해 코드를 실행하면 답변은 Gemini가 밝힌 결과이며, 코드와 그 출력은 빠집니다.

## include 플래그

| 플래그 | 효과 |
| - | - |
| `markdown` | `markdown`을 추가합니다. |
| `rawResponse` | `rawResponse`를 추가합니다. |
| `html` | Gemini가 보여 준 화면인 `html`을 추가합니다. [HTML 페이지](/ko/engines/html-pages.md)를 참고하세요. |
| `analysis` | `analysis`를 추가합니다. 1크레딧. [답변 분석](/ko/engines/answer-analysis.md)을 참고하세요. |
| `citationAnalysis` | 답변에 [Citation Analysis](/ko/research/citation-analysis.md)를 실행합니다. |

`searchQueries`, `ads`, `shopping`은 효과가 없습니다. [Markdown과 원본 응답](/ko/engines/response-options.md)을 참고하세요.

## 관련 문서

* [Gemini 제품 페이지](https://querying.ai/ko/engines/gemini)
* [엔진 개요](/ko/engines/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.