Image 제공: Google

Imagen 4 API

얼굴과 조명 표현에 강한 Google의 포토리얼 모델.

Imagen 4을(를) 단 한 번의 API 호출로 통합하세요. 하나의 키, 하나의 통합 엔드포인트, 그리고 Apiframe의 모든 모델에 적용되는 통합 청구.

API 키 받기 Apiframe Studio에서 사용 Imagen 4 API 문서 보기

model: "imagen-4"

Imagen 4 breathtaking mountain range at dawn with a crystal-clear lake reflecting the snow-capped peaks

Imagen 4의 특별한 점

1:1, 9:16, 16:9을(를) 포함한 5가지 화면 비율 지원.
빠른 처리 — 생성당 평균 약 15초.
Google 계정 없이 사용한 만큼 지불. 성공한 생성에 대해서만 비용을 지불합니다.
Apiframe의 모든 모델에서 하나의 API 키, 통합 청구, 멱등성, 웹훅을 지원.

Imagen 4(으)로 제작

Apiframe의 Imagen 4 API로 생성한 출력 예시입니다.

Imagen 4 magazine cover reading 'WILD' with a bold serif title and a close-up of a tiger's eye — A magazine cover reading 'WILD' with a bold serif title and a close-up of a tiger's eye.

Imagen 4 ultra-detailed product shot of a leather watch on linen in soft window light with fine texture — An ultra-detailed product shot of a leather watch on linen, soft window light, fine texture.

Imagen 4 watercolor illustration of a quiet Parisian street cafe in the rain — A watercolor illustration of a quiet Parisian street cafe in the rain.

Imagen 4 vertical 9:16 jazz night poster reading 'BLUE ROOM, FRIDAY 9PM' with art-deco type — A vertical 9:16 poster for a jazz night reading 'BLUE ROOM, FRIDAY 9PM' with art-deco type.

Imagen 4 photorealistic close-up of dew droplets on a spiderweb at sunrise with crisp detail — A photorealistic close-up of dew droplets on a spiderweb at sunrise, crisp detail.

개요

엔드포인트: POST /v2/images/generate
모델 ID: imagen-4
파라미터 키: imagenParams
모달리티: 이미지
제공업체: Google
평균 완료 시간: ~15s

기능

화면 비율1:1, 9:16, 16:9, 3:4, 4:3

평균 시간~15초

빠른 시작

API 키와 함께 POST /v2/images/generate 요청을 한 번 보내면 Imagen 4로 생성이 시작됩니다. 응답으로 폴링하거나 웹훅으로 받을 수 있는 jobId가 반환됩니다.

curl -X POST https://api.apiframe.ai/v2/images/generate \
  -H "X-API-Key: afk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
        "prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
        "model": "imagen-4",
        "imagenParams": {
            "image_size": "1K",
            "output_format": "jpg"
        }
    }'

import requests

response = requests.post(
    "https://api.apiframe.ai/v2/images/generate",
    headers={
        "X-API-Key": "afk_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={
        "prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
        "model": "imagen-4",
        "imagenParams": {
            "image_size": "1K",
            "output_format": "jpg"
        }
    },
)
print(response.json())  # { "jobId": "...", "status": "QUEUED" }

const response = await fetch("https://api.apiframe.ai/v2/images/generate", {
  method: "POST",
  headers: {
    "X-API-Key": "afk_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
    "model": "imagen-4",
    "imagenParams": {
      "image_size": "1K",
      "output_format": "jpg"
    }
  }),
});
const { jobId } = await response.json();
console.log(jobId);

응답 및 작업 수명 주기

생성은 비동기로 처리됩니다. 제출이 성공하면 202 Accepted와 jobId가 반환됩니다. 상태가 COMPLETED가 될 때까지 GET /v2/jobs/{id}를 폴링하거나 webhook_url을 지정하면 result 필드에 출력 URL이 담깁니다.

1. 제출 응답 (202)

{
  "jobId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
  "status": "QUEUED"
}

2. 결과 폴링

curl https://api.apiframe.ai/v2/jobs/JOB_ID \
  -H "X-API-Key: afk_your_api_key_here"

import requests, time

while True:
    job = requests.get(
        "https://api.apiframe.ai/v2/jobs/JOB_ID",
        headers={"X-API-Key": "afk_your_api_key_here"},
    ).json()
    if job["status"] in ("COMPLETED", "FAILED"):
        break
    time.sleep(2)
print(job["result"])

let job;
do {
  await new Promise((r) => setTimeout(r, 2000));
  job = await fetch("https://api.apiframe.ai/v2/jobs/JOB_ID", {
    headers: { "X-API-Key": "afk_your_api_key_here" },
  }).then((r) => r.json());
} while (job.status !== "COMPLETED" && job.status !== "FAILED");
console.log(job.result);

입력 스키마

Imagen 4 엔드포인트가 허용하는 요청 파라미터입니다. 모델별 옵션은 아래에 표시된 파라미터 객체 안에 중첩됩니다.

파라미터	유형	필수	기본값	허용값 / 범위	설명
prompt	string	필수	—	—	생성할 내용에 대한 텍스트 설명.
model	string	필수	"imagen-4"	"imagen-4"	이 엔드포인트의 모델 식별자.
imagenParams.image_size	string	선택	"1K"	"1K", "2K"	Resolution
imagenParams.output_format	string	선택	"jpg"	"jpg", "png"	Output format

자주 묻는 질문

Imagen 4 API에 대한 일반적인 질문입니다.

Imagen 4 API가 있나요?

네. Apiframe는 단일 REST 엔드포인트(`POST /v2/images/generate`, `model: "imagen-4"`)로 Imagen 4을(를) 제공합니다. 지원되는 모든 모델에서 통합된 API, 키, 청구를 사용할 수 있으며 별도의 Google 계정이 필요하지 않습니다.

Imagen 4 API 비용은 얼마인가요?

Imagen 4은(는) Apiframe에서 간단한 사용량 기반 과금을 사용하며, 성공한 생성에 대해서만 비용을 지불합니다. 요금제와 대량 할인은 가격 페이지를 참고하세요.

Imagen 4 API는 어떻게 호출하나요?

`X-API-Key`와 `model: "imagen-4"`을(를) 포함한 JSON 본문을 담아 `/v2/images/generate`에 POST 요청을 보냅니다. 응답으로 반환되는 `jobId`를 `GET /v2/jobs/{id}`로 폴링하거나 웹훅으로 결과를 받습니다.

Imagen 4은(는) 어떤 파라미터를 지원하나요?

Imagen 4은(는) 공통 `prompt`, `webhook_url` 필드와 함께 `imagenParams` 아래에 중첩된 2개의 모델별 파라미터를 허용합니다. 유형과 기본값을 포함한 전체 목록은 위의 입력 스키마를 참고하세요.

아직 궁금한 점이 있으신가요?

고객 지원 문의 Discord 참여

Imagen 4 API로 개발을 시작하세요

API 키를 받아 몇 분 만에 Imagen 4을(를) 통합하세요 — 사용한 만큼 지불.

무료 크레딧으로 시작

모든 모델을 위한 하나의 API

웹훅, SDK 및 멱등성

제공업체 계정 불필요

무료로 시작하기 문서 읽기

궁금하신 점이 있으신가요? Discord에 참여하거나 영업팀에 문의하세요.