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}`);
Webhook が利用できます!Webhook を設定すると、ジョブ完了時に通知を受け取れます。詳しくは 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 ページをご覧ください。