Sora 2 Pro video generation via micropayments — text-to-video and image-to-video, $1.20–$6.00 per generation.
What it does
This endpoint generates videos using OpenAI's Sora 2 Pro model through StableStudio's pay-per-generation platform. It accepts a text prompt and optional reference image, producing videos at durations of 4, 8, or 12 seconds in resolutions up to 1792×1024. Payment is handled via MPP (Tempo method, pathUSD) or x402 (USDC on Base) — no API keys or subscriptions required.
The generation flow is asynchronous: POST to `/api/generate/sora-2-pro/generate` with a signed payment header to receive a `jobId`, then poll `GET /api/jobs/{jobId}` with a SIGN-IN-WITH-X wallet signature until the job completes (typically 2–5 minutes). Completed jobs return a `videoUrl` and `thumbnailUrl`. Sora 2 Pro offers extra resolution options (1792×1024 and 1024×1792) compared to the standard Sora 2 endpoint. Pricing is dynamic, ranging from $1.20 to $6.00 depending on duration and resolution selected.
StableStudio is part of a broader multi-model platform that also exposes Nano Banana Pro, GPT Image 1.5, Flux 2 Pro, Grok, Seedance, Wan 2.6, and Veo 3.1 endpoints. Image-to-video requires a prior file upload via the `/api/upload` flow ($0.01). The full OpenAPI spec is available at `/api/openapi.json`. An MCP server is available via `npx -y agentcash@latest`.
Capabilities
Use cases
- —Generate short-form video clips from text descriptions for social media or marketing
- —Animate a reference image into a video using image-to-video mode
- —Produce high-resolution (1792×1024) cinematic video content from prompts
- —Create portrait-orientation videos (1024×1792) for mobile-first platforms
- —Prototype video concepts quickly without subscription commitments
Fit
Best for
- —Agents or apps needing on-demand, pay-per-call video generation without API keys
- —High-resolution Sora 2 Pro video output (up to 1792×1024) not available on the standard Sora 2 tier
- —Crypto-native workflows settling in USDC on Base or pathUSD on Tempo
Not for
- —Real-time or low-latency video needs (generation takes 2–5 minutes)
- —Budget-sensitive bulk generation (at $1.20–$6.00 per clip, costs add up quickly)
- —Users without a crypto wallet (payment requires on-chain signing)
Quick start
# 1. POST without payment to get 402 challenge
curl -X POST https://stablestudio.dev/api/generate/sora-2-pro/generate \
-H 'Content-Type: application/json' \
-d '{"prompt": "A golden retriever running on a beach at sunset", "seconds": "4", "size": "1280x720"}'
# Returns 402 with PAYMENT-REQUIRED header (base64 JSON)
# 2. Sign USDC payment, re-POST with PAYMENT-SIGNATURE header
# 3. Poll GET /api/jobs/{jobId} with SIGN-IN-WITH-X headerExample
Request
{
"size": "1792x1024",
"prompt": "A golden retriever running on a beach at sunset, cinematic lighting",
"seconds": "8",
"autoCrop": true
}Response
{
"type": "sora-2-pro",
"jobId": "abc123-def456",
"status": "pending",
"success": true
}Endpoint
Quality
Full OpenAPI schema with detailed input/output definitions, clear pricing, comprehensive guidance docs, and agents.txt present. The endpoint returned 405 on HEAD/GET probes (expected — it's POST-only), so liveness is inferred from the well-formed OpenAPI and platform context rather than a direct 402 capture. Docs pages return 404 but the OpenAPI x-guidance field compensates with thorough documentation.
Warnings
- —Probe returned 405 on HEAD/GET because the endpoint only accepts POST; liveness not directly confirmed via 402 challenge
- —No dedicated docs page found (/docs returns 404); documentation is embedded in the OpenAPI x-guidance field
- —Generation takes 2–5 minutes; callers must implement async job polling
Citations
- —Sora 2 Pro costs $1.20–$6.00 per generation and takes 2–5 minuteshttps://stablestudio.dev
- —Sora 2 Pro supports sizes 1280x720, 720x1280, 1792x1024, 1024x1792 and durations 4/8/12 secondshttps://stablestudio.dev
- —Payment settles via USDC on Base (x402) or pathUSD on Tempo (MPP)https://stablestudio.dev
- —agents.txt lists sora-2-pro at $3.00-12.50https://stablestudio.dev
- —MCP server available via npx -y agentcash@latesthttps://stablestudio.dev