models/Recraft/Recraft V3 (Image To Image)
Recraft

Recraft V3 (Image To Image)

image
Compare

Recraft V3 is a text-to-image model with the ability to generate long texts, vector art, images in brand style, and much more. As of today, it is SOTA in image generation, proven by Hugging Face's industry-leading Text-to-Image Benchmark by Artificial Analysis.

MODALITIES
image
PER IMAGE
$0.040

Recraft V3 (Image To Image) (recraft/recraft-v3-image-to-image) is a image model from Recraft. Pricing via AIgateway: $0.040 per image. Call it via https://api.aigateway.sh/v1/images/generations — set model="recraft/recraft-v3-image-to-image".

model · recraft/recraft-v3-image-to-image

Use this model

model: recraft/recraft-v3-image-to-image
curl https://api.aigateway.sh/v1/images/generations \
  -H "Authorization: Bearer $AIGATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"recraft/recraft-v3-image-to-image","prompt":"a serene cyberpunk city at dusk"}'
API schema

Call Recraft V3 (Image To Image) from any OpenAI SDK

POST https://api.aigateway.sh/v1/images/generations·Content-Type: application/json·Auth: Bearer sk-aig-...

Request body

json
{
  "model": "recraft/recraft-v3-image-to-image",
  "prompt": "A cyberpunk cat at sunset, cinematic lighting",
  "n": 1,
  "size": "1024x1024",
  "response_format": "url"   // or "b64_json"
}

Response

json
{
  "created": 1776947082,
  "data": [
    { "url": "https://media.aigateway.sh/img/abc123.png" }
    // or { "b64_json": "iVBORw0KGgoAAAANSUhEU..." }
  ]
}

Quickstart

from openai import OpenAI
client = OpenAI(base_url="https://api.aigateway.sh/v1", api_key="sk-aig-...")

r = client.images.generate(
    model="recraft/recraft-v3-image-to-image",
    prompt="a cyberpunk cat at sunset",
    size="1024x1024",
)
print(r.data[0].url)

Errors

401authentication_errorInvalid or missing API key
402insufficient_creditsWallet empty (PAYG only)
404not_foundUnknown model or endpoint
429rate_limit_errorOver per-minute limit — see Retry-After header
500server_errorUpstream provider failed (retryable)
503service_unavailableUpstream saturated (retryable)
Full docs →API reference →OpenAPI spec →llms.txt →

Frequently asked questions

What is Recraft V3 (Image To Image)?
Recraft V3 is a text-to-image model with the ability to generate long texts, vector art, images in brand style, and much more. As of today, it is SOTA in image generation, proven by Hugging Face's industry-leading Text-to-Image Benchmark by Artificial Analysis. It is a image model from Recraft, accessible via AIgateway's OpenAI-compatible API at slug recraft/recraft-v3-image-to-image.
How much does Recraft V3 (Image To Image) cost via AIgateway?
$0.0400 per image, billed pass-through.
How do I call Recraft V3 (Image To Image) from my code?
Point the OpenAI SDK at https://api.aigateway.sh/v1 with your AIgateway key and set model to "recraft/recraft-v3-image-to-image". The request and response shapes match OpenAI exactly.
Does Recraft V3 (Image To Image) support streaming, tool calling, vision, and JSON mode?
Streaming — no. Tool calling — no. Vision — no. JSON mode — no. Prompt caching — no.
Can I bring my own Recraft API key (BYOK)?
Yes. Attach a Recraft key in your AIgateway dashboard and this model flips to pass-through — you pay Recraft directly and AIgateway adds no platform fee on those calls.