{"uid":"cap_adUzq6c8xjDqglJJoWuUV","slug":"imgnai-katana-image-generation-api-cd5112ab","name":"imgnAI Katana Image Generation API","description":"Pay-per-call AI gateway: Frontier/SOTA LLM, Image, and Video models - and proprietary low-cost imgnAI models. Includes GPT 5.5, Opus 4.8, GPT Image 2, Nano Banana 2, Seedance 2.0, Happy Horse, and Google Omni. Fully compatible with OpenAPI, HermesOS, and OpenClaw.","url":"https://kat.imgnai.com/v1/generation-requests","method":"POST","headers":{},"bodySchema":{"type":"object","required":["requests"],"properties":{"requests":{"type":"array"}}},"responseSchema":{"type":"object"},"example":{"request":{"requests":[{"model":"katana-v1","width":512,"height":512,"prompt":"A futuristic neon-lit cyberpunk cityscape at night with rain-soaked streets","num_images":1}],"client_request_id":"test-qa-001"},"response":{"status":"failed","metadata":{"network":"none","paid_usdc":"0","settlement":"none","paid_amount":"0","transaction":"none","billing_source":"x402_prepaid_exact"},"requests":[{"type":"unknown"}],"responses":[{"type":"unknown","error":{"code":"invalid_type","field":"requests[0].type","message":"type must be image or video.","retryable":false},"job_id":"74a5ad3b-78aa-4994-a105-d1d75cbd0b46","status":"rejected","metadata":{"model":"","billing_source":"x402_prepaid_exact"}}],"created_at":"2026-06-16T17:42:53.618338+00:00","request_id":"b981a7f4-050c-414c-8af0-c1a3809bff2a","updated_at":"2026-06-16T17:42:53.623154+00:00","client_request_id":"test-qa-001","poll_after_seconds":null}},"exampleRequest":{"requests":[{"model":"katana-v1","width":512,"height":512,"prompt":"A futuristic neon-lit cyberpunk cityscape at night with rain-soaked streets","num_images":1}],"client_request_id":"test-qa-001"},"tags":["x402"],"displayCostAmount":"0.0156","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0156/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0156","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0156","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Xk5GY3q98g9xrLecvuTa_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0156","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Submits one or more AI image generation requests to the imgnAI Katana service and returns generated image responses","exampleAgentPrompt":"Generate an image of a futuristic neon-lit cyberpunk cityscape at night with rain-soaked streets using imgnAI Katana — submit it as a single generation request.","exampleUseCases":null,"resultDescription":"Returns a JSON object containing a status string, a request_id for tracking, and a responses array with the generated image data or references for each submitted generation request.","failureModes":["Invalid or empty requests array returns 400 error","Missing required fields in generation request objects causes validation failure","Payment failure via x402 protocol results in 402 Payment Required","Rate limiting or quota exceeded returns 429 error","Malformed client_request_id causes request rejection","Unsupported model or generation parameters return 422 error"],"whenToPreferThis":"Choose this endpoint when you need to generate AI images specifically through imgnAI's Katana platform, especially in agentic workflows that support x402 micropayment protocol. Ideal when you want to submit one or multiple image generation requests in a single call with optional client-side request tracking via client_request_id.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:36:56.407Z","isFirstParty":false}