API reference · Brave

brave/images

Integrate this model through SandBase's unified API, with production-ready schemas and examples.

APISynchronousOpen model

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/api/brave/images

Model IDbrave/images

Input Schema

6 parameters · 1 required · 5 optional

Parameter	Type	Required	Description
`q`	string	Required	The user’s search query term. Query can not be empty. Maximum of 400 characters and 50 words in the query.
`count`	integer	Optional	The number of search results returned in response. The maximum is 200. The actual number delivered may be less than requested. NOTE: Image search is not paginated and has no offset parameter. Raise count to get more results. · Min: 1 · Max: 200 · Default: 50
`country`	string	Optional	The search query country, where the results come from. The country string is limited to 2 character country codes of supported countries and ALL for worldwide. · Options: AR, AU, AT, BE, BR, CA, CL, DK, FI, FR, DE, GR, HK, IN, ID, IT, JP, KR, MY, MX, NL, NZ, NO, CN, PL, PT, PH, RU, SA, ZA, ES, SE, CH, TW, TR, GB, US, ALL · Default: "US" ARAUATBEBRCACLDKFIFRDEGRHKINIDITJPKRMYMXNLNZNOCNPLPTPHRUSAZAESSECHTWTRGBUSALL
`safesearch`	string	Optional	Filters search results for adult content. The following values are supported: off - No content filtering (except for illegal content). strict - Drops all adult content from search results. · Options: off, strict · Default: "strict" offstrict
`spellcheck`	boolean	Optional	Whether to spell check provided query. If the spell checker is enabled, the modified query is always used for search. The modified query can be found in altered key from the query response model. · Default: true
`search_lang`	string	Optional	The search language preference. The 2 or more character language code for which the search results are provided. · Options: ar, eu, bn, bg, ca, zh-hans, zh-hant, hr, cs, da, nl, en, en-gb, et, fi, fr, gl, de, el, gu, he, hi, hu, is, it, ja, jp, kn, ko, lv, lt, ms, ml, mr, nb, pl, pt-br, pt-pt, pa, ro, ru, sr, sk, sl, es, sv, ta, te, th, tr, uk, vi · Default: "en" areubnbgcazh-hanszh-hanthrcsdanlenen-gbetfifrgldeelguhehihuisitjajpknkolvltmsmlmrnbplpt-brpt-ptparorusrskslessvtatethtrukvi

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Code Examples

Ready-to-run snippets

const apiKey = process.env.SANDBASE_API_KEY;
const response = await fetch("https://api.sandbase.ai/v1/api/brave/images", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "count": 50,
    "country": "US",
    "safesearch": "strict",
    "spellcheck": true,
    "search_lang": "en"
  }),
});

if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

← Back to Brave Image Search