Use Krea 2 Large with Comfy Router

Call krea/krea-2-large through Comfy Router: endpoint, request shape and the response Router returns.

API Reference for krea/krea-2-large, served by Comfy Router from Krea.

Quick start

Create a key in your Comfy workspace and export it as COMFY_API_KEY. The Python and TypeScript snippets use the Comfy SDKs (pip install comfy-sdk, npm install @comfyorg/sdk); the cURL snippet is the same call over raw HTTP.

Model ID: krea/krea-2-large

Endpoint: POST https://api.comfy.org/v2/models/krea/krea-2-large

Python

from comfy_sdk import Comfy

# Reads COMFY_API_KEY from the environment.
# The SDK automatically creates an idempotency key and reuses it for automatic retries.
with Comfy() as client:
    result = client.models.run(
        "krea/krea-2-large",
        {
            "aspect_ratio": "1:1",
            "prompt": "a red circle",
            "resolution": "1K",
        },
    )

print(result)

Schema

Input

aspect_ratio · string · required

Aspect ratio. One of: 1:1, 4:3, 3:2, 16:9, 2.35:1, 4:5, 2:3, 9:16.

Possible values: 1:1, 4:3, 3:2, 16:9, 2.35:1, 4:5, 2:3, 9:16

creativity · string · default: "\"medium\""

Prompt interpretation strength: raw=0, low=10, medium=50, high=100.

Possible values: raw, low, medium, high

image_style_references · object[]

Style references to use for the generation

image_style_references[].strength · number · required

Range: -2 to 2

Format: double

image_style_references[].url · string (uri)

Format: uri

moodboards · object[]

Moodboards to use for generation. Currently limited to one moodboard.

moodboards[].id · string (uuid) · required

Format: uuid

moodboards[].strength · number · default: "0.35"

Range: -0.5 to 1.5

Format: double

prompt · string · required

resolution · string · required

Resolution scale. One of: 1K.

Possible values: 1K

seed · number

styles · object[]

Styles (typically LoRAs) to use for the generation

styles[].id · string · required

styles[].strength · number · required

Range: -2 to 2

Format: double

Generated from the schema Router serves at GET /v2/models/krea/krea-2-large/openapi.json, the same document it validates a call against before the request reaches the provider.

Output

completed_at · string (date-time) · required

Format: date-time

created_at · string (date-time) · required

Format: date-time

job_id · string (uuid) · required

Format: uuid

result · object · required

The finished generation. Not nullable here, unlike on KreaJob: a terminal job whose result carries no urls is answered as a Comfy Router error, so a 200 always carries it.

result.style_id · string

Set by loraTraining jobs rather than by a generation; a 200 for these models carries urls.

result.urls · string (uri)[] · required

The generated images, as downloadable links. At least one, because a completed job with an empty urls is success_without_output and never reaches this document.

status · string · required

Always completed on this document: it is the only status classifyKrea answers succeeded on, and Krea’s vocabulary is matched without a case fold.

Possible values: completed

Examples

Input

{
  "aspect_ratio": "1:1",
  "prompt": "a red circle",
  "resolution": "1K"
}

Output

{
  "completed_at": "2027-01-01T00:00:37Z",
  "created_at": "2027-01-01T00:00:00Z",
  "job_id": "7f1c2e84-5b90-4a37-8d61-2c0f9ab4e153",
  "result": {
    "urls": [
      "https://example.invalid/krea/krea-2/generated.png"
    ]
  },
  "status": "completed"
}

Before you ship

The SDKs create an Idempotency-Key and reuse it for automatic retries. For manual retries, reuse the original key. Router can hold the connection for up to 10 minutes.

When a request fails, Router sends an X-Comfy-Error-Type response header explaining why. A 422 means Router rejected the input before calling the provider. Download generated assets promptly because result URLs can expire.

Headers

Authentication, idempotency, request IDs, error buckets, retry pacing, spend limits.

Using the Router API

Model discovery, validation errors, retries, and billing.

Limitations

What Router does not do today, and what to use instead.