Generate, edit, and vary images via TokModel's API

TokModel exposes three image endpoints that follow the OpenAI Images API shape: generate a new image from a text prompt, edit an existing image using a mask, or produce variations of an image. All three endpoints accept a model parameter so you can route requests to different image providers without changing your client code.

Authentication

Include your API key in every request:

Authorization: Bearer YOUR_API_KEY

Generate
Edit
Variations

Generate an image from a prompt

POST /v1/images/generations accepts a text prompt and returns one or more image URLs. Use the n parameter to request multiple images and size to control resolution.

curl

curl https://tokmodel.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/dall-e-3",
    "prompt": "A photorealistic white cat sitting on a wooden desk next to a laptop, soft morning light",
    "n": 1,
    "size": "1024x1024"
  }'

Key parameters

Parameter	Type	Description
`model`	string	The image model to use, e.g. `openai/dall-e-3`.
`prompt`	string	Text description of the image to generate.
`n`	integer	Number of images to return (1–10, model-dependent).
`size`	string	Image dimensions, e.g. `256x256`, `512x512`, `1024x1024`.
`response_format`	string	`url` (default) or `b64_json`.

Example response

{
  "created": 1716489600,
  "data": [
    {
      "url": "https://cdn.tokmodel.com/images/generated/abc123.png",
      "revised_prompt": "A highly detailed photorealistic white cat with bright green eyes sitting on a polished wooden desk beside a silver laptop, bathed in warm soft morning sunlight streaming through a nearby window."
    }
  ]
}

The url field contains a temporary link to the generated image. Download and store it if you need it beyond the expiry window.

Edit an image with a mask

POST /v1/images/edits replaces a region of an existing image based on a prompt. You supply the original image, a mask (a PNG where transparent pixels mark the area to replace), and a text description of what should fill that area.The request uses multipart/form-data because it includes binary file uploads.

curl

curl https://tokmodel.com/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=openai/dall-e-2" \
  -F "image=@original.png" \
  -F "mask=@mask.png" \
  -F "prompt=A sunlit garden with blooming red roses" \
  -F "n=1" \
  -F "size=1024x1024"

Key parameters

Parameter	Type	Description
`model`	string	The image model to use, e.g. `openai/dall-e-2`.
`image`	file	The source PNG image to edit (max 4 MB, must be square).
`mask`	file	A PNG mask where transparent areas indicate what to replace.
`prompt`	string	Description of what to generate in the masked area.
`n`	integer	Number of edited images to return.
`size`	string	Output dimensions. Must match the source image size.

Example response

{
  "created": 1716489700,
  "data": [
    {
      "url": "https://cdn.tokmodel.com/images/edited/def456.png"
    }
  ]
}

Both the source image and the mask must be square PNGs with an alpha channel. Use an image editor or a library like Pillow to ensure the mask is correctly formatted before uploading.

Create variations of an image

POST /v1/images/variations generates one or more new images that are stylistically similar to a source image but not identical. No prompt is required — the model derives context directly from the input image.The request uses multipart/form-data.

curl

curl https://tokmodel.com/v1/images/variations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=openai/dall-e-2" \
  -F "image=@source.png" \
  -F "n=3" \
  -F "size=512x512"

Key parameters

Parameter	Type	Description
`model`	string	The image model to use, e.g. `openai/dall-e-2`.
`image`	file	The source PNG image to vary (max 4 MB, must be square).
`n`	integer	Number of variations to return (1–10).
`size`	string	Output dimensions: `256x256`, `512x512`, or `1024x1024`.
`response_format`	string	`url` (default) or `b64_json`.

Example response

{
  "created": 1716489800,
  "data": [
    { "url": "https://cdn.tokmodel.com/images/variations/var1.png" },
    { "url": "https://cdn.tokmodel.com/images/variations/var2.png" },
    { "url": "https://cdn.tokmodel.com/images/variations/var3.png" }
  ]
}

Each entry in data is an independent variation. All share visual similarity with the source but differ in composition, lighting, or detail.

Get Started

Core Concepts

Guides

Account

Generate, edit, and vary images via TokModel's API

Authentication

Generate an image from a prompt

Key parameters

Example response

Edit an image with a mask

Key parameters

Example response

Create variations of an image

Key parameters

Example response

​Authentication

​Generate an image from a prompt

​Key parameters

​Example response

​Edit an image with a mask

​Key parameters

​Example response

​Create variations of an image

​Key parameters

​Example response

Authentication

Generate an image from a prompt

Key parameters

Example response

Edit an image with a mask

Key parameters

Example response

Create variations of an image

Key parameters

Example response