Getting Started
Authentication, versioning, errors, rate limits, idempotency, and billing.
REST APIapi.sogni.ai
Images, video, music, and agent workflows, in your stack and behind your interface. Make something we wouldn't have thought of.
Your first call One request. The model picks up Sogni's creative tools and returns an image URL.
curl https://api.sogni.ai/v1/chat/completions \
-H "Authorization: Bearer $SOGNI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"messages": [
{ "role": "user", "content": "Generate a cinematic image of a neon alley in Tokyo during rain." }
]
}'
The Supernet runs on GPU capacity contributed by independent operators, including people running hardware at home. People-powered compute, for people with their own ideas.
New here? Start with authentication and conventions.
Already building? Pick your next move below. Every endpoint shows its full
versioned path; you'll see /v1, /v2, and /v4 resources here.
Before you hit send. Public reads and account operations have different access rules. Check authentication before you call, keep API keys on your server, and give polling requests room to breathe.
Make something. Check on it. See what's available. Every endpoint in the reference, grouped by what you're trying to do.
Authentication, versioning, errors, rate limits, idempotency, and billing.
Single-step image, video, image-to-video, and music workflows.
Owner-authenticated project status, pending and terminal states, polling, and 24-hour failed/canceled retention.
Background removal, object selection, multi-view 3D reconstruction, video upscaling, speech and voice cloning, and audio-driven or two-stage MiniMax H3 video.
Import LoRA files into your account library, check import status, and use ready adapters in compatible renders.
OpenAI-compatible chat, tool execution, and streaming responses.
Execute synchronous creative tools with explicit arguments.
Discover the OpenAI-compatible chat model listing.
Create, inspect, stream, cancel, and confirm costs for durable chat runs.
Create and manage persisted multi-step creative workflows.
/v1/creative-agent/workflows/v1/creative-agent/workflows/v1/creative-agent/workflows/:id/v1/creative-agent/workflows/:id/events/v1/creative-agent/workflows/:id/events/stream/v1/creative-agent/workflows/:id/resume/v1/creative-agent/workflows/:id/confirm-cost/v1/creative-agent/workflows/:id/cancel/v1/creative-agent/workflows/:id/reseedCreate, list, update, delete, and fork reusable workflow templates.
Ingest and retrieve replay records for integration debugging.
Request signed upload and download URLs for reference assets and results, and manage reusable saved uploads.
Public blockchain wallet balances, network RPC endpoints, and token contract addresses.
Private generation-account balances, subscription status, usage, and worker earnings.
Public aggregate worker activity, bounded historical charts, and batched NFT analytics.
/v1/analytics/day/v1/analytics/lifetime/v1/analytics/day/nft/:nftTokenId/v1/analytics/lifetime/nft/:nftTokenId/v1/analytics/day/nfts/v1/analytics/chart/daily/events/query/v1/analytics/chart/daily/model-use/query/v1/analytics/model-use/lifetime/v1/model-renders/user-statsPublic generation model catalogs, live worker supply and demand, and worker releases.
SDKs, client libraries, and related integration guides.
Existing bookmarks still work. Each section now has a focused reference page.