Wordchef API (1.0.0)

Download OpenAPI specification:

Jackson Walters: jackson@jacksonwalters.com

Public API for embeddings, nearest neighbors, and vector images.

Health check

Returns API availability and timestamp.

header Parameters
X-API-Key
string
Example: wordchef-public-api-key

Responses

Response samples

Content type
application/json
{
  • "status": "ok",
  • "timestamp": 1763577331,
  • "message": "API is healthy"
}

Get embedding for a word

Authorizations:
ApiKeyAuth
query Parameters
word
required
string
Example: word=hello

Responses

Response samples

Content type
application/json
{
  • "word": "hello",
  • "embedding": [
    ]
}

Get embedding via POST

Authorizations:
ApiKeyAuth
Request Body schema: application/json
required
word
required
string

Responses

Request samples

Content type
application/json
{
  • "word": "hello"
}

Response samples

Content type
application/json
{
  • "word": "hello",
  • "embedding": [
    ]
}

Find nearest neighbor words

Authorizations:
ApiKeyAuth
query Parameters
words
required
string
Example: words=hello,world

Comma-separated words

Responses

Response samples

Content type
application/json
{
  • "input": {
    },
  • "nearest": [
    ]
}

Find nearest neighbor words (POST)

Authorizations:
ApiKeyAuth
Request Body schema: application/json
required
words
required
Array of strings (WordArray)

Responses

Request samples

Content type
application/json
{
  • "words": [
    ]
}

Response samples

Content type
application/json
{
  • "input": {
    },
  • "nearest": [
    ]
}

Generate an image for a word

Authorizations:
ApiKeyAuth
query Parameters
word
required
string
Example: word=hello

Responses

Response samples

Content type
application/json
{
  • "label": "vector",
  • "image_base64": "iVBORw0KGgoAAAANSUhEUgAA..."
}

Generate image via POST

Authorizations:
ApiKeyAuth
Request Body schema: application/json
required
word
required
string

Responses

Request samples

Content type
application/json
{
  • "word": "hello"
}

Response samples

Content type
application/json
{
  • "label": "vector",
  • "image_base64": "iVBORw0KGgoAAAANSUhEUgAA..."
}

Generate images for multiple words

Authorizations:
ApiKeyAuth
Request Body schema: application/json
required
Array
string

Responses

Request samples

Content type
application/json
[
  • "hello",
  • "world"
]

Response samples

Content type
application/json
{
  • "hello": "iVBORw0KGgoAAAANSUhE...",
  • "world": "iVBORw0KGgoAAAANSUhEUgAAASwA..."
}