replicate-svg-generation

name	replicate-svg-generation
description	Generate SVG images with Replicate via direct Bash HTTP calls. Use when you need vector image generation.

Replicate SVG vector image generation

what you do with this skill

• generate a .svg image using recraft-ai/recraft-v4-svg on Replicate
• use a direct curl call to Replicate HTTP API
• save the SVG locally for immediate usage
• use token from ~/Documents/.secrets/replicate-key

When to use

Use this skill when you need to generate an SVG vector image.

Input schema

Required:

• prompt (string) - The text description of the image to generate. Always required.

Optional:

• aspect_ratio enum: Not set, 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 1:2, 2:1, 14:10, 10:14, 4:5, 5:4, 6:10
• size enum: 1024x1024, 1536x768, 768x1536, 1280x832, 832x1280, 1216x896, 896x1216, 1152x896, 896x1152, 832x1344, 1280x896, 896x1280, 1344x768, 768x1344

Rules:

• prompt is always required.
• If aspect_ratio is different from Not set, do not send size.
• If aspect_ratio is Not set, you may send size.

Output schema

• Type: string
• Format: uri
• The output is a URL to the generated .svg.

Direct bash workflow (HTTP API)

set -euo pipefail

REPLICATE_API_TOKEN="$(tr -d '\n' < "$HOME/Documents/.secrets/replicate-key")"
PROMPT="Retro 1970s style poster with the text 'Recraft V4' in bold groovy typography with rainbow gradient colors"
ASPECT_RATIO="1:1"
SIZE="1024x1024"
OUTPUT_FILE="output.svg"

if [ -z "$REPLICATE_API_TOKEN" ]; then
  echo "Missing Replicate token in ~/Documents/.secrets/replicate-key" >&2
  exit 1
fi

if [ "$ASPECT_RATIO" = "Not set" ]; then
  REQUEST_BODY="$(python3 - <<'PY' "$PROMPT" "$SIZE"
import json, sys
prompt, size = sys.argv[1], sys.argv[2]
print(json.dumps({"input": {"prompt": prompt, "size": size}}))
PY
)"
else
  REQUEST_BODY="$(python3 - <<'PY' "$PROMPT" "$ASPECT_RATIO"
import json, sys
prompt, aspect_ratio = sys.argv[1], sys.argv[2]
print(json.dumps({"input": {"prompt": prompt, "aspect_ratio": aspect_ratio}}))
PY
)"
fi

RESPONSE="$(curl --silent --show-error https://api.replicate.com/v1/models/recraft-ai/recraft-v4-svg/predictions \
  --request POST \
  --header "Authorization: Bearer $REPLICATE_API_TOKEN" \
  --header "Content-Type: application/json" \
  --header "Prefer: wait" \
  --data "$REQUEST_BODY")"

OUTPUT_URL="$(python3 - <<'PY' "$RESPONSE"
import json, sys
payload = json.loads(sys.argv[1])
output = payload.get("output")
if isinstance(output, str):
    print(output)
elif isinstance(output, list) and output:
    print(output[0])
else:
    raise SystemExit("No output URL found in Replicate response")
PY
)"

curl --silent --show-error --location "$OUTPUT_URL" --output "$OUTPUT_FILE"
echo "SVG saved to $OUTPUT_FILE"
echo "Output URL: $OUTPUT_URL"

Error handling

• 401 Unauthorized: token missing or invalid. Check ~/Documents/.secrets/replicate-key.
• 402 Payment Required: billing or quota issue on Replicate account.
• 422 Unprocessable Entity: invalid aspect_ratio, size, or payload structure.
• Empty output URL: request accepted but no usable output returned.

References

• https://replicate.com/recraft-ai/recraft-v4-svg/api
• https://replicate.com/recraft-ai/recraft-v4-svg/api/schema
• https://replicate.com/recraft-ai/recraft-v4-svg/api/api-reference
• https://replicate.com/docs