modeller

Recraft: Recraft V3

Markdown · JSON

Recraft: Recraft V3

Recraft V3 skapar fotografier, illustrationer och grafiska layouter med textmedveten komposition och stilkontroller. Dess separata raster- och SVG-varianter passar affischer, varumärkesbilder, ikoner och designer där ordalydelse och visuell struktur behöver samverka.

Om modellen

Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.

Recraft V3 är en bildgenereringsmodell byggd för grafisk design liksom för fotografiska och illustrerade scener. En skriven instruktion beskriver motiv, miljö och komposition; resultatet är en bild. V3 utvecklar Recrafts textrendering och fotorealism och behåller stilkonsekvens från exempelbilder utan omträning.

Text som en del av kompositionen

V3 arbetar med text i bilden, inklusive längre texter och medelstora bokstäver. Recraft beskriver ett layoutsteg som fastställer ord och deras positioner före bildgenerering. Layouten kan produceras automatiskt från instruktionen eller arrangeras manuellt i Recrafts designmiljö. Detta hjälper till att koppla ihop en rubrik, illustration och stödtext i en komposition. Tillverkaren dokumenterar även uttryckliga textlayoutkoordinater, angivna relativt bilden snarare än som ett fast pixelrutnät. Varje textelement innehåller ett enda ord och fyra hörnpunkter i normaliserade koordinater: (0, 0) är övre vänstra hörnet och (1, 1) nedre högra hörnet. Koordinater kan sträcka sig utanför intervallet och då beskärs formen. Uttryckliga textlayoutord måste följa dokumenterade teckenbegränsningar.

För en affisch eller ett omslag anger du exakt ordalydelse och beskriver hierarkin: vilken rad som leder, var den sitter och hur bilden stöder den. Kontrollera renderad stavning och avstånd när ett resultat väljs.

Stil, palett och konstnärlig inriktning

V3 innehåller kurerade fotografiska, illustrations- och emblemstilar samt ett separat bibliotek för vektorstilar. Recraft V3 Raw är rastermodellens standardstil; Vector art är standard för vektorvarianten. Photorealism siktar på fotografiskt utseende, medan Illustration rymmer stiliserade texturer, skuggning och mer komplexa färgövergångar. Vektorstilar föredrar former, begränsade paletter och plana fyllningar eller enkla toningar.

Egna stilar kan byggas från referensbilder, befintliga kompatibla stilar eller en kombination. De ger en återanvändbar visuell inriktning genom en bildserie. De dokumenterade blandningskontrollerna låter referenser och källstilar bära separata vikter; antalet vikter motsvarar källorna. PaletteMatch och MaxWeight är de två listade blandningspolicyerna. Tillverkaren tillåter upp till 10 stilreferensbilder och använder det vanliga stilmatchningsläget för V3. En lagrad egen stil och direkta stilreferenser är alternativa indata, och en egen stil måste matcha modellen som används för generering.

Önskade färger och en bakgrundsfärg styr paletten. Upp till 10 RGB-färger dokumenteras, med varje komponent från 0 till 255. Valfria relativa vikter går från 0 till 1; de måste anges för varje färg eller för ingen, och summan får inte överstiga 1. Konstnärlig nivå går från 0 för en statisk, ren behandling till 5 för mer dynamiska, excentriska kompositioner. En negativ prompt beskriver oönskade element; en separat kontroll för ingen text inaktiverar inbäddade textlayouter. Ett slumpseed finns för reproducerbarhet. Kontrollerna ger olika sätt att påverka scenen, dess stil och visuella layout.

Rasterbilder och en separat SVG-variant

Recraft dokumenterar två V3-varianter. Rastermodellen producerar förlustfri WebP eller PNG och passar fotografiska detaljer, skuggning och texturrik illustration. Recraft V3 Vector producerar SVG: banor och former som kan skalas utan fast pixelupplösning. Den passar piktogram, logotypkoncept, märken och detaljerat vektormaterial. Raster-till-vektor-konvertering är en separat operation från att generera vektormaterial direkt.

Båda varianterna har egen identitet. En bild med vektorliknande utseende och faktiska SVG-utdata är olika val. Välj avsedda utdata när ett designflöde förbereds i stället för att behandla det gemensamma V3-namnet som bevis för att varje operation returnerar samma filtyp.

Redigera och färdigställ befintligt bildmaterial

Recrafts V3-dokumentation listar bild-till-bild-generering, inpainting, outpainting och bakgrundsersättning eller bakgrundsgenerering. Bild-till-bild-arbete kombinerar en befintlig bild med en ny instruktion. Inpainting omgenererar det valda området med en bild och en matchande mask; outpainting lägger till innehåll utanför originalramen. Bakgrundsoperationer hanterar ett motivs omgivning.

Den medföljande verktygsuppsättningen omfattar även radering, bakgrundsborttagning, vektorisering och två uppskalningsmetoder. Kreativ uppskalning kan tillföra nya detaljer; skarp uppskalning syftar till en skarpare större återgivning av befintligt innehåll. Detta är separata operationer med egna indata och resultat, inte ytterligare betydelser av raster- eller vektormodellens namn.

Gränser för prompt, storlek och källbilder

Tillverkarens genereringsspecifikation för V3 tar emot en prompt på upp till 1000 tecken och 1–6 bilder per förfrågan. Den stöder 14 bildförhållanden: 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 6:10, 14:10, 10:14, 16:9 och 9:16. Dokumenterade rasterexempel omfattar 1024x1024, 1820x1024 och 1024x1820. Exakta rasterdimensioner måste komma från den stödda listan; SVG använder bildförhållanden utan fast pixelstorlek. När storlek utelämnas väljer tillverkarens system den från prompten.

För bildindataoperationer listar tillverkaren PNG, JPG och WebP, med SVG där den specifika operationen tillåter det. Filer måste vara under 20 MB, högst 16 MP, med en långsida på högst 4096 pixlar. Kortsidan är minst 256 pixlar, med ett undantag på 32 pixlar för skarp uppskalning. Masker matchar bildstorleken och använder rent svart och vitt; stilreferenser har en sammanlagd gräns på 64 MB.

För ett Ailoot API-projekt omvandlar du uppgiften till en fokuserad bildinstruktion: exakt text, föremålsarrangemang, visuell stil och önskad komposition. En affisch, en produktscen och en ikonserie kräver olika instruktioner; bevara relevanta skillnader mellan V3-varianter och operationer när du avgör hur varje resultat ska användas.

Ailoot Ultra · Bilder POST /v1/images/generations recraft/recraft-v3

recraft/recraft-v3

Recraft /recraft/recraft-v3

Start

Recraft V3 skapar fotografier, illustrationer och grafiska layouter med textmedveten komposition och stilkontroller. Dess separata raster- och SVG-varianter passar affischer, varumärkesbilder, ikoner och designer där ordalydelse och visuell struktur behöver samverka.

Godkända indata
Text · Bilder
Resultat
Bilder

Tillgängligt i Ailoot · indata & metoder

Ailoot Ultra · Bilder POST /v1/images/generations
Indatatyper
text, image
Utdatatyper
image
Utdataformat
Bildfil
FältTypKravVärden & gränserStandard
FältmodelTypstringKravObligatorisktVärden & gränser
recraft/recraft-v3
Standard—
FältpromptTypstringKravObligatorisktVärden & gränser
Minsta längd: 1
Standard—
FältnTypintegerKravValfrittVärden & gränser
Minimum: 1
Maximum: 6
Standard—
Fältaspect_ratioTypstringKravValfrittVärden & gränser
1:1, 4:3, 3:4, 16:9, 9:16, auto
Standard—
Fältinput_referencesTyparrayKravValfrittVärden & gränser
Minsta antal objekt: 0
Maximalt antal objekt: 1
Standard—
Kombinationer av indatamaterial

Text till bild · Krävs: prompt

Metodparametrar och livscykel
ParameterAvtal
Parametercontent_typeAvtalapplication/json
ParameterrequiredAvtalmodel, prompt
Parametermaterial_typesAvtaltext, image
Parameteroptional_controlsAvtalaspect_ratio, n, input_references
Parameterexact_supported_parametersAvtal{"aspect_ratio":{"type":"enum","values":["1:1","4:3","3:4","16:9","9:16","auto"]},"n":{"type":"range","min":1,"max":6},"input_references":{"type":"range","min":0,"max":1}}
Parameterreference_material_ruleAvtalEndast kundens faktiska bildreferenser; leverantörens villkor för ändpunkten styr dem.

Metodalias: /v1/images

Livscykel: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Det task_id som faktiskt returnerades eller en post i mediebiblioteket

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Använd den exakta modellen och de dokumenterade indatafälten.

Behåll hela svaret, varje faktiskt resultat och ursprungliga returnerade ID:n.

Priser

Så beräknas slutavgiften

De visade priserna används för att uppskatta kostnaden före genereringen. Den slutliga debiteringen beräknas utifrån den kostnad som registrerats för den ursprungliga genereringen. Uppmätt längd på resultatet och uppskattade mängder utgör inte den slutliga debiterbara mängden.

Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.

Snabbt läge
Ej angivet När snabbt läge är valt
Flex-läge
Ej angivet När läget flex är valt
Högsta resonemangsnivå
Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)

Uppskattade priser för jämförelse

Priser efter konfiguration

Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.

KonfigurationPrislistaPrognostiserad mängdDebiteringsenhetAvgift
KonfigurationGrundpriser för tokenPrislistaGrundprisPrognostiserad mängd—Debiteringsenhet—Avgift
Indata · Indatatoken · Uppskattning endast för jämförelse — / 1K token
Utdata · Utdatatoken · Uppskattning endast för jämförelse — / 1K token
Indata · Cacheläsning · Uppskattning endast för jämförelse — / 1K token
Indata · Skrivning till cache · Uppskattning endast för jämförelse — / 1K token
Indata · Skrivning till cache, 1 tim · Uppskattning endast för jämförelse — / 1K token
KonfigurationUltraPrislista—Prognostiserad mängd—Debiteringsenhetper utdatabildAvgift
Utdata · bildutdata · Uppskattning endast för jämförelse $0.08 per utdatabild
KonfigurationUppskattad genereringskostnadPrislista—Prognostiserad mängduppskattning för en genereringDebiteringsenhet—Avgift
Utdata · Uppskattad genereringskostnad · Uppskattning endast för jämförelse $0.08 uppskattning före generering

Denna uppskattning är varken en extra avgift eller ett fast pris för den slutförda genereringen.

Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →

Detaljer om referenstariffen

Referensprislistor på modellnivå ändrar inte metodval, prisuppgifter eller avgifter. Aktiva avgifter använder priserna för den valda Ailoot-metoden.

Priskonfigurationer för bilder

Priser efter konfiguration

KonfigurationDebiteringsvillkorAvgift
KonfigurationUtdatabildDebiteringsvillkorIngen prisvariant har deklarerats.Avgift
Utdata · Utdatabild $0.08 per bild

Likvärdiga prisposter beskriver samma debitering; de lägger inte till en andra avgift.

Exempelbegäranden

Ailoot Ultra · Bilder

curlPython SDKNode.js SDK
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'recraft/recraft-v3', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
from openai import OpenAI
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")

request={'model': 'recraft/recraft-v3', 'prompt': 'a red panda astronaut floating in space, studio lighting'}
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.images.generate(**request)
Path("sdk-result.txt").write_text(str(result),encoding="utf-8")
save_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])
import OpenAI from "openai";
import { readFileSync, writeFileSync } from "node:fs";
const key=process.env.AILOOT_API_KEY;
if(!key) throw new Error("Set your actual Ailoot API key");
const client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});
const request={"model": "recraft/recraft-v3", "prompt": "a red panda astronaut floating in space, studio lighting"};
const result=await client.images.generate(request);
writeFileSync("sdk-result.json",JSON.stringify(result,null,2));
if(!result.data?.length) throw new Error("No completed images");
for(let index=0;index<result.data.length;index++) {
  const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;
  if(!encoded && uri.startsWith("data:image/")) {
    const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");
    encoded=uri.slice(comma+1);
  }
  if(encoded) {
    if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");
    raw=Buffer.from(encoded,"base64");
  } else if(uri) {
    const u=new URL(uri,"https://api.ailoot.ai");
    if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");
    const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");
    const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});
    if(!response.ok) throw new Error("Image content download failed: "+response.status);
    raw=Buffer.from(await response.arrayBuffer());
  } else throw new Error("Image has neither bytes nor URL");
  if(!raw.length) throw new Error("Empty image result");
  const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";
  writeFileSync(`image-${index}.${ext}`,raw);
}
console.log("Every returned image saved; sdk-result.json retains complete metadata");

Ta emot och spara resultat

Ailoot Ultra · Bilder

Ladda ned varje returnerad bild eller spara dess Base64-innehåll

  • GET /v1/media/tasks/{task_id}
  • GET /v1/media/assets/{asset_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Behåll alla färdiga resultat

Spara varje färdig bild; hämta varje returnerad URL eller avkoda dess Base64-innehåll.

Behåll varje datapost och fullständiga förbrukningsuppgifter; säkerställ ägande och spara alla faktiskt returnerade bilder. Inga påhittade URL:er eller ID:n.

Om det ursprungliga svaret behöver kontrolleras

Om resultatet av en bildgenerering eller bildredigering behöver kontrolleras ska du behålla de ursprungliga värdena för operation_id/X-Client-Request-ID och den returnerade resultatinformationen. Hämta befintliga resultat som tillhör dig genom mediebiblioteket med de faktiska task_id- eller asset_id-värdena. Skicka inte genererings- eller redigeringsförfrågan igen och bygg inte en URL för statusavläsning från operation_id.

Svarsfält
FältTyp
FältcreatedTypinteger
Fältdata[].urlTypstring
Fältdata[].b64_jsonTypbase64 string
FältusageTypobject

Alias

Modellalias

Ailoot Ultra recraft/recraft-v3

Alias för metodsökvägar

/v1/images

Relaterade anropar-ID:n

recraft/recraft-v3

FAQ · Recraft: Recraft V3
Vilka indata och resultat finns?

POST /v1/images/generations · recraft/recraft-v3: text, image → image

Vilka fält använder begäran?

POST /v1/images/generations · recraft/recraft-v3: model, prompt, n, aspect_ratio, input_references

Vilka gränser gäller?

POST /v1/images/generations · recraft/recraft-v3: n.minimum: 1; n.maximum: 6

Fler detaljer

Anslut Ailoot till Claude Code, OpenCode, Hermes eller din app.

Företaget och dess projektportfölj

Företaget och dess projektportfölj: miljontals kunder; månatlig försäljning för miljarder.

Köp token med rabatt.

Prenumerationsrabatt för återkommande arbete. Kampanjkoder ger upp till 50% vid tokenköp.

Prenumeration
Välj en rabatterad plan för återkommande anrop.
Kampanjkod upp till 50%
Ange koden vid köpet. Priset räknas om enligt kampanjen.
Kostnader i historiken
Modell, token och belopp sparas för varje anrop.

Välj prenumeration · Se modellpriser

Anslut API till produkten som du säljer.

SaaS, appar och botar enligt Ailoots officiella villkor och licensavtal. Begär återförsäljarlicens för vidareförsäljning.

Kommersiell applikation
Bygg text-, bild-, video- och ljudgenerering i tjänstens betalda funktioner.
Återförsäljarlicens
Skicka projektbeskrivning och åtkomstupplägg. Begär skriftliga villkor för användning och vidareförsäljning.
Dokument på webbplatsen
Officiella villkor, licensavtal och databehandlingspolicy finns tillgängliga före anslutning.

Begär återförsäljarlicens · Officiella villkor och licensavtal