はじめに
このエンドポイントでできることをご紹介します
Recraft 20B を SVG モードで呼び出し、ベクターファイルを 1 点返します。
重要な入力項目をご紹介します
prompt で対象を指定します。style で 21 種類のスタイルから選びます（既定値は vector_illustration です）。aspect_ratio は 1:1、16:9、9:16、4:3、3:4 から選べます。
返される結果をご紹介します
.svg ファイルが 1 点返されます（MIME は image/svg+xml です）。
| 項目 | 値 |
|---|---|
| 入力 | テキスト |
| 出力 | 画像 |
| 出力形式 | SVG |
| スタイル数 | 21（アイコン 10、イラスト 11） |
| 縦横比 | 1:1, 16:9, 9:16, 4:3, 3:4 |
主な機能とハイライト
1 つのモデルで 2 通りのアイコンを作成できます
左は icon/colored_outline のコーヒーカップです。14 個のパスで、茶色の輪郭と淡い塗りを表現しています。右は icon/outline の山と太陽を使った旅行アイコンです。13 個のパスで線だけを描いています。セット全体で同じスタイルを使うと、統一感のあるアイコンに仕上がります。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 特にアイコンでは、対象を 1 つに絞ると伝わりやすくなります。湯気の立つコーヒーカップや、昇る太陽を背景にした山などです。 1 文字以上 · 1000 文字以内 |
style | いいえ | アイコン用は 10 種類（outline、 |
aspect_ratio | いいえ | アイコンには 1:1（既定値）、バナーやシーンには 16:9、9:16、4:3、3:4 を使います。追加料金なしで SVG のキャンバスの形を設定できます。 |
料金
$0.053 / SVG
提供されたアイコンやイラストは、スタイルや縦横比にかかわらず、1 点ごとに定額で課金されます。生成に失敗した場合は課金されません。
ユースケース
アプリやウェブサイト用のアイコンセットを作成できます
メニュー、機能、空の状態を示すアイコンを同じスタイルで生成し、インターフェースに合わせて色を変更できます。
ブログやソーシャルメディア用の画像をすばやく作成できます
投稿やニュースレター用に、カートゥーン風やかわいいタッチの小さなイラストを数秒で作成できます。
クラフトや印刷に活用できます
線画、彫刻風、リノカット風のスタイルを、ステッカー、スタンプ、カッティングマシン、印刷カードに活用できます。
プロンプトガイドと実践のヒント
スタイルを選びます
UI アイコンには icon/、シーンには vector_illustration/ のスタイルを選びます。既定値は
vector_illustrationです。対象を 1 つ説明します
アイコンは対象を 1 つに絞ると、よい結果が得られます。たとえば、湯気の立つコーヒーカップや、昇る太陽を背景にした山などです。
SVG を取得します
タスクの状態を定期的に確認し、.svg ファイルをダウンロードして、デザインツールやコードに組み込みます。
概要をご紹介します
Recraft 20B SVG は、ベクターアイコンやイラストを高速かつ低コストで生成します。スタイルを言葉で説明する代わりに、名前の付いた 21 種類のスタイルから選びます。
主な機能と特長をご紹介します
21 種類のスタイルから選べます
アイコン用のスタイルには outline、broken_line、colored_outline、colored_shapes、colored_shapes_gradient、doodle_fill、doodle_offset_fill、offset_fill、outline_gradient、uneven_fill があります。イラスト用には cartoon、doodle_line_art、engraving、flat_2、kawaii、line_art、line_circuit、linocut、seamless があります。
すばやく生成できます
検証では、1 回の生成に約 11 秒かかりました。アイコンの一括生成にも使いやすい速度です。
ファイルサイズを抑えられます
生成されたアイコンのサイズは 20–25 KB でした。
活用例をご紹介します
製品用のアイコンライブラリを作成できます
ナビゲーション、設定、機能一覧に使う、統一感のあるセットを生成できます。
コンテンツにイラストを添えられます
記事、ニュースレター、スライドに、カートゥーン風やかわいいタッチの画像を追加できます。
ステッカーやスタンプに使えます
リノカット風、彫刻風、線画を、印刷やカッティングマシンに活用できます。
プロンプトの書き方とコツをご紹介します
アイコンごとに対象を 1 つに絞ります
昇る太陽を背景にした山など、短いプロンプトのほうが、長いシーンの説明よりすっきりしたアイコンになります。
セット全体でスタイルを統一します
セット内のすべてのアイコンで、同じ style の値を使います。
アイコン内の文字は後から追加します
このモデルは文字の表現が苦手です。ラベルはデザインツールで追加します。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "recraft/20b-svg/text-to-image",
"input": {
"style": "vector_illustration",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。
