Generate SEO Images

SEO Image AI

Generate on-brand, SEO-optimized images from a keyword, with full control over type, theme, colors, and dimensions.

POSThttps://ai.seovendor.co/api/seo-image/

Authenticate every request by passing your secret key as k in the JSON body. Requests are POST with Content-Type: application/json.

01Request parameters

Field	Type	Required	Description
action	string	optional	generate Generate image.
kw	string	required	Keyword text, 4 to 300 characters.
brand	string	optional	Brand text, max 60 characters.
web	string	optional	Website URL, max 300 characters.
url	string	optional	Fallback website URL used when web is not sent, max 300 characters.
location	string	optional	Location text, max 200 characters.
notes	string	optional	Notes text, max 200 characters.
country	string	optional	Country text, max 100 characters.
brandpersona	string	optional	Brand persona text, max 2000 characters.
lang	integer	optional	0 US English1 UK English2 Australian English3 Spanish4 Italian5 French6 German7 Portuguese8 Dutch9 Bulgarian10 Czech11 Danish12 Estonian13 Finnish +26 more options 14 Greek15 Hungarian16 Polish17 Norwegian18 Romanian19 Swedish20 Brazilian Portuguese21 Mexican Spanish22 Colombian Spanish23 Argentine Spanish24 Peruvian Spanish25 Canadian English26 Chilean Spanish27 Bolivian Spanish28 Catalan29 Austrian German30 Canadian French31 Belgian Dutch (Flemish)32 Belgian French33 Scottish English34 Slovak35 New Zealand English36 Irish English37 Swiss German38 Croatian39 Turkish
imagetype	integer	optional	0 Auto (AI)1 Social Media Post2 Carousel Slide3 Carousel Cover4 Story5 Reel/Short6 Story Cover Image7 Reel Cover Image8 Video Cover Image9 YouTube Thumbnail10 Thumbnail Image11 Social Ad Creative12 Carousel Ad Creative13 Story Ad Creative +136 more options 14 Collection Ad Cover15 Retargeting Ad Creative16 Native Ad Image17 Web Ad (Display)18 Website Hero Image19 Homepage Banner20 Web Banner21 Landing Page Banner22 Call-to-Action Banner23 Website Slider Image24 Feature Section Image25 Announcement Bar Graphic26 Pop-up Banner27 Website Background Image28 Pattern Background29 Email Header Image30 Newsletter Banner31 Email Signature Banner32 Blog Featured Image33 Blog Header Image34 Blog In-Content Image35 Post Template36 Quote Card37 Meme Template38 Profile Banner39 Cover Photo40 Header Graphic41 Highlight Cover Icon42 Event Promo Graphic43 Webinar Promo Graphic44 Podcast Cover Art45 Press Release Header Image46 PR Media Kit Graphic47 Brand Guidelines Graphic48 Case Study Cover49 Whitepaper Cover50 Ebook Cover51 One-Pager Cover52 Pitch Deck Cover53 Presentation Slide Background54 Slide Title Graphic55 Slide Divider Graphic56 Infographic57 Explainer Graphic58 How-It-Works Graphic59 FAQ Graphic60 Step-by-Step Graphic61 Process Diagram62 Chart Graphic63 Data Callout Graphic64 Comparison Chart65 Pricing Table Graphic66 Testimonial Card67 Before-and-After Graphic68 Product Photo (Lifestyle)69 Product Photo (Studio)70 Catalog Product Tile71 Product Mockup72 Device Mockup73 Packaging Mockup74 UI Screenshot75 App Store Screenshot76 App Store Feature Graphic77 Google Play Feature Graphic78 Logo79 Logo Lockup80 Wordmark81 Monogram82 Icon83 Icon Set84 Badge85 Trust Badge86 Certification Badge87 Seal88 Ribbon Badge89 Partner Logo Strip90 Sponsor Banner91 Mobile Banner Ad92 Large Mobile Banner93 Medium Rectangle Ad94 Large Rectangle Ad95 Leaderboard Banner96 Skyscraper Ad97 Half Page Ad98 Square Ad99 Billboard Ad100 Interstitial Ad101 Realistic102 Photorealistic103 Vector104 Flat Design105 Minimalist106 Typography107 Line Art108 3D Render109 Isometric110 Cinematic111 Portrait112 Landscape113 Monochrome114 Black and White115 HDR116 Panorama117 Macro118 Collage119 Mixed Media120 Digital Painting121 Matte Painting122 Photobashing123 Abstract124 Surreal125 Vintage126 Retro127 Sepia128 Pop Art129 Graffiti130 Low Poly131 Pixel Art132 Cartoon133 Anime134 Manga135 Concept Art136 Watercolor137 Oil Painting138 Acrylic Painting139 Sketch140 Ink Wash141 Charcoal Drawing142 Chalk Pastel143 Airbrush144 Impressionist145 Expressionist146 Cubism147 Baroque148 Noir149 Doodle
imagetheme	integer	optional	0 Auto (AI)1 Urban Cityscape2 Futuristic3 Art Deco4 Nature & Wildlife5 Food/Culinary6 Cybernetic/Biotech7 Space8 Cyberpunk9 Retro 80s10 Retro 90s11 Sports Action12 Street Life13 Rural Countryside +37 more options 14 Desert15 Arctic16 Jungle17 Mountain Expedition18 Utopian19 Dystopian20 Post-Apocalyptic21 Noir Detective22 Superhero23 Carnival/Festival24 Underwater25 Time Travel26 Medieval27 Renaissance28 Victorian Era29 Edwardian Era30 Baroque Palace31 Ancient Rome32 Ancient Greece33 Ancient Egypt34 Mythological35 Norse Myth36 Samurai Japan37 Wild West38 Pirate Adventure39 Viking Age40 Gothic Horror41 Lovecraftian42 Magical Academy43 Space Western44 Galactic Empire45 Alien Worlds46 Cottagecore47 Fairy Tale48 Dreamscape49 Military/War50 Steampunk
background	integer	optional	0 Auto (AI)1 Gradient2 Bokeh3 Radial Gradient4 Blur5 In Motion6 Dark7 Light8 Night9 Day10 Dawn11 Dusk12 Spring13 Summer +38 more options 14 Autumn15 Winter16 Hot17 Cold18 Warm19 Grid20 Graph21 Blueprint22 Halftone23 Rays24 Lights25 Simple26 Vignette27 Office28 Home29 Store30 Retail31 Outdoors32 Indoors33 Fabric34 Denim35 Leather36 Wood37 Steel38 Board39 Wall40 Concrete41 Water42 Tile43 Sky44 Grass45 City46 Farm47 Suburban48 Fog49 Smoke50 Fire51 Snowflakes
imagebackground	integer	optional	0 Auto (AI)1 Gradient2 Bokeh3 Radial Gradient4 Blur5 In Motion6 Dark7 Light8 Night9 Day10 Dawn11 Dusk12 Spring13 Summer +38 more options 14 Autumn15 Winter16 Hot17 Cold18 Warm19 Grid20 Graph21 Blueprint22 Halftone23 Rays24 Lights25 Simple26 Vignette27 Office28 Home29 Store30 Retail31 Outdoors32 Indoors33 Fabric34 Denim35 Leather36 Wood37 Steel38 Board39 Wall40 Concrete41 Water42 Tile43 Sky44 Grass45 City46 Farm47 Suburban48 Fog49 Smoke50 Fire51 Snowflakes
primarycolor	integer	optional	0 Auto (AI)1 Blue2 Black3 White4 Gray5 Red6 Navy7 Light Blue8 Green9 Charcoal10 Orange11 Silver12 Yellow13 Gold +7 more options 14 Purple15 Teal16 Maroon17 Brown18 Turquoise19 Pink20 Beige
secondarycolor	integer	optional	0 Auto (AI)1 Blue2 Black3 White4 Gray5 Red6 Navy7 Light Blue8 Green9 Charcoal10 Orange11 Silver12 Yellow13 Gold +7 more options 14 Purple15 Teal16 Maroon17 Brown18 Turquoise19 Pink20 Beige
imagesize	integer	optional	0 1536x1024 Wide1 1024x1024 Square2 1792x1024 Tall
engine	integer	optional	0 Image GPT 1.0 (Simple Images)1 Image GPT 2.0 (Complex Images)2 Image GPT 1 Mini (Fast Images)
k	string	required	API key sent as k in query string, POST body, JSON body; api_key is also accepted, 11 to 120 characters.

02Response

Every response uses the standard envelope (success, application, action, data, meta, error). The data field for this endpoint is documented below.

successaction: generate · HTTP 200

200 response example

{
  "success": true,
  "application": "seo-image",
  "action": "generate",
  "data": {
    "image_url": "string",
    "filename": "string",
    "fileformat": "string",
    "size": "string",
    "compression": 0,
    "imagetype": "string",
    "imagetheme": "string",
    "background": "string",
    "primarycolor": "string",
    "secondarycolor": "string",
    "notes": "string",
    "country": "string",
    "engine": 0
  },
  "meta": {
    "request_id": "req_3f9a7c2e8b41",
    "duration_ms": 1284,
    "upstream_http_code": 200
  },
  "error": null
}

Response schema

successboolean= true

applicationstring= "seo-image"

actionstring= "generate"

dataobjectGenerated SEO image data.

└─image_urlstringFull URL to the generated image file.

└─filenamestringImage filename on the server.

└─fileformatstringFile format, e.g. jpg, png, webp.

└─sizestringImage dimensions, e.g. 1024x1024.

└─compressionintegerCompression level applied.

└─imagetypestringImage type label used in generation.

└─imagethemestringVisual theme label used in generation.

└─backgroundstringBackground style label.

└─primarycolorstringPrimary color label.

└─secondarycolorstringSecondary color label.

└─notesstringCustom notes passed to generation.

└─countrystringCountry context used in generation.

└─engineintegerAI image engine ID used.

metaobject

└─request_idstring

└─duration_msinteger

└─upstream_http_codeinteger

errornull

errorHTTP 400, 401, 502, 503, or 504

error response example

{
  "success": false,
  "application": "seo-image",
  "action": "string",
  "data": null,
  "meta": {
    "request_id": "req_3f9a7c2e8b41"
  },
  "error": {
    "code": "invalid_request",
    "message": "The kw field is required.",
    "field": "kw",
    "details": [],
    "apidefinitions": "https://ai.seovendor.co/api/seo-image/definitions"
  }
}

Response schema

successboolean= false

applicationstring= "seo-image"

actionstring

datanull

metaobject

└─request_idstring

errorobject

└─codestringError code returned by the API.

└─messagestringHuman-readable error message.

└─fieldstringInput field associated with the error.

└─detailsarrayAdditional error details.

└─apidefinitionsstringPublic API definitions URL.

POST /api/seo-image/

curl -X POST "https://ai.seovendor.co/api/seo-image/" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
  "k": "[API KEY]",
  "action": "generate",
  "kw": "white label seo",
  "web": "https://seovendor.co",
  "brand": "SEO Vendor"
}'
<?php
$ch = curl_init("https://ai.seovendor.co/api/seo-image/");

$payload = [
    "k" => "[API KEY]",
    "action" => "generate",
    "kw" => "white label seo",
    "web" => "https://seovendor.co",
    "brand" => "SEO Vendor",
];

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "Content-Type: application/json",
        "Accept: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode($payload),
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);
const response = await fetch("https://ai.seovendor.co/api/seo-image/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Accept": "application/json"
  },
  body: JSON.stringify({
    k: "[API KEY]",
    action: "generate",
    kw: "white label seo",
    web: "https://seovendor.co",
    brand: "SEO Vendor",
  })
});

const data = await response.json();
console.log(data);
import requests

url = "https://ai.seovendor.co/api/seo-image/"

payload = {
    "k": "[API KEY]",
    "action": "generate",
    "kw": "white label seo",
    "web": "https://seovendor.co",
    "brand": "SEO Vendor",
}

headers = {
    "Content-Type": "application/json",
    "Accept": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
data = response.json()
print(data)

← PreviousContent Transformer Next →Better Keywords AI

SEO Vendor API

Overview API Home seovendor.co