Skip to main content

인기 모델


개요

Flux, Nano Banana Pro를 비롯한 최첨단 AI 모델을 사용해 텍스트 설명으로부터 이미지를 생성합니다. 이 예시는 생성 요청 전송부터 최종 이미지 수신까지의 전체 워크플로우를 안내합니다.
이미지 생성은 비동기적으로 이루어집니다. 즉시 작업 ID를 받게 되며, 이미지가 준비될 때까지 폴링을 통해 결과를 확인합니다.

인터랙티브 플레이그라운드

다양한 언어로 작성된 전체 예시입니다:
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

const result = await krea.subscribe("image/bfl/flux-1-dev", {
  input: {
    prompt: "a serene mountain landscape at sunset",
    width: 1024,
    height: 576,
    steps: 28
  }
});

console.log(`Image ready: ${result.data?.urls[0]}`);
API 토큰으로 교체하세요위 예시의 YOUR_API_TOKEN 플레이스홀더를 교체하려면 krea.ai/settings/api-tokens에서 API 토큰을 생성해야 합니다. 도움이 필요하다면 API Keys & Billing 페이지의 안내를 따르세요.
사용 가능한 모든 모델을 확인하려면 Model APIs 페이지를 참고하세요.

상세 설명

아래에서는 생성 요청 전송부터 최종 이미지 수신까지의 전체 워크플로우를 단계별로 안내합니다.

1단계: 이미지 생성 작업 만들기

프롬프트와 파라미터를 담아 /generate/image/bfl/flux-1-dev로 POST 요청을 보냅니다. API는 즉시 작업 ID를 반환하며, 생성은 비동기적으로 진행됩니다.
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

const job = await krea.image("bfl/flux-1-dev", {
  prompt: "a serene mountain landscape at sunset",
  width: 1024,
  height: 576,
  steps: 28
});

console.log(`Job ID: ${job.job_id}`);
예시 응답
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "created_at": "2025-01-15T10:30:00.000Z"
}

2단계: 결과 폴링하기

작업이 완료될 때까지 /jobs/{job_id}를 2초마다 폴링하세요. Krea API는 일부 모델에 대해 중간 생성 결과를 제공합니다.
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

async function waitForJob(jobId) {
  const completed = await krea.jobs.wait(jobId, { intervalMs: 2000 });
  return completed.result.urls[0];
}

const imageUrl = await waitForJob(job.job_id);
console.log(`Image ready: ${imageUrl}`);
웹훅을 사용할 수 있습니다!작업이 완료될 때 알림을 받으려면 웹훅을 설정하세요. 시작하려면 Webhooks 가이드를 참고하세요.
모든 모델의 자세한 파라미터 목록은 Model APIs 페이지를 확인하세요.
완료된 응답 예시
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "created_at": "2025-01-15T10:30:00.000Z",
  "completed_at": "2025-01-15T10:30:25.000Z",
  "result": {
    "urls": [
      "https://krea.ai/generations/your-image.png"
    ]
  }
}
가능한 모든 작업 상태와 전체 작업 생명주기에 대해 알아보려면 Job Lifecycle 페이지를 확인하세요.