Back to Maximus Media House — AI Agent API
Card snapshot
agent.maximusmediahouse.com
·
2026-11-04 04:00:29 UTC
·
afd9afe28fb225ae8b6ebf26258b2e5d505861ae44bce51a5f2651f60babe7fc
This is a frozen copy of the agent's agent-card.json as we observed it at the timestamp above. We capture a new snapshot every time the card's content hash changes. Useful for: forensic drift analysis, verifying downstream callers see the right version, reproducing routing decisions made historically.
{
"protocolVersion": "0.2.5",
"name": "Maximus Media House \u2014 AI Agent API",
"description": "Paid AI generation over x402 v2 / USDC on Base: image generation (flux3-klein premium, flux-2-klein-4b fast), flat per-call chat (qwen3.5), reference-conditioned image edit, and Hunyuan 480p image-to-video (PREPAID-only, buy balance at POST /v1/subscription). Pay-per-call, no accounts, no API keys.",
"url": "https://agent.maximusmediahouse.com",
"version": "1.0.0",
"provider": {
"organization": "Maximus Media House",
"url": "https://agent.maximusmediahouse.com",
"contact": "maximusmediahouse@agentmail.to"
},
"documentationUrl": "https://agent.maximusmediahouse.com/openapi.json",
"capabilities": {
"streaming": false,
"pushNotifications": false
},
"defaultInputModes": [
"application/json"
],
"defaultOutputModes": [
"application/json"
],
"securitySchemes": {
"x402": {
"type": "http",
"scheme": "x402",
"description": "x402 v2 payment over USDC on Base (CAIP-2 eip155:8453, scheme 'exact'). The 402 body and the PAYMENT-REQUIRED header carry accepts[] with the exact price and payTo; the PAYMENT-SIGNATURE header carries the client PaymentPayload (the legacy X-402-Authorization tx-hash header is also accepted)."
}
},
"security": [
{
"x402": []
}
],
"skills": [
{
"id": "flux-2-klein-4b",
"name": "flux-2-klein-4b",
"description": "FLUX.2 klein 4B fp8 text-to-image \u2014 fast, cheap prototype/iteration renders (~6s warm). RE-VERIFIED 2026-10-30: the shipped recipe renders coherent, correctly-composed images.",
"tags": [
"x402",
"paid",
"usdc",
"base",
"halo:8002"
],
"status": "available",
"status_reason": "RE-VERIFIED 2026-10-30: the shipped recipe renders COHERENT images \u2014 a live 512x512 render at the current recipe produced a clean, correctly-composed red apple on a wooden table (the 2026-10-28 'pure noise / >=2-word phrases garble' reading predates the recipe fix and no longer applies). Gate is OPEN, price unchanged.",
"inputSchema": {
"type": "object",
"properties": {
"model": {
"type": "string",
"enum": [
"flux3-klein",
"flux-2-klein-4b"
],
"description": "flux3-klein ($0.03, premium house-quality) or flux-2-klein-4b ($0.01, fast/cheap)."
},
"prompt": {
"type": "string",
"minLength": 1,
"maxLength": 1200,
"description": "Text prompt describing the image to generate."
},
"n": {
"type": "integer",
"minimum": 1,
"maximum": 4,
"default": 1,
"description": "Number of images (server caps at 4)."
},
"size": {
"type": "string",
"enum": [
"1024x1024",
"768x768",
"512x512"
],
"default": "1024x1024"
},
"seed": {
"type": "integer",
"minimum": 0,
"maximum": 4294967295,
"description": "Optional deterministic seed."
},
"response_format": {
"type": "string",
"enum": [
"b64_json",
"url"
],
"default": "b64_json"
},
"refs": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 4,
"description": "Optional reference image URLs (SSRF-guarded)."
}
},
"required": [
"model",
"prompt"
]
},
"outputSchema": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"object": {
"type": "string"
},
"created": {
"type": "integer"
},
"model": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"images": {
"type": "integer"
}
}
},
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"b64_json": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"sha256": {
"type": "string"
},
"durable_url": {
"type": "string",
"format": "uri"
},
"seed": {
"type": "integer"
},
"size_resolved": {
"type": "string"
}
}
}
}
},
"required": [
"id",
"object",
"data"
]
},
"examples": [
"a candid photo of a silver robot trophy on a podium",
{
"model": "flux3-klein",
"prompt": "a red fox in a snowy pine forest, golden hour, photoreal",
"n": 1,
"size": "1024x1024",
"response_format": "b64_json"
}
],
"error": [
{
"code": "payment_required",
"http": 402,
"type": "payment",
"billed": false,
"message": "No payment proof was presented; the body carries accepts[] and the bazaar extension."
},
{
"code": "payment_failed",
"http": 402,
"type": "payment",
"billed": false,
"message": "A payment proof was presented but rejected (price, replay, structure or facilitator)."
},
{
"code": "replayed_payment",
"http": 402,
"type": "payment",
"billed": false,
"message": "This payment was already consumed; each authorization is one-time-use."
},
{
"code": "settle_not_enabled",
"http": 402,
"type": "payment",
"billed": false,
"message": "A standard PAYMENT-SIGNATURE arrived but the facilitator settle path is not enabled on this deployment."
},
{
"code": "invalid_request_body",
"http": 422,
"type": "request",
"billed": false,
"message": "The body failed JSON-Schema validation; detail lists the field errors."
},
{
"code": "unknown_model",
"http": 410,
"type": "request",
"billed": false,
"message": "model is not in the served price card."
},
{
"code": "prompt_rejected",
"http": 400,
"type": "request",
"billed": false,
"message": "The prompt was blocked by the content gate."
},
{
"code": "route_unavailable",
"http": 503,
"type": "availability",
"billed": false,
"message": "The route is withdrawn and is refused before any payment gate."
},
{
"code": "render_declined_gpu_memory",
"http": 503,
"type": "availability",
"billed": false,
"message": "Refused before taking payment (GPU memory gate); the tx is left unconsumed."
},
{
"code": "generation_failed",
"http": 502,
"type": "server",
"billed": false,
"message": "The render died; the tx is released and the call is not billed."
},
{
"code": "not_found",
"http": 404,
"type": "request",
"billed": false,
"message": "No such route."
}
],
"idempotency": {
"header": "Idempotency-Key",
"enforced": true,
"window_s": 86400,
"scope": "one logical request = method + path + payment-auth header + body",
"on_replay": "the ORIGINAL response is returned unchanged with header `Idempotency-Replayed: true`; the call is never billed twice",
"second_guard": "independent of the header, a spent payment is consumed once, durably, keyed on the settled tx hash / the EIP-3009 authorization nonce the facilitator enforces",
"expiry": "entries older than window_s are ignored and the call runs fresh"
},
"rate_limit": {
"enforced": false,
"statement": "none enforced",
"note": "No per-wallet or per-IP rate limit is applied. GPU renders are serialized by a single-GPU lane; GET /v1/images/queue and GET /v1/videos/queue expose the live wait rather than a quota."
},
"retry": [
{
"on": "503 render_declined_gpu_memory",
"retry": true,
"backs_off": true,
"strategy": "exponential",
"idempotent": true,
"billed": false,
"note": "Not billed and not consumed; retry after the wait the queue endpoint reports."
},
{
"on": "502 generation_failed",
"retry": true,
"backs_off": true,
"strategy": "exponential",
"idempotent": true,
"billed": false,
"note": "The tx is released; a retry is safe and will not double-charge."
},
{
"on": "503 route_unavailable",
"retry": false,
"billed": false,
"note": "Product withdrawn; do not retry until the manifest marks it available."
},
{
"on": "402 payment_required",
"retry": false,
"billed": false,
"note": "Present a valid x402 payment (PAYMENT-SIGNATURE or the legacy x-402-authorization header)."
},
{
"on": "422 invalid_request_body",
"retry": false,
"billed": false,
"note": "Fix the body against the published request JSON Schema first."
}
],
"availability": {
"target": "best-effort; no contractual SLA is published",
"check": "https://agent.maximusmediahouse.com/status",
"queue_checks": [
"https://agent.maximusmediahouse.com/v1/images/queue",
"https://agent.maximusmediahouse.com/v1/videos/queue"
],
"note": "Per-route `status`/`status_reason` appear on every manifest resource."
},
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
],
"endpoint": "https://agent.maximusmediahouse.com/v1/images/generations",
"price": {
"amount_micro_usdc": 10000,
"price_usdc": "0.01",
"price_label": "$0.01 per image",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"network": "eip155:8453",
"payTo": "0x8cb59b1bffb39c130ab85a8177e93eae9ddbaf10",
"scheme": "exact"
}
},
{
"id": "qwen3.5",
"name": "qwen3.5",
"description": "Qwen3.5 chat \u2014 private structured inference, OpenAI-compatible chat/completions. Billed FLAT PER CALL ($0.003), not per token, since 2026-10-28.",
"tags": [
"x402",
"paid",
"usdc",
"base",
"local:8080"
],
"status": "available",
"status_reason": null,
"inputSchema": {
"type": "object",
"properties": {
"model": {
"type": "string",
"enum": [
"qwen3.5"
]
},
"messages": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"properties": {
"role": {
"type": "string",
"enum": [
"system",
"user",
"assistant"
]
},
"content": {
"type": "string"
}
},
"required": [
"role",
"content"
]
}
},
"temperature": {
"type": "number",
"minimum": 0,
"maximum": 2,
"default": 0.7
},
"max_tokens": {
"type": "integer",
"minimum": 1,
"default": 1024,
"description": "Output cap. Chat is billed FLAT $0.003/call, not per token."
},
"stream": {
"type": "boolean",
"default": false
}
},
"required": [
"model",
"messages"
]
},
"outputSchema": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"object": {
"type": "string"
},
"created": {
"type": "integer"
},
"model": {
"type": "string"
},
"choices": {
"type": "array",
"items": {
"type": "object",
"properties": {
"index": {
"type": "integer"
},
"message": {
"type": "object",
"properties": {
"role": {
"type": "string"
},
"content": {
"type": "string"
}
}
},
"finish_reason": {
"type": "string"
}
}
}
},
"usage": {
"type": "object",
"properties": {
"prompt_tokens": {
"type": "integer"
},
"completion_tokens": {
"type": "integer"
},
"total_tokens": {
"type": "integer"
}
}
}
},
"required": [
"id",
"object",
"choices"
]
},
"examples": [
"Summarize this document in three bullets.",
{
"model": "qwen3.5",
"messages": [
{
"role": "user",
"content": "Explain x402 in one sentence."
}
],
"temperature": 0.7,
"max_tokens": 256
}
],
"error": [
{
"code": "payment_required",
"http": 402,
"type": "payment",
"billed": false,
"message": "No payment proof was presented; the body carries accepts[] and the bazaar extension."
},
{
"code": "payment_failed",
"http": 402,
"type": "payment",
"billed": false,
"message": "A payment proof was presented but rejected (price, replay, structure or facilitator)."
},
{
"code": "replayed_payment",
"http": 402,
"type": "payment",
"billed": false,
"message": "This payment was already consumed; each authorization is one-time-use."
},
{
"code": "settle_not_enabled",
"http": 402,
"type": "payment",
"billed": false,
"message": "A standard PAYMENT-SIGNATURE arrived but the facilitator settle path is not enabled on this deployment."
},
{
"code": "invalid_request_body",
"http": 422,
"type": "request",
"billed": false,
"message": "The body failed JSON-Schema validation; detail lists the field errors."
},
{
"code": "unknown_model",
"http": 410,
"type": "request",
"billed": false,
"message": "model is not in the served price card."
},
{
"code": "prompt_rejected",
"http": 400,
"type": "request",
"billed": false,
"message": "The prompt was blocked by the content gate."
},
{
"code": "route_unavailable",
"http": 503,
"type": "availability",
"billed": false,
"message": "The route is withdrawn and is refused before any payment gate."
},
{
"code": "render_declined_gpu_memory",
"http": 503,
"type": "availability",
"billed": false,
"message": "Refused before taking payment (GPU memory gate); the tx is left unconsumed."
},
{
"code": "generation_failed",
"http": 502,
"type": "server",
"billed": false,
"message": "The render died; the tx is released and the call is not billed."
},
{
"code": "not_found",
"http": 404,
"type": "request",
"billed": false,
"message": "No such route."
}
],
"idempotency": {
"header": "Idempotency-Key",
"enforced": true,
"window_s": 86400,
"scope": "one logical request = method + path + payment-auth header + body",
"on_replay": "the ORIGINAL response is returned unchanged with header `Idempotency-Replayed: true`; the call is never billed twice",
"second_guard": "independent of the header, a spent payment is consumed once, durably, keyed on the settled tx hash / the EIP-3009 authorization nonce the facilitator enforces",
"expiry": "entries older than window_s are ignored and the call runs fresh"
},
"rate_limit": {
"enforced": false,
"statement": "none enforced",
"note": "No per-wallet or per-IP rate limit is applied. GPU renders are serialized by a single-GPU lane; GET /v1/images/queue and GET /v1/videos/queue expose the live wait rather than a quota."
},
"retry": [
{
"on": "503 render_declined_gpu_memory",
"retry": true,
"backs_off": true,
"strategy": "exponential",
"idempotent": true,
"billed": false,
"note": "Not billed and not consumed; retry after the wait the queue endpoint reports."
},
{
"on": "502 generation_failed",
"retry": true,
"backs_off": true,
"strategy": "exponential",
"idempotent": true,
"billed": false,
"note": "The tx is released; a retry is safe and will not double-charge."
},
{
"on": "503 route_unavailable",
"retry": false,
"billed": false,
"note": "Product withdrawn; do not retry until the manifest marks it available."
},
{
"on": "402 payment_required",
"retry": false,
"billed": false,
"note": "Present a valid x402 payment (PAYMENT-SIGNATURE or the legacy x-402-authorization header)."
},
{
"on": "422 invalid_request_body",
"retry": false,
"billed": false,
"note": "Fix the body against the published request JSON Schema first."
}
],
"availability": {
"target": "best-effort; no contractual SLA is published",
"check": "https://agent.maximusmediahouse.com/status",
"queue_checks": [
"https://agent.maximusmediahouse.com/v1/images/queue",
"https://agent.maximusmediahouse.com/v1/videos/queue"
],
"note": "Per-route `status`/`status_reason` appear on every manifest resource."
},
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
],
"endpoint": "https://agent.maximusmediahouse.com/v1/chat/completions",
"price": {
"amount_micro_usdc": 3000,
"price_usdc": "0.003",
"price_label": "$0.003 per call",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"network": "eip155:8453",
"payTo": "0x8cb59b1bffb39c130ab85a8177e93eae9ddbaf10",
"scheme": "exact"
}
},
{
"id": "qwen-image-edit-2511",
"name": "qwen-image-edit-2511",
"description": "Qwen-Image-Edit-2511 \u2014 reference-conditioned image edit. Send an image + an instruction and it edits THAT image while preserving identity/composition. 8-step, denoise 0.90, ~60-90s GPU warm. The true differentiator vs plain t2i.",
"tags": [
"x402",
"paid",
"usdc",
"base",
"halo:8002"
],
"status": "available",
"status_reason": "RE-VERIFIED 2026-10-30: the shipped recipe is denoise=0.90 / steps=8, the setting MEASURED on 2026-10-28 to apply the instruction cleanly (at the old denoise=0.6/steps=4 the edit was a no-op). Two blockers that made the product unusable for real callers are FIXED: the 256 KiB request-body cap that rejected EVERY base64 upload (now 20 MiB) and the GPU-memory decline (the gate now unloads idle ComfyUI lanes instead of refusing). Gate is OPEN, price unchanged.",
"inputSchema": {
"type": "object",
"properties": {
"model": {
"type": "string",
"enum": [
"qwen-image-edit-2511"
]
},
"prompt": {
"type": "string",
"minLength": 1,
"maxLength": 1200,
"description": "Instruction applied to the source image (identity/composition preserved)."
},
"image": {
"type": "string",
"description": "Source image as base64 PNG/JPEG (no data: prefix)."
},
"image_url": {
"type": "string",
"format": "uri",
"description": "Public https URL of the source image (SSRF-guarded). Send exactly one of image / image_url."
},
"size": {
"type": "string",
"enum": [
"1024x1024",
"768x768",
"512x512"
],
"default": "1024x1024"
},
"seed": {
"type": "integer",
"minimum": 0,
"maximum": 4294967295
},
"response_format": {
"type": "string",
"enum": [
"b64_json",
"url"
],
"default": "b64_json"
}
},
"required": [
"model",
"prompt"
]
},
"outputSchema": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"object": {
"type": "string"
},
"created": {
"type": "integer"
},
"model": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"images": {
"type": "integer"
}
}
},
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"b64_json": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"sha256": {
"type": "string"
},
"durable_url": {
"type": "string",
"format": "uri"
},
"seed": {
"type": "integer"
},
"size_resolved": {
"type": "string"
}
}
}
}
},
"required": [
"id",
"object",
"data"
]
},
"examples": [
"Remove the background and add a soft studio backdrop.",
{
"model": "qwen-image-edit-2511",
"prompt": "change the jacket to bright red, keep the face and pose",
"image": "<base64 PNG or JPEG bytes>",
"size": "1024x1024"
}
],
"error": [
{
"code": "payment_required",
"http": 402,
"type": "payment",
"billed": false,
"message": "No payment proof was presented; the body carries accepts[] and the bazaar extension."
},
{
"code": "payment_failed",
"http": 402,
"type": "payment",
"billed": false,
"message": "A payment proof was presented but rejected (price, replay, structure or facilitator)."
},
{
"code": "replayed_payment",
"http": 402,
"type": "payment",
"billed": false,
"message": "This payment was already consumed; each authorization is one-time-use."
},
{
"code": "settle_not_enabled",
"http": 402,
"type": "payment",
"billed": false,
"message": "A standard PAYMENT-SIGNATURE arrived but the facilitator settle path is not enabled on this deployment."
},
{
"code": "invalid_request_body",
"http": 422,
"type": "request",
"billed": false,
"message": "The body failed JSON-Schema validation; detail lists the field errors."
},
{
"code": "unknown_model",
"http": 410,
"type": "request",
"billed": false,
"message": "model is not in the served price card."
},
{
"code": "prompt_rejected",
"http": 400,
"type": "request",
"billed": false,
"message": "The prompt was blocked by the content gate."
},
{
"code": "route_unavailable",
"http": 503,
"type": "availability",
"billed": false,
"message": "The route is withdrawn and is refused before any payment gate."
},
{
"code": "render_declined_gpu_memory",
"http": 503,
"type": "availability",
"billed": false,
"message": "Refused before taking payment (GPU memory gate); the tx is left unconsumed."
},
{
"code": "generation_failed",
"http": 502,
"type": "server",
"billed": false,
"message": "The render died; the tx is released and the call is not billed."
},
{
"code": "not_found",
"http": 404,
"type": "request",
"billed": false,
"message": "No such route."
}
],
"idempotency": {
"header": "Idempotency-Key",
"enforced": true,
"window_s": 86400,
"scope": "one logical request = method + path + payment-auth header + body",
"on_replay": "the ORIGINAL response is returned unchanged with header `Idempotency-Replayed: true`; the call is never billed twice",
"second_guard": "independent of the header, a spent payment is consumed once, durably, keyed on the settled tx hash / the EIP-3009 authorization nonce the facilitator enforces",
"expiry": "entries older than window_s are ignored and the call runs fresh"
},
"rate_limit": {
"enforced": false,
"statement": "none enforced",
"note": "No per-wallet or per-IP rate limit is applied. GPU renders are serialized by a single-GPU lane; GET /v1/images/queue and GET /v1/videos/queue expose the live wait rather than a quota."
},
"retry": [
{
"on": "503 render_declined_gpu_memory",
"retry": true,
"backs_off": true,
"strategy": "exponential",
"idempotent": true,
"billed": false,
"note": "Not billed and not consumed; retry after the wait the queue endpoint reports."
},
{
"on": "502 generation_failed",
"retry": true,
"backs_off": true,
"strategy": "exponential",
"idempotent": true,
"billed": false,
"note": "The tx is released; a retry is safe and will not double-charge."
},
{
"on": "503 route_unavailable",
"retry": false,
"billed": false,
"note": "Product withdrawn; do not retry until the manifest marks it available."
},
{
"on": "402 payment_required",
"retry": false,
"billed": false,
"note": "Present a valid x402 payment (PAYMENT-SIGNATURE or the legacy x-402-authorization header)."
},
{
"on": "422 invalid_request_body",
"retry": false,
"billed": false,
"note": "Fix the body against the published request JSON Schema first."
}
],
"availability": {
"target": "best-effort; no contractual SLA is published",
"check": "https://agent.maximusmediahouse.com/status",
"queue_checks": [
"https://agent.maximusmediahouse.com/v1/images/queue",
"https://agent.maximusmediahouse.com/v1/videos/queue"
],
"note": "Per-route `status`/`status_reason` appear on every manifest resource."
},
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
],
"endpoint": "https://agent.maximusmediahouse.com/v1/images/edits",
"price": {
"amount_micro_usdc": 20000,
"price_usdc": "0.02",
"price_label": "$0.02 per edit",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"network": "eip155:8453",
"payTo": "0x8cb59b1bffb39c130ab85a8177e93eae9ddbaf10",
"scheme": "exact"
}
},
{
"id": "flux3-klein",
"name": "flux3-klein",
"description": "FLUX.3 klein text-to-image \u2014 premium, house-quality renders on Halo :8002 (ComfyUI v0.41.1, flux3 clip type). Single-pass t2i, 1024px. The premium counterpart to the fast $0.01 klein lane.",
"tags": [
"x402",
"paid",
"usdc",
"base",
"halo:8002"
],
"status": "available",
"status_reason": "RE-VERIFIED 2026-10-30: :8002 runs ComfyUI v0.41.1 (exposes the 'flux3' clip type) and TWO independent live renders (seeds 7 and 42) at 512x512 produced distinct, coherent, correctly-composed images, visually confirmed by the owner. Gate is OPEN, price unchanged. The GPU-memory decline that previously returned 503 is fixed: the gate now unloads idle ComfyUI lanes (measured 31.6GB -> 70.9GB free) instead of refusing the render.",
"inputSchema": {
"type": "object",
"properties": {
"model": {
"type": "string",
"enum": [
"flux3-klein",
"flux-2-klein-4b"
],
"description": "flux3-klein ($0.03, premium house-quality) or flux-2-klein-4b ($0.01, fast/cheap)."
},
"prompt": {
"type": "string",
"minLength": 1,
"maxLength": 1200,
"description": "Text prompt describing the image to generate."
},
"n": {
"type": "integer",
"minimum": 1,
"maximum": 4,
"default": 1,
"description": "Number of images (server caps at 4)."
},
"size": {
"type": "string",
"enum": [
"1024x1024",
"768x768",
"512x512"
],
"default": "1024x1024"
},
"seed": {
"type": "integer",
"minimum": 0,
"maximum": 4294967295,
"description": "Optional deterministic seed."
},
"response_format": {
"type": "string",
"enum": [
"b64_json",
"url"
],
"default": "b64_json"
},
"refs": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 4,
"description": "Optional reference image URLs (SSRF-guarded)."
}
},
"required": [
"model",
"prompt"
]
},
"outputSchema": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"object": {
"type": "string"
},
"created": {
"type": "integer"
},
"model": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"images": {
"type": "integer"
}
}
},
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"b64_json": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"sha256": {
"type": "string"
},
"durable_url": {
"type": "string",
"format": "uri"
},
"seed": {
"type": "integer"
},
"size_resolved": {
"type": "string"
}
}
}
}
},
"required": [
"id",
"object",
"data"
]
},
"examples": [
"a candid photo of a silver robot trophy on a podium",
{
"model": "flux3-klein",
"prompt": "a red fox in a snowy pine forest, golden hour, photoreal",
"n": 1,
"size": "1024x1024",
"response_format": "b64_json"
}
],
"error": [
{
"code": "payment_required",
"http": 402,
"type": "payment",
"billed": false,
"message": "No payment proof was presented; the body carries accepts[] and the bazaar extension."
},
{
"code": "payment_failed",
"http": 402,
"type": "payment",
"billed": false,
"message": "A payment proof was presented but rejected (price, replay, structure or facilitator)."
},
{
"code": "replayed_payment",
"http": 402,
"type": "payment",
"billed": false,
"message": "This payment was already consumed; each authorization is one-time-use."
},
{
"code": "settle_not_enabled",
"http": 402,
"type": "payment",
"billed": false,
"message": "A standard PAYMENT-SIGNATURE arrived but the facilitator settle path is not enabled on this deployment."
},
{
"code": "invalid_request_body",
"http": 422,
"type": "request",
"billed": false,
"message": "The body failed JSON-Schema validation; detail lists the field errors."
},
{
"code": "unknown_model",
"http": 410,
"type": "request",
"billed": false,
"message": "model is not in the served price card."
},
{
"code": "prompt_rejected",
"http": 400,
"type": "request",
"billed": false,
"message": "The prompt was blocked by the content gate."
},
{
"code": "route_unavailable",
"http": 503,
"type": "availability",
"billed": false,
"message": "The route is withdrawn and is refused before any payment gate."
},
{
"code": "render_declined_gpu_memory",
"http": 503,
"type": "availability",
"billed": false,
"message": "Refused before taking payment (GPU memory gate); the tx is left unconsumed."
},
{
"code": "generation_failed",
"http": 502,
"type": "server",
"billed": false,
"message": "The render died; the tx is released and the call is not billed."
},
{
"code": "not_found",
"http": 404,
"type": "request",
"billed": false,
"message": "No such route."
}
],
"idempotency": {
"header": "Idempotency-Key",
"enforced": true,
"window_s": 86400,
"scope": "one logical request = method + path + payment-auth header + body",
"on_replay": "the ORIGINAL response is returned unchanged with header `Idempotency-Replayed: true`; the call is never billed twice",
"second_guard": "independent of the header, a spent payment is consumed once, durably, keyed on the settled tx hash / the EIP-3009 authorization nonce the facilitator enforces",
"expiry": "entries older than window_s are ignored and the call runs fresh"
},
"rate_limit": {
"enforced": false,
"statement": "none enforced",
"note": "No per-wallet or per-IP rate limit is applied. GPU renders are serialized by a single-GPU lane; GET /v1/images/queue and GET /v1/videos/queue expose the live wait rather than a quota."
},
"retry": [
{
"on": "503 render_declined_gpu_memory",
"retry": true,
"backs_off": true,
"strategy": "exponential",
"idempotent": true,
"billed": false,
"note": "Not billed and not consumed; retry after the wait the queue endpoint reports."
},
{
"on": "502 generation_failed",
"retry": true,
"backs_off": true,
"strategy": "exponential",
"idempotent": true,
"billed": false,
"note": "The tx is released; a retry is safe and will not double-charge."
},
{
"on": "503 route_unavailable",
"retry": false,
"billed": false,
"note": "Product withdrawn; do not retry until the manifest marks it available."
},
{
"on": "402 payment_required",
"retry": false,
"billed": false,
"note": "Present a valid x402 payment (PAYMENT-SIGNATURE or the legacy x-402-authorization header)."
},
{
"on": "422 invalid_request_body",
"retry": false,
"billed": false,
"note": "Fix the body against the published request JSON Schema first."
}
],
"availability": {
"target": "best-effort; no contractual SLA is published",
"check": "https://agent.maximusmediahouse.com/status",
"queue_checks": [
"https://agent.maximusmediahouse.com/v1/images/queue",
"https://agent.maximusmediahouse.com/v1/videos/queue"
],
"note": "Per-route `status`/`status_reason` appear on every manifest resource."
},
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
],
"endpoint": "https://agent.maximusmediahouse.com/v1/images/generations",
"price": {
"amount_micro_usdc": 30000,
"price_usdc": "0.03",
"price_label": "$0.03 per image",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"network": "eip155:8453",
"payTo": "0x8cb59b1bffb39c130ab85a8177e93eae9ddbaf10",
"scheme": "exact"
}
}
],
"x402": {
"x402Version": 2,
"network": "eip155:8453",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"assetName": "USD Coin",
"payTo": "0x8cb59b1bffb39c130ab85a8177e93eae9ddbaf10",
"manifest": "https://agent.maximusmediahouse.com/.well-known/x402"
}
}