Skip to content

feat(catalog): add Krea image and video generation - #509

Open
ironman5366 wants to merge 1 commit into
superdesigndev:mainfrom
ironman5366:vendor/krea
Open

ironman5366 wants to merge 1 commit into
superdesigndev:mainfrom
ironman5366:vendor/krea

Conversation

@ironman5366

Copy link
Copy Markdown

Summary

  • List Krea (krea) as an AI-generation API-key provider: Authorization: Bearer <key>, https://api.krea.ai, free probe GET /jobs?limit=1.
  • Curate 11 endpoints: the free job poll (video-gen.task.status), five image routes (Krea 2 Turbo, Krea 2 Large, FLUX.1 [dev], FLUX.1 Kontext [dev], Nano Banana Pro) and five video routes (Seedance 2.5, Veo 3.1 Fast, Wan 3.0, Hailuo 2.3, MiniMax H3 Max Turbo). Five join existing per-model rows (image-gen.gemini-3-pro-image.generate, video-gen.seedance-2-5.generate, video-gen.veo-3-1-fast.generate, video-gen.wan-3-0.from_text, video-gen.hailuo.from_text); five Krea-hosted models are proposed as new per-model keys.
  • Every price is read from the machine-readable rate card in the OpenAPI document (x-krea-pricing per operation, source: rate_card_api). Dollars per completed job, so every row is platform-eligible; platform_key_krea slot added in config.py (enabling it is your ops call).
  • Test-list additions, a neutral "K" lettermark, and the AI-generation comparison test extended for the new shared rows.

Contact: support@krea.ai (Krea is the vendor; this PR was raised by Krea's growth team.)

Eligibility

Probe (live 2026-09-15 21:40 UTC)

  • Bogus key GET https://api.krea.ai/jobs?limit=1HTTP 401 {"message":"Unauthorized"} (same body on /usage, /styles, /assets, /node-apps, and on a bogus POST /generate/image/krea/krea-2/medium-turbo; a request with no header answers the same).
  • Valid key → HTTP 200 {"items":[…],"next_cursor":…}.

Self-verification ledger (2026-09-15)

Meter: Krea's own API-debit ledger (gpu_time_transactions.api_debit_microdollars, pass_type='api', one DEBIT row per completed job), read from Krea's warehouse replica by job id. The API exposes no per-call charge field or balance route; the dashboard's API-balance card is the customer-visible view of the same ledger. No verified: stamps and no example files in this PR.

endpoint http test target charge observed (USD) catalog price matches? evidence
krea.jobs.get 200 a completed job id 0 free no DEBIT row for a read; status=completed
krea.image-gen.krea-2-turbo 200 1:1, 1K, creativity low 0.015000 per_success 0.015 ledger DEBIT 15,000 µ$ at 21:51:15Z, job c02ad7cd
krea.image-gen.krea-2-large 200 1:1, 1K, creativity low 0.060000 per_success 0.06 DEBIT 60,000 µ$, job e3c39f38
krea.image-gen.flux-1-dev 200 1024×1024, 25 steps 0.003169 per_success 0.007 ⚠️ metered BELOW card DEBIT 3,169 µ$ for 4,225 ms GPU time, job c3354a13 — see note in the YAML; $0.007 kept as the card price / reserve
krea.image-gen.flux-kontext-dev 200 edit of a Krea-hosted PNG 0.021000 per_success 0.021 DEBIT 21,000 µ$, job d077e195
krea.image-gen.nano-banana-pro 200 1:1, 1K 0.150000 table 1K → 0.15 DEBIT 150,000 µ$, job 7c56621e
krea.video-gen.seedance-2-5 200 480p, 4 s, no audio 0.431200 0.1078 × 4 = 0.4312 DEBIT 431,200 µ$, job ddeba1cf (completed after 5 min 18 s)
krea.video-gen.veo-3-1-fast 200 720p, 4 s, no audio 0.336000 table → 0.336 DEBIT 336,000 µ$, job 3285986c
krea.video-gen.wan-3-0 200 480p, 2 s 0.150000 0.075 × 2 = 0.15 DEBIT 150,000 µ$, job 7c32b16b
krea.video-gen.hailuo-2-3 200 768p, 6 s 0.294000 table → 0.294 DEBIT 294,000 µ$, job 971eb947
krea.video-gen.h3-max-turbo 200 480p, 5 s 0.031251 0.00625 × 5 = 0.03125 ✅ (1 µ$ rounding) DEBIT 31,251 µ$, job d2a8d4fc

Total metered: $1.491620 for the ten generations. All ten jobs completed (6 s to 5 min 18 s) and returned one URL each under result.urls. Every DEBIT row has api_otc_portion_ms = 0, so the whole charge came from the prepaid API balance.

Rate-card note: the marketing page https://www.krea.ai/features/api rounds and lags the per-operation x-krea-pricing card (it shows Flux at $0.04 and Flux Kontext at $0.04; the card and the meter say $0.007 / $0.021). The YAML follows the card, and the card was confirmed by the meter on 9 of 10 rows.

Full-surface map (115 OpenAPI paths, 2026-09-15)

Catalogued (11): GET /jobs/{id}; POST /generate/image/krea/krea-2/medium-turbo, /generate/image/krea/krea-2/large, /generate/image/bfl/flux-1-dev, /generate/image/bfl/flux-1-kontext-dev, /generate/image/google/nano-banana-pro; POST /generate/video/bytedance/seedance-2-5, /generate/video/google/veo-3.1-fast, /generate/video/alibaba/wan-3.0, /generate/video/minimax/hailuo-2.3, /generate/video/minimax/h3-max-turbo.

Excluded (reason):

  • Image, 22 more routes (/generate/image/*: Krea 2 Medium, Flux 1.1 Pro / Ultra, Nano Banana, Nano Banana 2 / 2 Lite, Ideogram 2 Turbo / 3, Seedream 4 / 5 Lite / 5 Pro, Luma UNI-1, Muse Image, ChatGPT Image, Grok Imagine 2 / 2 Edit): priced on the card but no shared shelf yet — extended-tier candidates from the OpenAPI. openai/gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst, bytedance/seededit, qwen/2512, runway/gen-4-image, z-image/z-image: no price on the rate card yet, so they cannot carry a cost block (GPT Image 2 / 2.5 would otherwise join the existing shared rows — we will add them when the card covers them).
  • Video, 30 more routes (/generate/video/*: Wan 2.1 / 2.2 / 2.5, Flux 3 Video, Seedance 2.0 / 2.0 Fast / 2.0 Mini, Veo 2 / 3 / 3 Fast / 3.1 / 3.1 Lite, Kling 2.5 / 2.6 / 3.0 / o1, LTX 2.3 / 2.5 Fast / 2.5 Pro, Ray 2, H3 Max / H3, Hailuo / Hailuo 02, Runway Gen-4 / 4.5, Vidu Q3, Grok Imagine / 1.5): priced, same extended-tier reasoning; the curated set keeps the cheapest tier (H3 Max Turbo), the flagship (Seedance 2.5) and the three cross-provider joins. flux-video-edit, seedance-1.0-pro, seedance-1.0-pro-fast, gemini-omni-flash / 1.1, h3-max-camera-controls: no price on the card.
  • Enhance, 16 routes (/generate/enhance/*: Krea Enhance, Krea Legacy, Topaz family, SeedVR2, Flux Upscale, Ruby): no price on the rate card for any of them, so no cost block is possible today.
  • 3D, 10 routes (/generate/3d/*) and audio, 5 routes (/generate/audio/*): no 3d-gen / audio-gen platform slug exists in capabilities.yaml, and platforms cannot be proposed from a provider file. Five 3D routes are priced ($0.021–$0.40 per request); if you add the slugs we will curate them.
  • GET /jobs, DELETE /jobs/{id}, GET/POST/DELETE /assets*, GET/PATCH /styles*, POST /styles/train, /styles/{id}/share/*, /node-apps*, POST /export/3d: own-account management, uploads, LoRA training and user-defined workflows — not comparable generation jobs. (POST /assets is a free way to host inputs; treg host covers the same need.)
  • GET /usage: own-account compute-unit report, enterprise-plan entitlement only, and it excludes direct-API jobs — not the API meter.

Test plan

  • uv run --frozen python scripts/catalog_validate.pyOK — 102 provider file(s), 3346 endpoint(s), 0 error(s), 0 warning(s)
  • uv run --frozen --with pytest-xdist pytest -n auto -q → 4,098 passed, 8 skipped (after regenerating the plugin skill's provider count with scripts/build_plugin.py and recording Krea's documented 402 in capacity/signatures.py)
  • Maintainer live bogus-key POST /connections/token and catalog_verify.py krea with an independent key — email the contact above for a funded test key

No credential value is in this PR. verified: stamps and example responses are left for the maintainers.

List Krea as an AI-generation API-key provider with 11 curated endpoints:
the free job poll, five image routes (Krea 2 Turbo, Krea 2 Large, FLUX.1
dev, FLUX.1 Kontext dev, Nano Banana Pro) and five video routes (Seedance
2.5, Veo 3.1 Fast, Wan 3.0, Hailuo 2.3, MiniMax H3 Max Turbo). Prices come
from the x-krea-pricing rate card in the OpenAPI document. Nine of ten test
charges match the card on the API-debit ledger; FLUX.1 dev metered below it
and its note says so.

Also: platform_key_krea slot, Krea's documented 402 out-of-credits signature,
the comparison-row test extended for the new shared model rows, and the
plugin skill regenerated for the provider count.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@github-actions github-actions Bot added area:dashboard The web dashboard / landing / tutorials area:docs Documentation & design fragments labels Sep 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:dashboard The web dashboard / landing / tutorials area:docs Documentation & design fragments

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant