はじめに
このエンドポイントの機能
プロンプトを Recraft V4 に送り、ネイティブ SVG を 1 つ返します。
重要な入力項目
prompt（最大 10,000 文字）でデザインを説明します。aspect_ratio で 7 種類のキャンバスの形から選びます。既定値は 1:1 です。
返される結果
パスで構成された .svg ファイル（MIME image/svg+xml）を 1 つ返します。
| 項目 | 値 |
|---|---|
| 入力 | テキスト |
| 出力 | 画像 |
| 出力形式 | SVG |
| プロンプトの長さ | 最大 10,000 文字 |
| 縦横比 | 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 |
主な機能とハイライト
キツネのマークもベーカリーのバッジも編集できます
左は、18 個の図形で構成された 2 色のキツネのマークです。右は、Rise & Crumb の文字を小麦の穂で囲んだレトロなベーカリーのバッジで、クリーム色と茶色の 124 個の図形で構成されています。どちらもベクターエディターで開くことができ、すべての要素を個別に選択できました。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 題材、形式（ロゴマーク、バッジ、フラットイラスト）、配色を指定し、ロゴに入れる文字は引用符で囲みます。最大 10,000 文字で、最初の文が最も重視されます。 1 文字以上 · 10000 文字以内 |
aspect_ratio | いいえ | 1:1（既定値）、4:3、3:4、3:2、2:3、16:9、9:16 から選べます。SVG のキャンバスの縦横比を指定します。 |
料金
$0.096 / SVG
キャンバスの縦横比にかかわらず、納品された SVG ごとに定額で課金されます。失敗したリクエストや結果が空の場合は料金がかかりません。
ユースケース
ロゴの案を探せます
新しい商品や店舗のマークを複数生成し、最もよい案をベクターエディターで仕上げます。
フラットな挿絵を作れます
ブログ、ランディングページ、スライド資料向けに、どの画面でも鮮明な挿絵を作成できます。
印刷用のグラフィックを作れます
バッジ、ラベル、パッケージ用の絵柄をベクターで作成し、印刷時にも品質を落とさず拡大できます。
プロンプトガイドと実践のヒント
デザインの要件を書きます
題材、スタイル（ロゴマーク、バッジ、フラットイラスト）、色を指定します。ロゴに入れる文字は引用符で囲みます。
縦横比を選びます
aspect_ratioを選びます。マークやバッジには 1:1、風景やバナーには 3:2 または 16:9 が適しています。SVG を編集します
.svg をダウンロードし、Figma、Illustrator、Inkscape で開いて、色、間隔、文字の形を調整します。
はじめに
Recraft V4 Vector は、文章で書いたデザインの要件を SVG ファイルに変換します。Recraft は、構図、色、整った図形を重視して、デザイナー向けに V4 を開発しました。このエンドポイントではベクターモードを使用します。
主な機能と特長
整った図形を重ねて構成します
図形は個別のパスになっています。描き直さずに、キツネの耳の色を変えたり、バッジのリボンを動かしたりできます。
指定した配色をよく再現します
検証では、青緑とコーラル、クリーム色と茶色など、プロンプトに記載した配色が忠実に反映されました。
デザインにロゴ文字を組み込めます
Rise & Crumb のような短い名前を、絵柄の一部として描画します。
活用例
ブランドの初期案を作れます
新しい事業のマークやバッジを検討し、最もよい案をデザイナーに渡せます。
Web やアプリのイラストを作れます
メインビジュアルや空の状態を案内するイラストを作成でき、どの画面でも鮮明に表示できます。
パッケージやラベルに使えます
印刷用に拡大できるラベルの絵柄を作成できます。
プロンプトの書き方とコツ
最初に形式を指定します
ロゴマーク、エンブレム、バッジ、フラットイラストなどの形式から書き始めると、モデルが適切な細かさで描画できます。
マークはシンプルにします
ロゴには、平面的または幾何学的な形と、2 色または 3 色の配色を指定します。
文字を確認します
綴りと間隔を確認し、必要に応じてベクターエディターで調整してください。
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/v4-vector/text-to-image",
"input": {
"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 リファレンスを参照してください。
