API · Pay-as-you-go

Bring Model Buffet into your stack.

Every model, tool and workflow exposed via a single REST API. Authentication, rate limits, webhooks, idempotency, signed URLs — built for production.

Generate your first frame

POST /v1/images/generate · Mystic 2.5 Flexible

Pay-as-you-go billing

No subscription required · $0.001/credit · 100,000 free

SOC 2 Type II

Encrypted at rest, in transit · DPA on request

POST

/v1/images/generate

Generate stills with any of Model Buffet's 35+ image models.

RATE LIMIT 60/MINIDEMPOTENT

Request body

Field	Type	Description
model	string	Required. Any model ID — e.g. mystic-2-5-flexible, imagen-4-ultra, flux-2-max
prompt	string	Required. Up to 4,000 characters.
count	int	Variations 1–8. Default: 4
aspect_ratio	string	1:1, 4:5, 2:3, 16:9, 21:9, 9:16
references[]	array	Up to 6 references with weights (0–1) and tags (style\|character\|palette\|composition\|pose)
negative_prompt	string	Things to avoid in the output.
seed	int	Reproducibility. Omit for random.
webhook	string	POST to this URL on completion.

curl -X POST https://api.modelbuffet.io/v1/images/generate \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mystic-2-5-flexible",
    "prompt": "a velvet-clad figure under a single spotlight, smoke curling, 35mm film grain",
    "aspect_ratio": "2:3",
    "count": 4,
    "references": [
      { "url": "https://modelbuffet.io/refs/abc.jpg", "tag": "style", "weight": 0.7 }
    ],
    "negative_prompt": "low quality, harsh shadows",
    "seed": 142857
  }'

200 OKResponse~7.4s typical

{
  "id": "gen_5fK3p2L8mN",
  "status": "completed",
  "model": "mystic-2-5-flexible",
  "credits_used": 32,
  "duration_ms": 7421,
  "outputs": [
    {
      "url": "https://modelbuffet.io/o/gen_5fK3p2L8mN/0.png",
      "width": 1024,
      "height": 1536,
      "seed": 142857
    }
    /* ... 3 more */
  ]
}

Official SDKs

Node.js

npm i @modelbuffet/sdk

Python

npm i @modelbuffet/sdk

PHP

npm i @modelbuffet/sdk

Ruby

npm i @modelbuffet/sdk

Swift

npm i @modelbuffet/sdk

Webhooks

For long-running jobs (videos, training, large batches), webhook delivery is the recommended pattern. Each delivery is signed with HMAC-SHA256.

luxe-signature: t=1714521600,v1=a8b2...

Field

Type

Description

model

string

Required. Any model ID — e.g. mystic-2-5-flexible, imagen-4-ultra, flux-2-max

prompt

string

Required. Up to 4,000 characters.

count

int

Variations 1–8. Default: 4

aspect_ratio

string

1:1, 4:5, 2:3, 16:9, 21:9, 9:16

references[]

array

Up to 6 references with weights (0–1) and tags (style|character|palette|composition|pose)

negative_prompt

string

Things to avoid in the output.

seed

int

Reproducibility. Omit for random.

webhook

string

POST to this URL on completion.

curl -X POST https://api.modelbuffet.io/v1/images/generate \ -H "Authorization: Bearer sk_live_..." \ -H "Content-Type: application/json" \ -d '{ "model": "mystic-2-5-flexible", "prompt": "a velvet-clad figure under a single spotlight, smoke curling, 35mm film grain", "aspect_ratio": "2:3", "count": 4, "references": [ { "url": "https://modelbuffet.io/refs/abc.jpg", "tag": "style", "weight": 0.7 } ], "negative_prompt": "low quality, harsh shadows", "seed": 142857 }'

{ "id": "gen_5fK3p2L8mN", "status": "completed", "model": "mystic-2-5-flexible", "credits_used": 32, "duration_ms": 7421, "outputs": [ { "url": "https://modelbuffet.io/o/gen_5fK3p2L8mN/0.png", "width": 1024, "height": 1536, "seed": 142857 } /* ... 3 more */ ] }