Assisters API
API Reference

Images

Generate images from text prompts

Images

Generate images from text descriptions. The images API is OpenAI-compatible.

Image Generation

Endpoint

POST https://api.assisters.dev/v1/images/generations

Request Body

stringdefault: assisters-image-v1

The image model to use. Example: assisters-image-v1

stringrequired

A text description of the desired image. Maximum 4000 characters.

integerdefault: 1

Number of images to generate. Currently supports 1.

stringdefault: 1024x1024

Image dimensions. Options: 1024x1024, 1792x1024, 1024x1792

stringdefault: url

How to return the image. Options: url, b64_json

Response

{
  "created": 1700000000,
  "data": [
    {
      "url": "https://..."
    }
  ]
}

Example

curl https://api.assisters.dev/v1/images/generations \
  -H "Authorization: Bearer $ASSISTERS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "assisters-image-v1",
    "prompt": "A serene mountain landscape at sunset",
    "n": 1,
    "size": "1024x1024"
  }'
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.assisters.dev/v1",
  apiKey: process.env.ASSISTERS_API_KEY,
});

const response = await client.images.generate({
  model: "assisters-image-v1",
  prompt: "A serene mountain landscape at sunset",
  n: 1,
  size: "1024x1024",
});

console.log(response.data[0].url);
from openai import OpenAI

client = OpenAI(
    base_url="https://api.assisters.dev/v1",
    api_key=os.environ["ASSISTERS_API_KEY"],
)

response = client.images.generate(
    model="assisters-image-v1",
    prompt="A serene mountain landscape at sunset",
    n=1,
    size="1024x1024",
)

print(response.data[0].url)