K

Krea 3 API

最大8枚の参照画像を編集または合成して、1Kまたは2Kの画像を1枚生成します。

1K
FAL ≈$0.025 / 枚
2K
FAL ≈$0.10 / 枚

価格を比較

同じ出力仕様でチャネルの公開価格を比較

他のモデルと比較
出力仕様チャネルチャネルの公開価格所要時間試す
1K
FAL
試す
2K
FAL
試す
料金の注記

実際にジョブを実行したチャネルの価格で請求されます。フェイルオーバーでチャネルが切り替わると、コストや所要時間が変わる場合があります。

API を使う

コーディングエージェントにコードを任せる、MCP や Skill で会話の中で生成する、または SDK・OpenAI 互換 API で自分で組み込めます。

コーディングエージェントに組み込ませる

組み込み用プロンプトをコピーするか、Codex や Claude で直接開いてください。エージェントがこのページとモデル仕様を読み、送信・待機・結果処理をプロジェクトに書き込みます。

Yir MCP サーバーを追加

ChatGPT、Claude、Cursor に接続し、会話で @Yir と Krea 3 を指名します。先に料金を提示し、確認してから生成します。

https://gateway.yir.ai/mcp
クライアント別の手順

Claude Code はコマンド 1 行

コンソールで API キーを作成して YIR_API_KEY に設定し、次を実行します:

claude mcp add --transport http yir https://gateway.yir.ai/mcp --header "Authorization: Bearer $YIR_API_KEY"

Yir Skill をインストール

エージェントの実行環境に YIR_API_KEY を設定し、Claude Code、Codex などに追加したら、「Yir の Krea 3 で…を作って」と頼むだけです。

npx skills add yir-ai/skills
Yir Skill について

パッケージマネージャーで公式 SDK をインストールするか、下のコードスニペットをコピーして始めましょう

$pnpm add @yir-ai/sdk
// Replace https://example.com/your-reference-image.png with your publicly accessible HTTPS image URL.
import { createNodeYirClient } from "@yir-ai/sdk/server";
 
// デフォルトでは環境変数から YIR_API_KEY を読み込みます: process.env.YIR_API_KEY
const client = createNodeYirClient();
 
// 1. 画像生成ジョブを送信
const job = await client.submitImage({
model: "krea/krea-3",
input: {
type: "image",
prompt: "柑橘系スパークリングウォーターの商品ポスターを作成。透明なガラス瓶と新鮮なオレンジ、クリーム色の背景、柔らかな自然光、くっきりした商品ラベル",
references: [{ role: "reference_image", ...{ url: "https://example.com/your-reference-image.png" } }],
},
parameters: {
resolution: "1K",
aspect_ratio: "1:1",
n: 1,
},
});
 
// 2. ジョブの完了と結果の納品を待機
const result = await client.waitForJob(job.id);
console.log("納品ファイル:", result.result);
if (result.result && "files" in result.result) {
for (const file of result.result.files) {
console.log("->", file.url);
}
}

OpenAI プロトコルを使っているプロジェクトや new-api などのゲートウェイなら、Base URL とキーを変えるだけです。 OpenAI 互換ガイド

OpenAI SDK の base_url
https://gateway.yir.ai/openai/v1
new-api のチャネル Base URL
https://gateway.yir.ai/openai
キー
Yir の API Key
モデル ID
krea/krea-3
# Replace https://example.com/your-reference-image.png with your publicly accessible HTTPS image URL.
curl https://gateway.yir.ai/openai/v1/images/generations \
  -H "Authorization: Bearer $YIR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "krea/krea-3",
    "prompt": "柑橘系スパークリングウォーターの商品ポスターを作成。透明なガラス瓶と新鮮なオレンジ、クリーム色の背景、柔らかな自然光、くっきりした商品ラベル",
    "resolution": "1K",
    "aspect_ratio": "1:1",
    "images": [
      {
        "image_url": "https://example.com/your-reference-image.png"
      }
    ]
  }'

パラメータの概要

よく使うパラメータです。上限は現在のモデルと選択したチャネルによって異なります

API ドキュメント
解像度
resolution
  • 1K
  • 2K

出力解像度の段階です。高解像度ほど精細になり、価格もそれに応じて上がります

アスペクト比
aspect_ratio
  • 1:1
  • 4:3
  • 3:4
  • 16:9
  • 9:16

画面の縦横比です。用途(縦長、バナー、正方形)に合わせて選んでください

入力モード
input_mode
  • 画像入力

参照の上限と形式はモデルと選択したチャネルによって異なります

参照素材
references
  • reference_image ≤ 8

入力方式ごとの参照上限は選択したチャネルによって異なります。料金表の枚数は計算例であり、入力上限や無料枠ではありません。

よくある質問

Krea 3 で開発を始める

同じ仕様をチャネル間で比較し、1 つのウォレットで複数のチャネルを呼び出せます。