Skip to main content

​
热门模型

​
概述

使用 Flux、Nano Banana Pro 以及其他前沿 AI 模型，从文本描述生成图像。本示例将带你完成从提交生成请求到获取最终图像的完整流程。
图像生成是异步的。你会立即收到一个 job ID，然后需要轮询结果，直到图像生成完成。

​
交互式 Playground

以下是不同语言的完整示例： 
// 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 Token要替换上述示例中的 YOUR_API_TOKEN 占位符，你需要在 krea.ai/settings/api-tokens 生成一个 API token。如果需要帮助，请参考 API Keys & Billing 页面上的说明。
要查看所有可用模型，请访问 Model APIs 页面。

​
分步说明

下面我们将带你完成从提交生成请求到获取最终图像的完整流程。

​
步骤 1：创建图像生成任务

向 /generate/image/bfl/flux-1-dev 发送 POST 请求，附带你的提示词和参数。API 会立即返回一个 job 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：轮询结果

每 2 秒轮询一次 /jobs/{job_id}，直到任务完成。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 页面。