Krea 3 API 概览

# Bash + curl + jq. Set KREA_API_KEY to your API token first.
set -euo pipefail
: "${KREA_API_KEY:?Set your Krea API token}"

# 1. Upload a reference
ASSET=$(curl --fail-with-body --silent --show-error --max-time 60 \
  https://api.krea.ai/assets \
  -H "Authorization: Bearer $KREA_API_KEY" \
  -F "file=@reference.png")

IMAGE_URL=$(printf '%s' "$ASSET" | jq -er '.image_url')

# 2. Create an edit
PAYLOAD=$(jq -n --arg image "$IMAGE_URL" '{
  prompt: "Place the product on a clean studio background",
  thinking_mode: "fast",
  image_urls: [$image],
  resolution: "2K"
}')

JOB=$(curl --fail-with-body --silent --show-error --max-time 60 \
  https://api.krea.ai/generate/image/krea/krea-3 \
  -H "Authorization: Bearer $KREA_API_KEY" \
  -H "Content-Type: application/json" \
  -d "$PAYLOAD")

JOB_ID=$(printf '%s' "$JOB" | jq -er '.job_id')

# 3. Get the result
for attempt in $(seq 1 150); do
  JOB=$(curl --fail-with-body --silent --show-error --max-time 30 \
    "https://api.krea.ai/jobs/$JOB_ID" \
    -H "Authorization: Bearer $KREA_API_KEY")
  STATUS=$(printf '%s' "$JOB" | jq -er '.status')
  case "$STATUS" in
    completed)
      printf '%s' "$JOB" | jq -er '.result.urls[0]'
      exit 0 ;;
    failed|cancelled)
      printf 'Job ended: %s\n' "$STATUS" >&2; exit 1 ;;
    scheduled|processing|queued|backlogged|sampling|intermediate-complete)
      sleep 2 ;;
    *) printf 'Unexpected status: %s\n' "$STATUS" >&2; exit 1 ;;
  esac
done
printf 'Polling timed out\n' >&2
exit 1

# Python 3 + requests: pip install requests
# Set KREA_API_KEY to your API token first.
import os
import time
import requests

api = "https://api.krea.ai"
headers = {"Authorization": f"Bearer {os.environ['KREA_API_KEY']}"}

# 1. Upload a reference
with open("reference.png", "rb") as image:
    response = requests.post(
        f"{api}/assets", headers=headers,
        files={"file": image}, timeout=60,
    )
response.raise_for_status()
image_url = response.json()["image_url"]

# 2. Create an edit
response = requests.post(
    f"{api}/generate/image/krea/krea-3",
    headers=headers,
    json={
        "prompt": "Place the product on a clean studio background",
        "thinking_mode": "fast",
        "image_urls": [image_url],
        "resolution": "2K",
    },
    timeout=60,
)
response.raise_for_status()
job_id = response.json()["job_id"]

# 3. Get the result
pending = {"scheduled", "processing", "queued", "backlogged",
           "sampling", "intermediate-complete"}
deadline = time.monotonic() + 300

while time.monotonic() < deadline:
    response = requests.get(
        f"{api}/jobs/{job_id}", headers=headers, timeout=30,
    )
    response.raise_for_status()
    job = response.json()
    if job["status"] == "completed":
        print(job["result"]["urls"][0])
        break
    if job["status"] not in pending:
        raise RuntimeError(f"Job ended: {job['status']}")
    time.sleep(2)
else:
    raise TimeoutError("Polling timed out")

// Node.js 22+. Save as example.mjs.
// Set KREA_API_KEY to your API token first.
import { readFile } from "node:fs/promises";

const token = process.env.KREA_API_KEY;
if (!token) throw new Error("Set your Krea API token");
const api = "https://api.krea.ai";
const headers = { Authorization: `Bearer ${token}` };

async function request(path, options = {}) {
  const response = await fetch(`${api}${path}`, {
    ...options,
    headers: { ...headers, ...options.headers },
    signal: AbortSignal.timeout(60_000),
  });
  if (!response.ok) throw new Error(`HTTP ${response.status}`);
  return response.json();
}

// 1. Upload a reference
const form = new FormData();
form.append("file", new Blob([await readFile("reference.png")]), "reference.png");
const asset = await request("/assets", { method: "POST", body: form });

// 2. Create an edit
const job = await request("/generate/image/krea/krea-3", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    prompt: "Place the product on a clean studio background",
    thinking_mode: "fast",
    image_urls: [asset.image_url],
    resolution: "2K",
  }),
});

// 3. Get the result
const pending = new Set([
  "scheduled", "processing", "queued", "backlogged",
  "sampling", "intermediate-complete",
]);
const deadline = Date.now() + 300_000;
let imageUrl;

while (Date.now() < deadline) {
  const result = await request(`/jobs/${job.job_id}`);
  if (result.status === "completed") {
    imageUrl = result.result.urls[0];
    break;
  }
  if (!pending.has(result.status)) {
    throw new Error(`Job ended: ${result.status}`);
  }
  await new Promise((resolve) => setTimeout(resolve, 2_000));
}
if (!imageUrl) throw new Error("Polling timed out");
console.log(imageUrl);

// npm install @krea-ai/sdk
import { openAsBlob } from "node:fs";
import { Krea } from "@krea-ai/sdk";

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

// 1. Upload a reference
const file = await openAsBlob("./reference.png", { type: "image/png" });
const asset = await krea.assets.upload(file, {
  filename: "reference.png",
});

// 2. Create an edit and wait for the result
const result = await krea.subscribe("image/krea/krea-3", {
  input: {
    prompt: "Place the product on a clean studio background",
    image_urls: [asset.image_url],
    thinking_mode: "fast",
    resolution: "2K",
  },
});

console.log(result.data?.urls[0]);

IMAGE_DATA_URI="data:image/png;base64,$(base64 < ./reference.png | tr -d '\n')"

curl -X POST https://api.krea.ai/generate/image/krea/krea-3 \
  -H "Authorization: Bearer $KREA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Api-Zero-Data-Retention: 1" \
  -d '{
    "prompt": "Change the mug to red, keeping everything else the same",
    "image_urls": ["'"$IMAGE_DATA_URI"'"],
    "thinking_mode": "fast",
    "resolution": "2K"
  }'

// npm install @krea-ai/sdk
import { readFile } from "node:fs/promises";
import { Krea } from "@krea-ai/sdk";

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

const bytes = await readFile("reference.png");
const imageDataUri = `data:image/png;base64,${bytes.toString("base64")}`;

const result = await krea.subscribe("image/krea/krea-3", {
  headers: { "X-Api-Zero-Data-Retention": "1" },
  input: {
    prompt: "Change the mug to red, keeping everything else the same",
    image_urls: [imageDataUri],
    thinking_mode: "fast",
    resolution: "2K",
  },
});

console.log(result.data?.urls[0]);