{"uid":"cap_wX-NOXsUd5Z-WvKauHBoy","slug":"fal-ai-job-status-check-via-locus-x402-66555ffa","name":"fal.ai Job Status Check via Locus x402","description":"Locus public pay-per-use API","url":"https://fal.x402.paywithlocus.com/fal/status","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"model":{"type":"string"},"request_id":{"type":"string"},"status_url":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{},"payment":{"scheme":"exact","settledUsdc":"0.001000","authorizedMaxUsdc":"0.001000"},"request":{"id":"00000000-0000-4000-8000-000000000000","statusUrl":"/requests/00000000-0000-4000-8000-000000000000"},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_86xVFoOQ7XsvVRuwRSijD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Polls the status of an asynchronous fal.ai generative AI job using a request ID or status URL, returning the result when ready.","exampleAgentPrompt":"Check whether my fal.ai generation job has finished — the request ID is '3f2a1b00-0000-4000-8000-abc123456789' and the model was 'fal-ai/flux/dev'.","exampleUseCases":[{"title":"Poll async image generation result","prompt":"I submitted a fal.ai image generation job a moment ago with request ID 'a1b2c3d4-0000-4000-8000-111122223333' using model 'fal-ai/flux/schnell' — can you check if it's done and grab the result?"},{"title":"Retrieve queued video generation output","prompt":"My fal.ai video generation is still processing — the status URL is 'https://queue.fal.run/requests/99887766-0000-4000-8000-aabbccddeeff'. Can you poll it and let me know when the video is ready?"},{"title":"Monitor audio synthesis job completion","prompt":"I kicked off an audio generation job on fal.ai with model 'fal-ai/stable-audio' and request ID 'deadbeef-0000-4000-8000-cafebabe0000' — please keep checking until it finishes and return the output."}],"resultDescription":"Returns a JSON object containing a 'data' field with the generated output from the fal.ai model (e.g. image URLs, video URLs, audio files), a 'success' boolean, request metadata including the request ID and status URL, and payment settlement details showing how much USDC was charged and authorized.","failureModes":["Missing both status_url and request_id+model pair returns a validation error","Invalid or expired request_id returns an error or empty result","Job still in progress returns a pending/queued status rather than final output — agent must retry","Payment settlement failure may prevent result delivery","Network timeout if the status endpoint is temporarily unavailable"],"whenToPreferThis":"Use this endpoint after calling the fal.ai generate endpoint to retrieve the result of an asynchronous job. This is specifically for polling async fal.ai requests routed through the Locus x402 payment layer — choose it when you have a request_id and model, or a queue.fal.run status_url from a prior generate call, and need to retrieve the completed output with micropayment settlement via USDC.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:34:37.801Z","isFirstParty":false}