questions/How-to

How do I use Recraft V3?

To use Recraft V3, install the OpenAI SDK (any language), point base_url at https://api.aigateway.sh/v1 with an sk-aig-... key, and set model="recraft/recraftv3". That's it — no provider account, no separate billing. Recraft's model is served through AIgateway's OpenAI-compatible endpoint so every existing OpenAI integration (Cursor, LangChain, Vercel AI SDK) works unchanged.

How it works

1. Grab an AIgateway key

Sign in at aigateway.sh with GitHub or Google, open the dashboard, and copy an sk-aig-... key. No credit card required to claim a key — every new account gets $5 signup credit (spendable on a curated edge-tier shortlist including Kimi K2.6) so you can test end-to-end before you top up.

2. Point the OpenAI SDK at AIgateway

Every OpenAI client library ships with a base_url (Python) or baseURL (Node) field. Set it to https://api.aigateway.sh/v1 and drop in your sk-aig-... key. Nothing else in your application code needs to change — the request and response schemas are OpenAI-identical.

3. Set model="recraft/recraftv3"

On your chat.completions.create call (or images, embeddings, audio — whichever endpoint matches the image modality), pass model="recraft/recraftv3". AIgateway handles provider auth, billing, retries, and transformation so Recraft-specific quirks don't leak into your code.

Code example

Python
# pip install aigateway-py openai
# aigateway-py: sub-accounts, evals, replays, jobs, webhook verify.
# openai SDK: chat/embeddings/images/audio — drop-in compat per our SDK's own guidance.
from openai import OpenAI

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

img = client.images.generate(
    model="recraft/recraftv3",
    prompt="A studio photo of a red ceramic mug on white marble",
    size="1024x1024",
)
print(img.data[0].url)
Node / TypeScript
// npm i aigateway-js openai
// aigateway-js: sub-accounts, evals, replays, jobs, webhook verify.
// openai SDK: chat/embeddings/images/audio — drop-in compat.
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.aigateway.sh/v1",
  apiKey: process.env.AIGATEWAY_KEY,
});

const img = await client.images.generate({
  model: "recraft/recraftv3",
  prompt: "A studio photo of a red ceramic mug on white marble",
  size: "1024x1024",
});
console.log(img.data[0].url);

Related

FAQ

Do I need a Recraft account to use Recraft V3?

No. AIgateway provides a unified sk-aig-... key that routes to Recraft on your behalf. You only need an AIgateway account.

Does Recraft V3 support tool calling?

Recraft V3 does not support tool calling natively. Use it for generation; route tool-calling prompts to a model like Claude Sonnet 4.6 or GPT-5.4.

What is the context window of Recraft V3?

Context window details for Recraft V3 are on the spec page at /models/recraft/recraftv3.

Is Recraft V3 free to try?

Every new AIgateway account gets $5 in signup credit (no card) — spendable on a curated edge-tier shortlist (Kimi K2.6, FLUX-2 Klein, Whisper Turbo, Aura 2, Gemma 4 vision, BGE-M3, Llama Guard 3). Recraft V3 is covered if it's on that shortlist; otherwise a $5 top-up unlocks the full catalog at pass-through pricing. Topups never expire.

Can I use Recraft V3 with Cursor or LangChain?

Yes — anything that speaks OpenAI's API shape works. Set base_url to https://api.aigateway.sh/v1, paste your AIgateway key, and set the model string. Cursor, Cline, Continue, LangChain, LlamaIndex, Vercel AI SDK all supported.

TRY IT NOW

One key, every model. Free tier, no card.

Get an AIgateway keyOpen the playground