입력실제 스키마

提示词*prompt

参考图 URLreference_image_urls

Upload images (multiple allowed)

图片尺寸image_size

画幅比例aspect_ratio

No test requests yet. Send your first request.

출력

왼쪽 양식을 실행하세요. 결과, 폴링 상태, cURL이 양식 아래에 표시됩니다.

가격

이 모델은 아래 사용량 항목 기준으로 과금됩니다. 전체 가격 비교.

정가는 USD 기준입니다. 실제 가격은 API 키에 연결된 과금 그룹에 따라 달라집니다.

과금 기준prompt_tokensgemini-3-pro-image

$1.00100만 토큰당~~2/1M~~

과금 기준completion_tokensgemini-3-pro-image

$60.00100만 토큰당~~120/1M~~

과금 기준thoughts_tokensgemini-3-pro-image

$6.00100만 토큰당~~12/1M~~

API

POST/v1beta/models/gemini-3-pro-image:generateContent

const BASE_URL = "https://api.dreamtoai.com";
const API_KEY = process.env.MIX_API_KEY;

const headers = {
  "Authorization": `Bearer ${API_KEY}`,
  "Content-Type": "application/json",
};

const payload = {
  "model": "gemini-3-pro-image",
  "input": {
    "prompt": "修复键盘顶端斑驳痕迹，其他内容不变",
    "reference_image_urls": [
      "https://example.com/reference.png"
    ],
    "image_size": "1K",
    "aspect_ratio": "1:1",
    "mime_type": "image/png",
    "response_modalities": [
      "TEXT",
      "IMAGE"
    ],
    "seed": 12345,
    "callback_url": "https://example.com/webhook"
  }
};

const submit = await fetch(`${BASE_URL}/v1/jobs`, {
  method: "POST",
  headers,
  body: JSON.stringify(payload),
}).then((r) => r.json());

const status = await fetch(`${BASE_URL}/v1/jobs/${submit.id}`, { headers })
  .then((r) => r.json());
console.log(status);

콘솔 → API 키에서 키를 만들고 샘플의 자리표시자를 교체하세요.

README

gemini-3-pro-image

谷歌最强大的图像生成模型

왜 선택해야 할까요?

텍스트→이미지 생성: 자연어 프롬프트를 완성된 이미지로 바꿉니다.
토큰당 과금: 입력 100만 토큰당 $1.00, 출력 100만 토큰당 $60.00, 구독 불필요.
기존 SDK 그대로 사용: Gemini 형식으로 호출할 수 있어 기존 클라이언트는 기본 URL과 키만 바꾸면 됩니다.
키 하나로 모든 모델: 같은 API 키로 dreamtoai의 모든 모델을 사용할 수 있습니다.

파라미터

파라미터	필수	설명
`prompt`string	필수	생성할 내용에 대한 텍스트 설명.
`reference_image_urls`array	선택	결과를 유도할 참조 이미지들.
`image_size`string	선택	출력 이미지 크기. 기본값: `1K`.
`aspect_ratio`string	선택	출력 화면 비율.
`mime_type`enum	선택	参考图 MIME 옵션: `image/png`, `image/jpeg`, `image/webp`. 기본값: `image/png`.
`response_modalities`array	선택	响应模态
`seed`integer	선택	랜덤 시드. 재사용하면 결과를 재현할 수 있습니다.
`callback_url`string	선택	回调地址

사용 방법

여기서 먼저 써 보기 — 로그인한 뒤 위 Playground에서 모델을 실행해 코드를 쓰기 전에 출력을 확인하세요.
API 키 만들기 — 콘솔 → API 키에서 키를 만드세요. 같은 키로 모든 모델을 쓸 수 있습니다.
프롬프트 작성 — 원하는 피사체, 스타일, 구도, 조명을 설명합니다.
선택 파라미터 설정 — 위에 나열된 선택 파라미터를 조정해 출력을 제어하세요.
요청 보내기 — 모델 ID gemini-3-pro-image로 POST /v1beta/models/gemini-3-pro-image:generateContent를 호출하세요.
결과 읽기 — 생성 결과는 응답으로 돌아오고 요청은 콘솔에 기록됩니다.

효과적인 프롬프트 작성법

모델은 프롬프트를 크리에이티브 브리프처럼 읽습니다. 먼저 피사체를 쓰고 중요한 세부 사항을 더하세요.

1. 피사체와 동작

이미지에 누가 또는 무엇이 있고 무엇을 하는지.

2. 스타일과 매체

사진, 3D 렌더, 수채화, 플랫 일러스트 등. 사진 느낌을 원하면 렌즈나 필름을 지정하세요.

3. 구도

프레이밍과 시점: 클로즈업, 와이드, 부감, 중앙 배치, 삼분할.

4. 조명과 색

골든아워, 부드러운 스튜디오 조명, 네온, 파스텔 팔레트, 고대비.

5. 이미지 속 텍스트

정확한 문구를 따옴표로 감싸고 위치를 지정하세요.

상단에 굵은 흰 글씨로 "OPEN LATE" 헤드라인이 있는 포스터.

	프롬프트
약한 예	커피숍
강한 예	비 오는 저녁 모퉁이의 아늑한 커피숍을 정면 창 너머로 본 장면. 실내의 따뜻한 텅스텐 조명, 라테 아트를 붓는 바리스타, 유리의 김서림, 거리의 반사. 35mm 사진, 얕은 심도, 차분한 청록과 앰버 색조.

가격

과금 항목	가격	공식 가격
prompt_tokens	$1.00 100만 토큰당	~~$2.00/1M~~
completion_tokens	$60.00 100만 토큰당	~~$120.00/1M~~
thoughts_tokens	$6.00 100만 토큰당	~~$12.00/1M~~

공식 정가보다 50% 저렴합니다.

예: 입력 10,000토큰, 출력 1,000토큰 요청은 약 $0.07입니다.

정가는 USD 기준입니다. 실제 가격은 API 키에 연결된 과금 그룹에 따라 달라집니다. 전체 가격 비교

전문가 팁

괜찮은 프롬프트는 몇 가지 변형을 먼저 생성한 뒤 세부를 다듬으세요.
첫 문장에 피사체를 두고 스타일과 조명은 그 뒤에 쓰세요.
이미지에 들어갈 글자는 따옴표로 감싸세요.
생성 전에 이미지 용도에 맞는 화면 비율을 고르세요.
모델이 시드를 지원하면 같은 시드로 프롬프트 변경을 공정하게 비교하세요.

Gemini-3.1-flash-lite-image — gemini-3-1-flash-lite-image
gemini-3.1-flash-image — gemini-3-1-flash-image
Nano Banana 2 — nano-banana-2
Nano Banana Pro — nano-banana-pro
Veo 3.1 — veo-3-1

모든 이미지 모델 보기 API 마켓 둘러보기

FAQ

gemini-3-pro-image란 무엇인가요?

谷歌最强大的图像生成模型

gemini-3-pro-image API는 어떻게 호출하나요?

API 키와 모델 ID gemini-3-pro-image로 POST /v1beta/models/gemini-3-pro-image:generateContent를 보내세요. 바로 실행할 수 있는 샘플은 위 API 섹션에 있습니다.

요금은 어떻게 계산되나요?

요청은 위에 표시된 가격으로 지갑에서 청구됩니다. 최종 비용은 사용량과 API 키에 연결된 과금 그룹에 따라 달라집니다.

API 키는 어디서 받나요?

콘솔 → API 키에서 생성하세요. 동일한 키로 게이트웨이의 모든 모델을 사용할 수 있습니다.

출력물을 상업적으로 사용할 수 있나요?

네. 생성한 결과물은 모델 제공사의 약관을 따르는 한 상업 프로젝트에 사용할 수 있습니다.

Google/gemini-3-pro-image