{"uid":"cap_4szbJ1ljTpr55cd61fCwK","slug":"fal-ai-model-1c63caa9","name":"fal.ai Namespaced Model Generation","description":"fal.ai model generation (with namespace)","url":"https://fal.mpp.tempo.xyz/fal-ai/:namespace/:model?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["namespace","model","prompt"],"properties":{"model":{"type":"string","description":"The specific model variant (e.g. 'schnell', 'dev')"},"prompt":{"type":"string","description":"Text prompt describing the desired output"},"namespace":{"type":"string","description":"The model family/namespace (e.g. 'flux'), NOT 'fal-ai' which is already in the URL path"},"image_size":{"enum":["landscape_4_3","landscape_16_9","portrait_4_3","portrait_16_9","square","square_hd"],"type":"string","description":"Optional image size preset (e.g. 'landscape_4_3', 'square_hd')"}}},"responseSchema":{"type":"object","required":["images","timings","seed","has_nsfw_concepts","prompt"],"properties":{"seed":{"type":"number"},"images":{"type":"array","items":{"type":"object","required":["url","width","height","content_type"],"properties":{"url":{"type":"string"},"width":{"type":"number"},"height":{"type":"number"},"content_type":{"type":"string"}}}},"prompt":{"type":"string"},"timings":{"type":"object","required":["inference"],"properties":{"inference":{"type":"number"}}},"has_nsfw_concepts":{"type":"array","items":{"type":"boolean"}}}},"example":{"request":{"model":"schnell","prompt":"a serene blue ocean with white sailboats at sunset","namespace":"flux","image_size":"landscape_4_3"},"response":{"seed":204056538,"images":[{"url":"https://v3b.fal.media/files/b/0a9c1b5f/mLlYAacS6AigwWk15m-ci.jpg","width":1024,"height":768,"content_type":"image/jpeg"}],"prompt":"a serene blue ocean with white sailboats at sunset","timings":{"inference":0.12852990000101272},"has_nsfw_concepts":[false]}},"exampleRequest":{"model":"schnell","prompt":"a serene blue ocean with white sailboats at sunset","namespace":"flux","image_size":"landscape_4_3"},"tags":["image","video","flux","stable-diffusion","grok","generation","ai","media"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.83","successRate":"0.00","reviews":1,"stars":"4.3","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nSEBNIiGRdfYHd94aHwK-","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"fal.ai","brandSlug":"fal-ai","brandBaseUrl":"https://fal.ai","brandDocsUrl":"https://fal.ai/docs","whatItDoes":"Runs any fal.ai model by namespace and model name, supporting image, video, and audio generation across 600+ models","exampleAgentPrompt":"Generate an image using fal.ai model fal-ai/flux/schnell — create a photorealistic sunset over the ocean with dramatic clouds and golden light.","exampleUseCases":null,"resultDescription":"Returns the model's output, typically including URLs to generated media (images, video, audio) and associated metadata such as dimensions, format, seed, and generation parameters, structured according to the specific model's output schema.","failureModes":["Invalid namespace or model name returns 404","Unsupported input parameters for the chosen model return 400","Model is temporarily unavailable or rate-limited returns 503","Malformed request body returns 422","Insufficient USDC balance causes payment failure","Model output generation timeout for complex long-running models"],"whenToPreferThis":"Use this endpoint when you need to call a specific fal.ai model by its full namespace and model slug that isn't exposed as a dedicated named endpoint, or when you want flexible access to any of fal.ai's 600+ models including community models, fine-tunes, or less common variants. Prefer the specific named endpoints (e.g. FLUX.1 Dev, Recraft V3) when available for better-documented schemas; use this generic namespaced endpoint for everything else.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":3,"lastUsedAt":"2026-06-25T21:56:37.128Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:41:58.618Z","isFirstParty":false,"canonicalSlug":"fal-ai-model-1c63caa9"}