Generation

Settle a generation offer and create (or resume) the generation

Checks the offer's invoice for settlement and creates the generation once — the same mode/prompt/aspect_ratio/references as the offer are validated again here and are what actually generate. Poll this at ~2.5 s until the invoice settles (202 while unpaid), then keep calling it to follow the job: running → done (with the image) or policy_rejected (payment retained, no refund). A failed job is re-driven on the SAME payment by the next call (redriven: true) — one payment delivers at most one image. Account-bound: an expired macaroon still resumes this account's paid claim; another account's is refused. Not gated by IMAGE_GEN_ENABLED for money purposes — with generation off and the invoice PAID, the payment is recorded and the claim stays open (503 GENERATION_UNAVAILABLE, claim_open: true). Rate limited 60/min/user. Every answer is private, no-store.

post/v1/images/generate/redeem

Request

  • Base URL: https://api.memestack.ai
  • URL: https://api.memestack.ai/v1/images/generate/redeem
  • Auth: HTTP bearer

Request body

mode'standard' | 'quality' | 'edit' required
promptstring required
aspect_ratio'1:1' | '3:4' | '16:9' required
ref_image_idsstring[]
ref_upload_idsstring[]
macaroonstring required

The macaroon from the /v1/images/generate 402.

Response

The bound generation's current state. done carries the image summary; policy_rejected closes the claim with the payment retained; failed (rare) reports a delivered-then-failed row without re-driving; running with redriven: true means this call re-dispatched a failed job.

image_idstring uuid
status'done' | 'policy_rejected' | 'failed' | 'running'
redrivenboolean

Changes

No recorded changes to this operation across all 1 revision of this API.